Archify教學手冊

Archify 教學手冊 一句話定位:Archify 是一個給 AI Coding Agent 使用的 Agent Skill,讓 Agent 把「Repository 證據 / 架構描述」轉譯成一份經過 Schema 驗證、可互動探索、可分享的自包含 HTML 系統地圖——重點不是畫一張漂亮的圖,而是產出一份可驗證、可追溯來源的架構視圖。 官方 Repository:https://github.com/tt-a1i/archify(MIT License) 查證版本:2.15.0(最新正式版)/2.16.0-dev.0(開發中版本,CHANGELOG.md 的 [Unreleased] 區塊;與 archify/package.json 的 "version": "2.16.0-dev.0"、archify/SKILL.md frontmatter 的 metadata.version: "2.16" 三方一致) 查證日期:2026-08-28(同日完成第二輪深度複查,新增 ROADMAP.md、archify/schemas/README.md 兩份官方一手來源,並修正前一版三處判斷落差,詳見「改版與修正紀錄」) 適用對象:Software Architect、Solution Architect、Technical Lead、Backend/Frontend/Full Stack Developer、DevOps/DevSecOps Engineer、SRE、QA、System/Business Analyst、PM、AI Coding Agent Developer、AI Engineer、Legacy System 維運與 Framework Upgrade 團隊 目的:讓企業開發團隊知道「何時該用、怎麼用、怎麼驗證、怎麼治理」Archify,並將其嵌入 AI Agent 驅動的 Web Application 開發、Legacy System Reverse Engineering、Framework Upgrade、Architecture Review、Code Review、SSDLC 工作流程 技術堆疊:Node.js(engines.node >= 18)+ 零相依 CLI(archify/bin/archify.mjs)+ 5 份 JSON Schema(開發期由 ajv draft 2020-12 預先編譯為 standalone validator,執行期不需 npm install 或網路)+ 5 個 typed Renderer + 自包含 HTML/SVG Viewer(4 種 Visual Preset、深/淺色主題);供 Cursor、Claude Code、Codex CLI、opencode、Raven、Claude.ai、DeepSeek Harness 等 AI Agent 環境使用 重要聲明(請務必先讀) 範圍與翻譯聲明:本手冊以繁體中文撰寫,技術名詞(Agent Skill、Typed JSON IR、Reverse Engineering、Architecture Delta、Repository、Schema、Validation、Renderer、Viewer 等)保留英文原文,以避免翻譯造成語意漂移。所有官方文件原文引用皆標明出處。 核心定位聲明:Archify 不是「一個 Mermaid 轉 HTML 的小工具」。它的核心價值在於讓 AI Agent 產生的架構圖,經過型別化(typed)JSON IR 與 Schema 決定性驗證(deterministic validation) 這兩層把關,避免 AI 把「想像的拓撲」當成事實輸出成一張看起來很專業、實際上與程式碼不符的圖。本手冊會反覆強調這個定位。 查證方法論:本手冊所有與 Archify 官方功能相關的敘述,皆透過直接抓取官方 Repository 原始檔案(raw.githubusercontent.com,包含 README.md、CHANGELOG.md、package.json、archify/SKILL.md、archify/bin/archify.mjs、archify/delta/architecture-delta.mjs 等)並交叉比對而來,而非僅憑單一頁面摘要。凡是「僅有單一來源」或「多來源有落差」的內容,一律用 §符號約定 的 Provenance 標籤明確標示,不會偽裝成確定事實。 版本落差澄清:查證過程中發現兩處尚未解決的來源落差——(a) v2.15.0 的正式發布日期,官方 CHANGELOG.md 原文寫 2026-08-17,另一個第三方摘要頁面寫 2025-08-17,兩者差一年,本手冊採用 CHANGELOG 原始檔案文字但同時標注此落差;(b) GitHub Star 數,兩個獨立來源收斂在「約 25k」,但另一第三方聚合站回報「13k」,本手冊僅標示「約 25k(未完全確認)」,不作為技術判斷依據。第二輪複查已解決前一版的三處落差(Cursor 支援層級、Typed JSON IR 的官方地位、JPEG/WebP 匯出格式),詳見「改版與修正紀錄」。 虛構案例免責聲明:第 Part VII、Part XIII 中的「企業案例」「銀行系統案例」為教學示範用途之情境案例,其中的系統名稱、公司背景、數據均為虛構,僅用來示範 Archify 的使用方法,並非真實客戶專案。 License 免責聲明:Archify 採用 MIT License,本手冊之引用僅供教學說明,實際採用前請自行確認官方 Repository 當下的 LICENSE 檔案與版本條款。 完整參考來源請見「References」章節,內含所有直接查證用的官方 URL。 時效性聲明:Archify 目前處於高頻迭代狀態(CHANGELOG.md 顯示 2.11 至 2.16-dev 之間平均約 1~2 週一個 minor 版本)。本手冊標示 🟢 的內容為 2026-08-28 當下的官方事實,企業若要將本手冊轉為內部正式規範,建議設定每季複查一次的機制(見第 29 章維護章節)。 改版與修正紀錄 本手冊採「可稽核更新」原則:每一次改版都必須列出修正了什麼、為什麼修正、依據哪一份一手來源,而不是默默覆寫舊內容。 ...

August 28, 2026 · 65 min · 13802 words · Eric Cheng

Diagram Design教學手冊

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 本身。 ...

August 28, 2026 · 48 min · 10049 words · Eric Cheng

Awesome Copilot教學手冊

awesome-copilot 教學手冊 企業標準技術白皮書:以 awesome-copilot 與 GitHub Copilot 客製化機制建立可治理的 AI Agent 開發平台 版本:v5.0(2026-11-03,全面重組版) 查證基準:github/awesome-copilot commit 8178d19(2026-11-03)、Copilot CLI 1.0.105、VS Code 1.144(Stable,2026-10-28)、docs.github.com 與 code.visualstudio.com 2026-11-03 版本、GitHub Changelog 至 2026-10-28 Repository:github.com/github/awesome-copilot(GitHub 官方 org、MIT License、約 40.7k stars/5.3k forks,內容為社群貢獻) 官方網站:awesome-copilot.github.com(含 Learning Hub 與 llms.txt) 適用對象:資深軟體工程師、Tech Lead、軟體架構師、AI 平台工程師、DevSecOps 與資安審查人員、IT 管理者 技術情境範例:Vue 3 + TypeScript + Tailwind CSS + PrimeVue(前端)、Java 25 + Spring Boot 4.x + Maven(後端)、PostgreSQL/Oracle/Db2(資料庫) 重要聲明(請務必先讀) 本手冊不是官方文件的翻譯。 內容依 github/awesome-copilot Repository(README.md、CONTRIBUTING.md、AGENTS.md、eng/ 自動化腳本、各資源資料夾)與 docs.github.com、code.visualstudio.com 的官方文件逐頁查證後,以繁體中文重新組織,並補上企業導入所需的範例、反例、驗證方法與審查清單。 awesome-copilot 是社群內容。 Repository 位於 GitHub 官方 org,但 README 明載「這些客製化來自第三方開發者,安裝前請檢查」。本手冊嚴格區分: GitHub Copilot 官方規格:一律以 docs.github.com、code.visualstudio.com 為準。 awesome-copilot 收錄的社群資源:僅供參考,安裝前必須依第 21 章審查。 所有企業範例都經過實測。 第 4~13 章與第 20 章的範例檔(instructions、skills、agents、hooks、MCP 設定、plugin、marketplace、managed settings)放在同一個範例 repository 中,以上游 eng/validate-plugins.mjs、eng/validate-skills.mjs、Agent Plugins schema、Copilot CLI 唯讀指令,以及本手冊附錄 A.4 的檢查器實際驗證;hook 腳本以 bash 與 PowerShell 7 實際執行。結果記錄於附錄 H.3。 本手冊不執行需要 AI 額度或會改動使用者設定的操作。 例如實際 copilot plugin install、cloud agent 任務等,只以官方文件查證並標示「未實測」,列入附錄 H.4。 企業案例為教學用原創設計。 範例中的 acme-* 資源、acme-corp 組織與內部網址均為虛構,不代表任何真實專案。 授權:awesome-copilot 採 MIT License,請以官方 LICENSE 原文為準;本手冊不構成法律意見。 v5.0 改版重點 v5.0 依使用者決策全面重組章節:由 v4 的 41 章扁平結構改為 6 個 Part、26 章與附錄 A~H,舊版錨點不再沿用。內容上的重大更正如下(完整清單見附錄 H.2): ...

August 27, 2026 · 111 min · 23477 words · Eric Cheng

Ai Memory教學手冊

ai-memory 教學手冊 ai-memory —— AI Coding Agent 跨 Session、跨 Agent 長期記憶系統企業導入完整指南 Version:v1.33.0(依 Cargo.toml 的 [workspace.package] version 查證,2026-08-28 查證時之最新版本;v1.33.0 於 2026-08-28 發布) Research Date:2026-08-26(初版)/2026-08-28(第二次全文複查與版本更新) 適用對象:Software Developer、Tech Lead、Software Architect、AI Architect、DevSecOps 工程師 目的:協助企業軟體開發團隊建立「AI Coding Agent Long-Term Memory + Cross-Agent Handoff + Project Knowledge Continuity」 Repository:github.com/akitaonrails/ai-memory(MIT License) 技術堆疊:Rust 2024 edition(最低 1.95)、rmcp(MCP transport)、axum(HTTP)、SQLite + FTS5、Git ⚠️ 重要聲明(請務必先讀) 本手冊是彙整、重組、補充企業導入實務,而不是官方文件的翻譯。 內容依官方 Repository(README.md、docs/*.md、AGENTS.md、CLAUDE.md、CHANGELOG.md、Cargo.toml、hooks/、docker/、packaging/、crates/)逐檔查證後,以繁體中文重新組織、延伸為企業教材,並大量補充 Scenario、AI Prompt 範例、比較表、Checklist 與企業導入建議。 ai-memory 不是一般的「Memory Database」,而是透過 MCP(Model Context Protocol)讓不同 AI Coding Agent(Claude Code、OpenAI Codex、GitHub Copilot 等)存取共同的、Git 版控的長期記憶系統。 本手冊會不斷強調這個核心觀念:Markdown Wiki 是唯一的 Source of Truth,SQLite/FTS5/Embedding 都只是為了加速檢索而衍生出來的索引層,而非相反。 ...

August 26, 2026 · 59 min · 12446 words · Eric Cheng

GitHub Copilot 逆向工程教學手冊

GitHub Copilot 逆向工程教學手冊(Java Web) 版本:4.0 最後更新:2026-10-23(查證基準日 2026-10-22) 適用對象:資深工程師、架構師、技術主管、QA 與資安審查人員 技術棧:Java 25 LTS(新專案建議)/21 LTS(既有系統延續)|Spring Boot 4.1.x(現行建議,最新 patch 4.1.2)/4.0.x(維護至 2026-12-31;3.x 已於 2026-06-30 EOL)|VS Code 1.143(2026-10-21,Copilot harness 成為預設)+ GitHub Copilot(Agent/Plan/Cloud Agent/CLI 1.0.x/MCP/Agent Plugins 1.0/本機沙箱) 本版重點:① 全面對齊 VS Code 1.143 的 Copilot harness(Agent Host)——它不載入 prompt files、不套用 handoffs,hook 改用 "version": 1 的 Copilot 格式;② 更正 v3.0 的 9 類設定錯誤(虛構的 Cloud Agent 設定檔與 MCP 套件、Agent Plugins $schema、managed settings 三個鍵的格式、Content Exclusion 對 Agent 模式無效等);③ 所有程式碼範例都實際執行過:Java 25/Spring Boot 4.1.2 編譯與測試、SQL Server 2025 擷取 Golden Master、PostgreSQL 18 執行 Flyway、actionlint、hook 腳本、客製化檔案檢查器;④ 每章新增「審查與驗證清單」,並對照 ISO/IEC/IEEE 14764、ISO/IEC 42001、NIST AI RMF、OWASP LLM Top 10 2026 等國際標準。逐條佐證見 附錄 F。 ...

August 26, 2026 · 98 min · 20848 words · Eric Cheng

Humanlayer Skills 教學手冊

humanlayer/skills 教學手冊 humanlayer/skills —— HumanLayer 開源之 Claude Code Skills 企業導入完整指南 適用對象:資深 Software Architect、SA、Tech Lead、PM、SD/PG、DevOps、AI Engineer、Legacy Modernization Architect 文件性質:企業內部「humanlayer/skills」導入、開發與治理培訓教材,偏重實戰與維運 版本基準:humanlayer/skills(GitHub 官方 Repository,main 分支)+ docs.humanlayer.com 官方文件 查證日期:2026-08-24 技術堆疊:Claude Code、Node.js/npx(安裝工具鏈)、Git/GitHub、GitHub Actions(由 Skill 產生的下游範本) ⚠️ 重要聲明(請務必先讀) 本手冊是彙整、重組、補充企業導入實務,而不是官方文件的翻譯。 本書不逐字翻譯官方 README,而是依官方 Repository(README.md、.claude-plugin/marketplace.json、 plugins/*/skills/*/SKILL.md)與 docs.humanlayer.com 官方文件重新查證後,以繁體 中文重新組織、延伸為企業教材,並大量補充 Scenario、AI Prompt 範例、比較表、 Checklist 與企業導入建議。 humanlayer/skills 是一個以 GitHub Repository 形式散布的 Claude Code Skills 集合, 官方定位語句為「Claude Code skills from HumanLayer.」。 本手冊會不斷強調一個 核心觀念:Skill 不只是一段 Prompt,而是一個可被 AI Coding Agent 執行的工作能力與 工程流程封裝——包含觸發條件、指令腳本、參考範本、輸出格式與(部分 Skill)會 進一步產生 GitHub Actions workflow,讓 Agent 的執行流程可被重複觸發、可被治理、 可被審計。 ...

August 24, 2026 · 85 min · 17967 words · Eric Cheng

QM教學手冊

QM 教學手冊 QM —— Y Combinator Software 開源之 Multiplayer Agent Harness for Work 企業導入完整指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、DevOps/SRE、Cloud Architect、Cybersecurity Architect、AI Agent 平台團隊、Tech Lead、企業導入負責人 文件性質:企業內部「QM」導入、開發與維運培訓教材,偏重實戰與維運 版本基準:yc-software/qm(MIT License),研究基準為官方 GitHub main 分支,查證時(2026-08-21)約 14,000+ ★ / 1,600+ forks(會隨時間持續變動,數字僅供查證當下參考) 查證日期:2026-08-21 技術堆疊:Node.js(>=24.15.0)、TypeScript(type: module)、Fastify、PostgreSQL、Slack(Bolt)、Vite/Lit(Web UI)、MIT License ⚠️ 重要聲明(請務必先讀) QM 是一個 2026-07-29 才建立、目前仍高速迭代中的年輕開源專案。 查證時(2026-08-21)repository 尚有 101 則 open Issues、195 個 open PR,涵蓋 turn 結果記錄語意、cron 重試/退避、provider failover、admin 稽核日誌等尚在修正中的行為。任何 CLI 指令、環境變數、目錄結構、Security 行為,在正式導入前,務必以你實際安裝版本的官方 README.md/SECURITY.md/cli/README.md/docs/ 為準。 本手冊是彙整、重組、補充企業導入實務,而不是官方文件的翻譯。 本書不逐字翻譯官方 README,而是依官方 Repository(README、SECURITY.md、AGENTS.md、CLI 文件、部署文件、.env.example、package.json、原始碼目錄結構)與官方網站 qm.ycombinator.com 重新查證後,以繁體中文重新組織、延伸為企業教材,並大量補充 Scenario、AI Prompt 範例、比較表、Checklist 與企業導入建議。 ...

August 21, 2026 · 71 min · 15049 words · Eric Cheng

Everything Claude Code 教學手冊

Everything Claude Code (ECC) 教學手冊 企業標準技術白皮書 | 文件版本 v4.0(2026-11-02,全面重組改版)| 前一版 v3.1(2026-08-31) 文件資訊 項目 內容 對應 ECC 版本 v2.2.3(npm ecc-universal@2.2.3,Git tag v2.2.3,發行 2026-10-01);另以 main@b38be6a(2026-10-30)說明尚未發行的 [Unreleased] 變更 對應 Claude Code 版本 2.1.316(本手冊所有原生功能皆以此版官方文件 code.claude.com/docs 查證) AgentShield 版本 ecc-agentshield@1.6.0(npm latest) 查證日期 2026-11-02 適用對象 軟體工程師(初階~資深)、系統架構師、DevOps/SRE、AI 平台工程師、資安人員、技術主管(導入決策) 授權 ECC 為 MIT License;ECC Tools Pro/Enterprise 為選配的商業託管 GitHub App(見 24.6) 官方來源 GitHub https://github.com/affaan-m/ECC ∣ 網站 https://ecc.tools ∣ npm ecc-universal、ecc-agentshield ∣ Plugin 識別碼 ecc@ecc ∣ 繁體中文 README 社群快照(GitHub REST API,2026-11-02) 295,141 Stars ∣ 43,688 Forks ∣ open_issues_count 201(Issue 與 PR 合計) ∣ 最後推送 2026-11-02 ⚠️ 官方來源警示:ECC README 明確警告「只從官方管道安裝」——GitHub affaan-m/ECC、npm ecc-universal/ecc-agentshield、GitHub App ecc-tools、Plugin ecc@ecc、網站 ecc.tools。第三方轉傳與鏡像不受專案維護,可能含惡意程式(見 17.3 供應鏈風險)。 ...

August 21, 2026 · 104 min · 22083 words · Eric Cheng

Prime Agent教學手冊

Prime Agent 教學手冊(企業導入與實戰完整版) 版本:v0.7.4(2026 年 8 月 19 日發布;本手冊查證日期 2026 年 8 月 20 日) 適用對象:初學者、一般開發者、資深工程師、架構師、DevSecOps 工程師、PM/SA、AI Agent 導入負責人 技術棧示範:Java 25 / Spring Boot 4.x / Spring Framework 7.x / Maven 4.x / Vue 3 / TypeScript / Tailwind CSS / PrimeVue / Pinia / PostgreSQL / Oracle / DB2 / SQL Server / Redis / Kafka / MQ 授權:MIT License 開發/維護:Prime Intellect 專案性質:earendil-works/pi 的 Hard Fork(詳見第 1 章),npm 套件內部仍沿用 @earendil-works/pi-coding-agent 官方倉庫:github.com/PrimeIntellect-ai/prime-agent 文件用途:企業 AI Software Development/Agent Engineering 導入教材 文件作者:AI Software Architecture Team ...

August 20, 2026 · 65 min · 13767 words · Eric Cheng

Semantica 教學手冊

Semantica 教學手冊 Semantica —— AI Agent 的 Context Graph、Knowledge Graph 與 Decision Intelligence 基礎設施層完整導入指南 適用對象:資深 Software Architect、SA、Backend/Frontend Engineer、AI Agent 平台團隊、DevSecOps、Tech Lead、企業導入負責人 文件性質:企業內部「AI Agent Context / Knowledge Graph / Decision Intelligence / Provenance」基礎設施導入、開發與維運培訓教材 版本基準:semantica-agi/semantica(MIT License),研究基準為官方 GitHub main 分支與 docs.getsemantica.ai 最新穩定版 v0.6.5(2026-08-11),研究/查證日期:2026-08-20 技術堆疊:Python ≥3.8、pip、可選 Neo4j/FalkorDB/Apache AGE/AWS Neptune(LPG)、內嵌 Oxigraph/Blazegraph/Jena/RDF4J/Anzo(RDF)、FAISS/Qdrant/Weaviate/Milvus/Pinecone/PgVector(Vector)、MIT License ⚠️ 重要聲明(請務必先讀) Semantica 是一個真實存在、仍在快速迭代中的開源專案。 本手冊撰寫時已透過官方 GitHub Repository(github.com/semantica-agi/semantica)、官方文件站(docs.getsemantica.ai)與 PyPI(pypi.org/project/semantica)逐項查證,並非虛構專案。但 Semantica 平均每 3-6 週釋出一次 minor 版本(v0.4.0 → v0.6.5 僅約 4 個月),CLI 指令、Python API 簽章、設定鍵、目錄結構都可能隨版本演進調整。任何指令、程式碼、路徑在正式導入前,務必以官方最新 README.md、docs.getsemantica.ai、CHANGELOG/Release Notes 與你實際安裝的版本為準(例如執行 semantica --help、python -c "import semantica; print(semantica.__version__)" 逐一核對)。 ...

August 20, 2026 · 59 min · 12402 words · Eric Cheng