教學

Claude Code 企業級軟體開發教學手冊 Enterprise Claude Code AI Software Engineering Handbook 把 Claude Code 當成 企業級 AI 軟體工程平台（AI Software Engineering Platform） 導入 Web 應用開發、Legacy 逆向工程、Framework 升版、測試、Code Review、DevSecOps、CI/CD 與 AI 治理的完整實作手冊 文件資訊 項目 內容 文件版本 1.2 初版日期 2026-09-10 本版更新日期 2026-09-24（v1.2 變更摘要見 F.7；v1.1 見 F.6） 最後查證日期 2026-09-24（以官方文件索引 https://code.claude.com/docs/llms.txt 當日所列 197 頁為母體，累計逐頁覆核 141 頁，其中 v1.2 新增 62 頁、重新覆核 15 頁；官方 changelog 覆核至 v2.1.281（2026-09-23）；查證清單與未覆核項目見附錄 F） 官方文件站 https://code.claude.com/docs/en/overview 目標產品 Claude Code（Free / Pro / Max / Team / Enterprise 方案，以及 Claude Console API、Amazon Bedrock、Google Cloud’s Agent Platform、Microsoft Foundry、Claude Platform on AWS 等 Provider） 涵蓋介面（Surface） Terminal CLI、VS Code、JetBrains、Desktop App、Claude Code on the web（cloud session）、Claude Projects、Claude 行動 App、Slack、Chrome、GitHub Actions、GitLab CI/CD、Remote Control、Self-hosted Environments 涵蓋客製化機制 CLAUDE.md、AGENTS.md、.claude/rules/、Auto Memory、Skills、Subagents、Agent Teams、Dynamic Workflows、Hooks、MCP、Plugins、Plugin Evals、Output Styles、Agent SDK、Advisor Tool、Status Line／Keybindings 涵蓋治理機制 Managed Settings（managed-settings.json / MDM / Server-managed）、Permission Rules、Permission Modes、Auto Mode Classifier、Sandboxing、Sandbox Environments、Managed MCP（managedMcpServers）、Plugin Marketplace 限制、Corporate Launcher（processWrapper）、Deep Link 註冊控管（disableDeepLinkRegistration）、Fast Mode 組織啟用與 fastModePerSessionOptIn、Gateway 存取控管（gatewayInternalNetworks）、Claude Apps Gateway 政策與 Spend Limits、syncClaudeAiSkills／blockReadsOutsideWorkingDirectories、managed_settings_resolved 政策遙測、OpenTelemetry、Analytics、Zero Data Retention 範例技術棧 Vue 3.x + TypeScript + Tailwind CSS + PrimeVue + Pinia／Angular 20 + PrimeNG + NgRx（前端）；Java 25 + Spring Boot 4.x + Maven（後端）；PostgreSQL / Oracle / DB2 / SQL Server；JUnit 5 + Testcontainers + ArchUnit + GitHub Actions 適用對象 資深軟體工程師、Full Stack Developer、Software Architect、AI Architect、Enterprise Architect、SA、PM、BA、QA、DevOps / SRE、DevSecOps、Security、Tech Lead、Engineering Manager 文件定位 實戰與維運導向的企業標準技術白皮書；不是 Git 入門教材，不是 AI 概論，不是 官方文件翻譯 篇幅 8 部、56 章 + 8 個附錄（A–H）（v1.2 新增第 55、56 章與附錄 H，並於既有 14 章新增 50 餘個子節） 可信度標示制度（請務必先讀） Claude Code 在 2025–2026 年間的產品架構變動幅度極大：預設權限模式反轉、新機制 GA、舊機制下架，全部發生在 12 個月內。網路上（包含中文技術部落格、影片教學、AI 產生的文章）有大量內容已經過時，而且過時的部分往往正是企業最在意的權限、沙箱與治理設定。 ...

GitHub Copilot 企業級軟體開發教學手冊 Enterprise GitHub Copilot AI Software Engineering Handbook 把 GitHub Copilot 當成 企業級 AI 軟體工程平台（AI Software Engineering Platform） 導入 Web 應用開發、Legacy 逆向工程、Framework 升版、測試、Code Review、DevSecOps、CI/CD 與 AI 治理的完整實作手冊 文件資訊 項目 內容 文件版本 1.2 初版日期 2026-09-10 最後改版日期 2026-09-25（v1.2：補入 2026-09-10 至 09-24 官方變更，新增 Version Note 11、第 5.7.4、5.8、6.13、7.12.5、8.14、9.9、16.5、27.7、27.8、30.7、31.5、31.6、32.7、44.5 節與附錄 H；目錄擴充至四級子節）2026-09-10（v1.1：補入 2026 年 8–9 月官方變更，新增第 5.6–5.7、6.10–6.12、7.12、9.8、30.6、32.6 節與附錄 G） 最後查證日期 2026-09-25（v1.2：以原始 Markdown 逐頁重新比對 docs.github.com/en/copilot 與 docs.github.com/en/code-security，並逐則覆核 2026-09-08 至 2026-09-24 的 GitHub Changelog copilot 標籤，結果彙整於附錄 H）2026-09-10（v1.1：對照 docs.github.com/en/copilot 的 Get started / Concepts / How-tos / Reference / Tutorials 五大區塊，以及 code.visualstudio.com、GitHub Changelog 逐頁覆核；v1.1 另針對 2026-08-01 至 2026-09-09 的 GitHub Changelog copilot 標籤逐則覆核，結果彙整於附錄 G） 官方文件站 https://docs.github.com/en/copilot 目標產品 GitHub Copilot（Free / Student / Pro / Pro+ / Max / Business / Enterprise） 涵蓋介面 IDE（VS Code、Visual Studio、JetBrains、Eclipse、Xcode）、GitHub Copilot CLI、github.com、GitHub Mobile、GitHub Copilot app、Copilot cloud agent、Copilot SDK、Slack、Microsoft Teams、第三方 coding agents（Anthropic Claude／OpenAI Codex）、Agent apps 涵蓋客製化機制 Custom Instructions、Prompt Files、Custom Agents、Agent Skills、Hooks、MCP、Plugins、Memory、Copilot Spaces、Automations、GitHub Agentic Workflows 涵蓋治理機制 Enterprise / Organization Policies、AI Controls、Agent Management、Enterprise Managed Settings（managed-settings.json）、Content Exclusion、MCP Allowlist / Registry、Audit Log、OpenTelemetry、Global Model Policy、模型退役管理、Team Specialization、Agent 操作權限強制管控、新功能預設啟用政策（Default policy for new features）、Code Review 企業預設效力等級、Cloud agent 執行環境與防火牆 範例技術棧 Vue 3.x + TypeScript + Tailwind CSS + PrimeVue + Pinia／Angular + PrimeNG + NgRx（前端）；Java 25 + Spring Boot 4.x + Maven（後端）；PostgreSQL / Oracle / DB2 / SQL Server；JUnit 5 + ArchUnit + GitHub Actions 適用對象 資深軟體工程師、Full Stack Developer、Software Architect、AI Architect、Enterprise Architect、SA、PM、QA、DevOps / DevSecOps、Security、Tech Lead、Engineering Manager 文件定位 實戰與維運導向的企業標準技術白皮書；不是 Git 入門教材，不是 AI 概論，不是 官方文件翻譯 篇幅 8 部、51 章 + 8 個附錄（A–H） 可信度標示制度（請務必先讀） GitHub Copilot 在 2025–2026 年間的產品架構變動幅度極大：功能改名、機制日落、新機制 GA，全部發生在 12 個月內。網路上（包含中文技術部落格、影片教學、AI 產生的文章）有大量內容已經過時，而且過時的部分往往正是企業最在意的治理與安全設定。 ...

MarkItDown 教學手冊 Enterprise Document Ingestion & Normalization Handbook 把 Microsoft MarkItDown 當成 AI Agent 的文件正規化基礎元件，導入企業 Web 開發、Legacy System 逆向工程、Software Framework 升版、RAG Knowledge Base 與 DevSecOps 的完整實作手冊 文件資訊 項目 內容 文件版本 1.1 初版日期 2026-09-10 最後改版日期 2026-09-10（v1.1） 最後查證日期 2026-09-10（對照 PyPI JSON API、GitHub microsoft/markitdown main 分支原始碼與各 package README 逐項覆核） 目標 MarkItDown 版本 0.1.7（2026-07-29 發布於 PyPI，為目前最新穩定版；另有預發布 0.1.8b1，2026-09-04，不建議用於 Production） 官方 Repository https://github.com/microsoft/markitdown 官方 PyPI https://pypi.org/project/markitdown/ 授權 核心套件 MIT License；但 markitdown-ocr 會間接引入 AGPL-3.0 授權的 PyMuPDF，詳見第 10.2 節 Python 需求 >= 3.10（官方 metadata 明訂；建議搭配 virtual environment） 核心套件 markitdown 0.1.7（另有獨立套件 markitdown-ocr 0.1.0、markitdown-mcp 0.0.1a4 —— 停滯逾 16 個月，成熟度不同級，詳見第 1.2 節） 適用對象 軟體架構師、SA、SD、PG、PM、AI Engineer、AI Agent / Coding Agent 使用者、平台維運人員 文件定位 實戰與維運導向的企業導入手冊；非 Python 入門教材、非 AI 概論、非官方 README 翻譯 篇幅 8 部、50 章 + 4 個附錄（全書 446 個章節與小節，目錄均可直接跳轉） 可信度標示制度（請務必先讀） MarkItDown 從 2024 年底開源後迭代快速，且 官方文件散落在四個不同 package 的 README（markitdown、markitdown-mcp、markitdown-ocr、markitdown-sample-plugin），彼此之間存在描述不一致之處。網路上大量教學文章仍停留在 0.0.x 舊 API。 ...

OpenAI Codex 生態系教學手冊 Enterprise Codex Ecosystem Handbook 把 OpenAI Codex 當成一套 AI Software Engineering Platform 導入企業：從概念、架構、安裝、設定、開發、逆向工程、框架升版、測試、審查、CI/CD，一路到安全治理與組織導入的完整實作手冊。 文件資訊 項目 內容 文件版本 2.1（對照官方文件站逐章覆核與增補） 初版日期 2026-06-30（v1.0～v1.5） 前版日期 2026-09-09（v2.0，全新改寫） 本版日期 2026-09-09 最後查證日期 2026-09-09（對照 learn.chatgpt.com/docs 官方文件站與 llms.txt 文件索引逐頁覆核） 官方文件站 https://learn.chatgpt.com/docs 官方文件索引 https://learn.chatgpt.com/llms.txt（機器可讀的完整頁面地圖） 官方 Repository https://github.com/openai/codex（Apache-2.0） CLI 版本基準 穩定線 0.153.4（2026-09-04）；預覽線 0.154.0-alpha 開發中 當前推薦模型 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna、gpt-5.3-codex-spark（research preview） 已退場模型 gpt-5.4 / gpt-5.4-mini（2026-08-31 自 ChatGPT 登入退場；API key 不受影響）、gpt-5.2 / gpt-5.3-codex（已淘汰） 涵蓋介面 ChatGPT 桌面 App、Codex Web、Codex CLI、IDE Extension、Codex Cloud、Codex Remote、Browser Extension、Amazon Bedrock 通道 適用對象 資深工程師、Full Stack Developer、Software Architect、Tech Lead、AI Engineer、DevOps／DevSecOps、QA、Engineering Manager、Enterprise Architect 文件定位 實戰與維運導向的企業標準技術手冊；可直接作為團隊內部開發規範文件基底 篇幅 35 章 + 4 個附錄 這份手冊怎麼讀 這份手冊有 35 章，沒有人會從頭讀到尾。以下是四條建議路徑。 ...

Codex CLI 教學手冊 Enterprise Codex CLI Architecture & Engineering Handbook 把 Codex CLI 當成 AI Software Engineering Agent 導入 Web 開發、Legacy 逆向工程、Framework 升版、Testing、Code Review、DevSecOps 與 CI/CD 的完整實作手冊 文件資訊 項目 內容 文件版本 1.1 初版日期 2026-09-06 最後改版日期 2026-09-06 最後查證日期 2026-09-06（對照 OpenAI 官方文件站 learn.chatgpt.com/docs、GitHub Repository 與 Releases 全文覆核） 目標 Codex CLI 版本 0.153.4（2026-09-04 發布；Alpha 通道為 0.154.0-alpha.3） 官方 Repository https://github.com/openai/codex 授權 Apache-2.0 官方文件站 https://learn.chatgpt.com/docs（注意：developers.openai.com/codex/* 已 308 轉址至此） 支援作業系統 macOS、Linux、Windows（三者皆有原生 sandbox 實作） 推薦安裝方式 官方 install script（macOS/Linux 用 install.sh、Windows 用 install.ps1）；亦支援 npm 與 Homebrew 推薦登入方式 Sign in with ChatGPT（Plus / Pro / Business / Edu / Enterprise 方案） 當前模型線 Astra（gpt-6-astra）、5.6 Sol / Terra / Luna、5.3 Codex Spark；Legacy：5.5。5.4 與 5.4 Mini 已於 2026-08-31 退場 適用對象 資深工程師、Full Stack Developer、Software Architect、AI Engineer、DevOps / DevSecOps、QA、Tech Lead、Engineering Manager、Enterprise Architect 文件定位 實戰與維運導向的企業標準技術白皮書；非 Terminal 入門教材、非 AI 概論 篇幅 50 章、456 小節 + 附錄 v1.1 改版摘要（2026-09-06） 本次改版以「對照官方文件站與 Repository 逐章覆核」為原則，補齊下列 v1.0 未涵蓋或涵蓋不足的官方能力： ...

Pi Agent Harness 教學手冊 文件版本：1.1 研究日期：2026-09-06（v1.1 覆核日：2026-09-06） Pi 版本：v0.85.1（發布於 2026-09-05，npm @earendil-works/pi-coding-agent；已對照 npm registry latest dist-tag 覆核） Node.js 需求：>= 22.19.0（npm engines 欄位；另有 legacy-node20 dist-tag = v0.74.2 供 Node 20 環境使用） 授權：MIT　官方網站：pi.dev　官方 Repo：earendil-works/pi 文件狀態：Based on latest verified documentation（所有官方能力均對照 2026-09-06 當日之官方 Repo 與官方 docs 查證） 篇幅：51 章 / 430 個小節；官方 packages/coding-agent/docs/ 之 28 份文件全數對應（對照表見第 50.2 節） v1.1 修訂摘要（2026-09-06） 項目 內容 新增 第 11.4 節 Keybindings 自訂、第 11.5 節 自訂 Theme、第 15.9 節 終端機相容性／tmux／Fullscreen／Shell Aliases 補齊 第 11.3 節設定全表補入 UI 與顯示、終端能力、訊息傳遞與 Retry、遙測共 4 組（約 40 個官方設定鍵）；第 2.5 節新增 v0.84.0–v0.85.1 版本演進速覽 強化 第 43.12 節新增「終端與多工器」故障排除表；第 45.3 節升級檢查清單新增設定鍵與內建工具複查項；第 51.1 節新增終端相容性檢查 目錄 全新兩層目錄：51 章 + 430 小節，依主題歸為 11 個部，全部項目皆為可點擊錨點；新增「依角色的建議入口」導覽表 格式 修正 17 處巢狀 code fence 導致的渲染中斷（改用四反引號）；套用 markdownlint 修正 96 項；標題階層一致化。目前 markdownlint 為 0 issues 關於本手冊 這份手冊要回答的問題 本手冊不是 Pi 的 README 摘要，也不是「Pi 是什麼」的問答。它要回答的是一個工程管理層級的問題： ...

Omarchy 教學手冊 Omarchy + AI Agent Software Engineering Platform 從零建置一台可用於 Web Application 開發、Legacy 系統逆向工程與 Framework 升版的 AI Agent 軟體工程工作站 文件資訊 項目 內容 文件版本 2.0 初版日期 2026-09-05 最後查證日期 2026-09-05（對照官方 Manual、GitHub Releases、Omarchy News 全文複查） 目標 Omarchy 版本 4.0.2（Quattro，2026-08-31 發布） 目標架構 x86_64（另有 Apple Silicon 相關支援，見第 5 章） 驗證 Repository https://github.com/omacom/omarchy 驗證分支 quattro（目前的主要開發分支，非 master／main） 授權 MIT 適用對象 資深工程師、軟體架構師、Tech Lead、Java / Spring Boot 開發者、前端開發者、DevOps / DevSecOps、AI Agent 使用者、IT 管理層 文件定位 實戰與維運導向；非 Arch Linux 入門教材 主要研究來源 Omarchy 官方網站、Omarchy 官方 Manual、Omarchy GitHub Repository、Phoronix、Hyprland / Quickshell / mise 官方文件 主要參考來源 來源 URL 用途 Omarchy 官方網站 https://omarchy.org/ 版本、ISO、定位 Omarchy 官方 Manual https://omarchy.org/manual/ 本手冊的主要事實依據（共 51 章） Omarchy GitHub https://github.com/omacom/omarchy 原始碼、目錄結構、AGENTS.md Omarchy Plugins https://omarchyplugins.com/ 第三方 plugin 市集 Omarchy Security https://omarchy.org/security/ 安全基準 Omarchy News https://omarchy.org/news/ 版本與生態動態 Hyprland https://hypr.land/ Compositor 背景知識 Quickshell https://quickshell.org/ Shell 框架背景知識 mise https://mise.jdx.dev/ Runtime 版本管理 修訂紀錄 版本 日期 主要變更 2.0 2026-09-05 對照官方 Manual（51 章）、GitHub Releases、Omarchy News、Security 頁全文複查。新增：4.8 版本歷程與安全修補、5.5.4–5.5.5 LM Studio 與本地模型現實評估、7.9–7.11 內建 GUI／Reminders／Web Apps、11.9.1 omarchy commands --json、18.10 Agent 崩潰自動診斷、22.8 官方安全治理與漏洞回報、22.9 硬體認證（指紋／FIDO2）、34.6 Windows VM。改寫：1.6 生態與治理時間軸、附錄 C Q14、附錄 E 參考來源。結構：全文目錄改為「章＋節」兩層並補齊全部錨點連結（460 個項目、468 條內部連結，全數驗證可解析）。 1.0 2026-09-05 初版。以 Omarchy 4.0.2（Quattro）為基準，44 章 + 5 附錄。 ⚠️ 閱讀本手冊前必讀的三件事 1. 版本差異極大，請勿混用舊教學 Omarchy 4.0（代號 Quattro）於 2026-08-14 發布，把整個桌面 Shell 層重寫了。網路上絕大多數 Omarchy 教學（包含中文內容）寫的是 3.x 架構，其中的設定檔路徑、元件名稱、指令都已經不適用。 ...

Scientific Agent Skills 教學手冊 企業級 AI 軟體工程實戰手冊 — 從安裝、整合、治理到 Web Application 開發、Legacy 逆向工程與 Framework 升級 文件資訊 項目 內容 文件版本 2.0（2026-09-03 全面複驗與擴充；v1.0 同日發布） 研究日期 2026-09-03 適用對象 資深工程師、軟體架構師、Tech Lead、AI Agent 開發者、DevOps / DevSecOps、PM、IT 管理層 主要研究對象 K-Dense-AI/scientific-agent-skills Repository URL https://github.com/K-Dense-AI/scientific-agent-skills Repository 分支 main 驗證 Commit SHA 1e5eeffbdad3749125afe7ab48a39694e27f181c 最新 Release v2.66.0（發布於 2026-09-02T16:25:37Z） 套件版本 pyproject.toml / plugin.json 皆為 2.66.0 授權 Repository 整體為 MIT；個別 Skill 授權不同，需逐一檢視（見第 26 章） Skill 實際數量 163 個（以 GitHub API 對 skills/ 目錄實際計數，2026-09-03） Scientific Database 數量 78 個（database-lookup skill 收錄；官方行銷文案稱「100+」，差異說明見第 7 章） 學術出處 arXiv:2609.00065（2026-08-30 投稿）— 見第 2.8 節 Agent Skills Standard 狀態 開放標準，官方站 https://agentskills.io ；Anthropic 於 2025-12-18 開源，現由 Agentic AI Foundation（Linux Foundation 旗下） 治理 前身專案 K-Dense-AI/claude-scientific-skills（已更名） 本次（v2.0）複驗與擴充摘要 本版對 v1.0 逐章重新查證，以下為實際修正與新增的項目，供讀者判斷是否需要重讀： ...

+++ date = ‘2026-08-28T00:00:00+08:00’ draft = false title = ‘archify 教學手冊’ tags = [‘教學’, ‘AI開發’] categories = [‘教學’] +++ Archify 教學手冊 一句話定位：Archify 是一個給 AI Coding Agent 使用的 Agent Skill，讓 Agent 把「Repository 證據 / 架構描述」轉譯成一份經過 Schema 驗證、可互動探索、可分享的自包含 HTML 系統地圖——重點不是畫一張漂亮的圖，而是產出一份可驗證、可追溯來源的架構視圖。 ...

diagram-design 教學手冊 diagram-design —— 給 AI Coding Agent 使用的「編輯級圖表設計系統」企業導入完整指南 Version：2.6.7（依 .claude-plugin/plugin.json 查證，2026-08-28 查證時之最新版本；細節見下方「版本標示重要澄清」） Research Date：2026-08-28 適用對象：Software Developer、Tech Lead、Software Architect、AI Architect、Technical Writer、DevSecOps 工程師 目的：協助企業軟體開發團隊將 diagram-design 導入「AI Coding Agent 產出架構圖 / 流程圖 / 技術文件」的日常工作流程，取代品質參差的 AI 手畫 Mermaid 圖表 Repository：github.com/cathrynlavery/diagram-design（MIT License） 技術堆疊：Python 3.x（腳本／驗證工具）、Playwright + Chromium（PNG 匯出）、純 HTML + Inline SVG + CSS（產出格式，無前端框架、無建置流程） 重要聲明（請務必先讀） 本手冊是彙整、重組、補充企業導入實務，而不是官方文件的翻譯。 內容依官方 Repository（README.md、skills/diagram-design/SKILL.md、skills/diagram-design/references/*.md 全部 39 個 type-*.md 索引與其中多篇全文、style-guide.md、onboarding.md、docs/adr/*.md、.claude-plugin/plugin.json、.github/workflows/ci.yml、完整檔案樹）逐檔查證後，以繁體中文重新組織、延伸為企業教材，並大量補充 Scenario、AI Prompt 範例、比較表與 Checklist。 diagram-design 不是「畫圖工具」，而是給 AI Coding Agent 使用的「圖表設計系統」（Diagram Design System）。 它的核心產出不是「畫出一張圖」，而是「用一致的設計語言、版面規則、色彩紀律，把 AI 對架構的理解轉譯成可直接發佈的 HTML + SVG 文件」。本手冊會不斷強調這個核心觀念：Skill 提供的是規則與知識（Layout Rule、Complexity Budget、Design Token），實際畫圖的仍是 AI Agent 本身。 ...