Modern Web Guidance 教學手冊

Modern Web Guidance 教學手冊 Modern Web Guidance AI Agent 現代化 Web 開發實戰教學手冊 建立 AI Coding Agent 的現代 Web Platform 知識、瀏覽器最佳實踐、相容性治理與企業級開發能力 適用對象:Frontend/Full-Stack Engineer、SA、Software Architect、QA、PM、AI Agent Engineer、DevSecOps 文件性質:企業內部開發規範與教育訓練教材(偏「實戰與維運」) 版本基準:npm modern-web-guidance 1.0.1(2026-11-16 發布;發行 repo GoogleChrome/modern-web-guidance tag v1.0.1 = commit 64a6d70);原始碼 repo GoogleChrome/modern-web-guidance-src 追蹤至 main e8feb43(2026-11-18) 實測環境:Windows 11、Node.js 24.16.0、npm 11.13.0、Git Bash、Google Chrome 158、Claude Code 2.1.328、web-features 3.46.0、Vue 3.5.45、Vite 8.3.8、Playwright 1.65.1 查證日期:2026-11-19 重要聲明 Modern Web Guidance 不是 AI Coding Agent,也不是 MCP Server。 它是一組 Agent Skill(SKILL.md+指南 Markdown)加上一支本機 CLI(search/retrieve/list/legacy-scan)。Agent 讀到 Skill 說明後,自己呼叫 CLI 把指南拉進 context。官方技術文章明確說明「為什麼是 CLI skill 而不是 MCP server」(第 3.6 節)。 它只提供知識,不會替你寫程式、改程式或做架構還原。 逆向工程、Framework 升級、測試與 Code Review 仍要靠 Agent、工具與人。本手冊會把每一項能力標示成「官方功能」或「企業自建/建議流程」,請勿混用。 CLI 預設開啟遙測。 會送出 Agent 名稱、guide ID、Agent 產生的搜尋詞到 Google(play.googleapis.com),不含原始 prompt 與程式碼。金融業環境請先讀第 4.9 節,統一設定 DISABLE_TELEMETRY=1。 版本變動很快。 1.0.0(2026-11-10)到 1.0.1(2026-11-16)只隔 6 天,Skill 預設以 npx -y modern-web-guidance@latest 執行,等於每次都抓最新版。本手冊所有輸出都以 1.0.1 為準;升級前請照第 17 章重新驗證。 本手冊不是官方文件的翻譯。 內容是依 npm 套件、發行 repo、原始碼 repo(src/cli、src/rag、src/core、src/analyzing)與 developer.chrome.com 官方文件重新查證,再加上企業導入做法、實測工具與案例。 案例皆為教學用虛構情境。 「貸款入口網站」「貸款案件管理」「ACME Bank」等名稱與資料都不是真實專案。 實測範圍要先看清楚。 已實測:CLI 全部指令(含未寫在 README 的 set-baseline)、.mwgrc 閘門 7 種情境、legacy-scan 3 個樣本專案、install 在隔離目錄安裝到 Claude Code、8 支企業自建工具(20 個測試、8 個突變測試全部被抓到、本機 CI 模擬 2 情境、搜尋回歸 13 案例)、Vue 3 範例(vue-tsc、vite build、Playwright 11 個 E2E 含 fallback 路徑與 axe)。未實測:各 Agent 實際載入 Skill 後的行為(未以付費帳號跑 Agent)、Copilot/Codex/Cursor/Gemini/Antigravity 的 plugin 安裝、GitHub Actions 實跑、Safari 與 Firefox 實機。未實測的內容標 🧪。 AI 產出一律要人工驗證。 官方評測數據(第 1.14 節)是 Google 在自家測試應用上量到的,不代表你的專案會得到同樣結果。 閱讀約定 來源標示 全書在句末或表格中使用下列標示。凡標示為「企業自建」或「建議流程」的內容都不是 Modern Web Guidance 官方功能,請勿在簡報或對外文件中寫成官方保證。 ...

November 19, 2026 · 137 min · 28974 words · Eric Cheng

Elephant Goldfish Model 教學手冊

elephant-goldfish-model 教學手冊 Elephant-Goldfish Model(EGM)企業級 AI 軟體開發方法論與外掛工具導入手冊 Design with an Elephant. Review with a Goldfish. 適用對象:PM、SA、SD、Architect、Frontend/Backend Engineer、PG、QA、DevOps/DevSecOps 文件性質:企業內部開發規範與教育訓練教材(偏「實戰與維運」) 版本基準:google/elephant-goldfish-model v0.1.1(2026-11-06,tag commit dea7761);main 追蹤至 72d06f5(2026-11-15,tag 之後 45 個 commit) 實測環境:Windows 11、Claude Code 2.1.325(已登入,headless claude -p 實跑 4 支 Skill)、Git Bash、Python 3.12、JDK 21、Maven 3.9.9 查證日期:2026-11-17 重要聲明 EGM 仍是 pre-1.0 專案。 官方 docs/releases.md 寫明 1.0 之前 minor 版本可能包含不相容的流程變更,「Version 1.0 requires a stable contract for skill names, parameters, output paths, and report formats」。本手冊所有指令、檔名、報告格式都以 v0.1.1 為準,升級前請重讀第 11 章的升級 SOP。 EGM 不是 Google 官方支援產品。 README 最後一句:「This is not an officially supported Google product.」企業導入時,支援責任在公司內部,不在 Google。 本手冊不是官方文件的翻譯。 內容是依 repo 原始檔(skills/*/SKILL.md、agents/*.md、resources/、docs/)重新查證後整理,並加上企業導入建議、實測工具與案例。 案例皆為教學用虛構情境。 「企業客戶管理系統」「貸款核准」「ACME Bank」等名稱與資料都不是真實專案。 實測範圍要先看清楚。 已實測:Claude Code 2.1.325 的 marketplace 安裝、plugin list/validate/details、claude doctor 設定驗證;1.1 起在已登入的 session 以 claude -p --plugin-dir 實跑 egm-review、egm-resolve、egm-bootstrap、egm-drift-report(3.13.1、5.3.5、5.4.6、5.7.4、5.8.4);5 支公司自建工具(25 個 pytest+突變測試)、ArchUnit Lab(含 surefire 3.5.3 回歸重現)、CI workflow 的本機模擬 6 情境。未實測:egm-brainstorm、egm-draft、egm-review-loop 與互動關卡、Codex CLI 與 Antigravity 全部操作、GitHub Actions 實跑。第 5 章與第 15 章標示「範例」的對話與報告是依 Skill 規則撰寫的示範;標示「實跑紀錄」的才是實際輸出。 AI 產出一律要人工驗證。 這也是 EGM 本身的立場:「Humans own the outcomes.」(docs/index.md) 閱讀約定 來源標示 全書在句末或表格中使用下列標示。凡標示為「建議」的內容都不是 EGM 官方功能,請勿在簡報或對外文件中寫成官方保證。 ...

November 17, 2026 · 157 min · 33397 words · Eric Cheng

Herdr App and Herdr Core 教學手冊

herdr-app and herdr-core 教學手冊(企業級 AI Agent 協作開發:安裝、操作、Multi-Agent、逆向工程、框架升級與資安治理) 一句話定位:Herdr App 是「看」與「排」的桌面視窗,herdr-core(hc)是「跑」與「接」的背景 Runtime,AI Coding Agent 才是「做事」的人。本手冊教同仁把三者正確分工,用在新系統開發、Legacy 逆向工程與框架升級三種企業情境,並且知道哪些事 Herdr 不會替你做。 文件資訊 項目 內容 文件名稱 herdr-app and herdr-core 教學手冊 文件版本 1.1 更新日期 2026-11-12 文件目的 讓企業開發團隊能實際安裝、操作、整合、維運及導入 Herdr App 與 herdr-core,並以 AI Agent 完成 Web Application 開發、Legacy System 逆向工程與 Framework 升級 適用對象 PM、SA、系統架構師、前後端工程師、測試工程師、DevOps/Platform 工程師、資安工程師;以資深工程師的實戰與維運為主軸 技術範圍 Herdr App 0.1.15、herdr-core 0.1.20(API protocol generation 1)、OSC 7501 Program Status Protocol Rev 0.4、Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Gemini CLI、OpenCode、Git Worktree、Maven、Playwright、Trivy 適用環境 Windows 10/11(PowerShell 7、Git for Windows)為主要範例,另附 Linux/macOS 指令 文件語言 繁體中文(台灣),技術名詞保留英文 文件性質 作者閱讀兩個官方 Repository 的原始碼、由 binary help 產生的官方命令參考、OSC 7501 規格與各 Agent 官方資料後重新整理;不是官方文件翻譯。範例中的系統名稱、模組與任務都是虛構示範 參考資料 官方 Repository、herdr.dev、OSC 7501 規格、各 Agent 官方 Changelog;完整清單見參考資料 修訂紀錄 版本 日期 主要變更 1.0 2026-11-12 初版:7 篇 30 章+附錄 A~F+Checklist+參考資料;附 6 支實測過的企業延伸工具(OSC 7501 回報函式與驗證器、template/Mod/指令檢查器、Worktree 派工腳本、健康檢查腳本)與 3 個 JavaScript Mod 範例 1.1 2026-11-12 逐章重新查證(版本未變:App 0.1.15、Core 0.1.20)。修正:hc 名稱規則改依原始碼 addr.rs(以字母或數字開頭、不可像終端機 ID),同步修正派工腳本與 template_lint.py;Windows 單一引號字串走 cmd.exe、只有 template 需要 sh;Windows template 位置與 --help 字串的差異;KPI 的 Blocked 時間資料來源。新增:7.7 套件管理員安裝、21.10 行動裝置、23.8 version_check.py、25.4 導入前現實檢查、26.9 naming_lint.py、28.3 hc_kpi.py、29.5 已知未修正問題;第 22、25~30 章補齊「本章 AI 產出審查」;附錄 G AI 產出審查總表 版本基準與查證日期 本手冊查證基準日為 2026-11-12。Herdr 兩個專案幾乎每天都在改版(App 與 Core 都還是 0.1.x),使用前請用第 23.1 節的方法重新確認版本,不要直接沿用本手冊的版本號。 ...

November 12, 2026 · 152 min · 32222 words · Eric Cheng

Ghidra 教學手冊

Ghidra 教學手冊(Ghidra + AI Agent 軟體逆向工程企業標準:安裝、分析、Headless 自動化、MCP Adapter、AI 協作、品質審查與維運) 一句話定位:Ghidra 負責從 Binary 擷取可以驗證的證據,例如函式、位址、字串、交叉參照與反編譯虛擬碼;AI Agent 負責整理與推理;人員負責確認與核准。本手冊教你把這三者接成一條可重跑、可稽核、可審查的企業流程,而不是「把 EXE 丟給 AI,問它在做什麼」。 文件資訊 項目 內容 文件名稱 Ghidra 教學手冊 文件版本 2.1(十篇、41 章;新增「行為層級」的驗證工具與 12.2 新功能) 更新日期 2026-11-12 文件等級 企業標準技術白皮書。可直接作為專案團隊的逆向工程作業規範與教育訓練教材 文件目的 讓同仁能夠:(1) 獨立安裝與操作 Ghidra;(2) 用 Headless 管線批次產出結構化分析資料;(3) 透過企業自建的唯讀 MCP Adapter,讓 Claude Code、Codex、GitHub Copilot 使用 Ghidra;(4) 用可重跑的檢查工具審查 AI 產出的逆向工程報告;(5) 依 SOP 維運、升級與管控整個平台 適用對象 資深工程師、Reverse Engineer、系統分析師、軟體架構師、AI Engineer、DevSecOps、PM。主軸是實戰與維運;初學者可以依第一~三篇循序學習 技術範圍 Ghidra 12.2(JDK 25)、PyGhidra 3.2.0、Headless Analyzer、Ghidra Extension(Gradle 9.8.0)、MCP Python SDK 2.3.0、Claude Code 2.1.322、OpenAI Codex、GitHub Copilot(VS Code 1.145.3) 適用環境 主要範例為 Windows 10/11(PowerShell 7);另附 Linux 指令(以 Temurin 25 容器實測)與 macOS 指令 文件語言 繁體中文(台灣)。技術名詞保留英文,第一次出現時附中文說明 文件性質 作者閱讀 Ghidra 官方原始碼、發行包文件、官方 GitHub 與各 AI 工具官方文件,並在本機實測後重新組織而成;不是任何官方文件的翻譯。範例中的銀行規則、帳號與表名都是虛構的 Lab 資料 參考資料 完整清單見第 41 章與文末「參考資料」 修訂紀錄 版本 日期 主要變更 1.0(第一部分) 2026-11-12 第一~四篇(第 1~15 章)。第五篇起的撰寫中斷,未收錄 2.0 2026-11-12 全面重寫並補齊十篇 41 章:(1) 新增第五~十篇:AI 整合架構、MCP 比較與自建 Adapter、Claude Code/Codex/Copilot 整合、四個實戰案例、維運、升級、安全、導入、Prompt、Skills、品質管理、教育訓練、Roadmap、附錄(2) 每章最後都有「本章 AI 產出審查」,列出好例、壞例與可重跑的檢查指令(3) 重新查證版本,並重跑 Lab 管線、MCP Adapter 驗收測試與報告審查工具(4) 目錄改依 Hugo 實際錨點產生,並逐一比對 2.1 2026-11-12 逐章查證並補強深度(上游版本與 2.0 相同,未全面重寫):(1) 新增行為層級的驗證:P-Code 模擬驗證規則(12.14)、案例檔審查、可執行的驗收基準(26.11)、BSim 版本差異(27.11)、考題自動驗證(37.8)(2) 新增 12.2 相關主題:DWARF/PDB 與簽章來源(10.14)、Go/Rust/Swift(10.15)、企業型別庫(8.10)、Debugger 與 Timeless Debugging(3.19、31.15)、Server 憑證與 Allow List(29.12)、VS Code/jshellRun(13.14)(3) 新增 8 支實測工具與附錄 A.5 的 Lab 變體(C、Go、Rust);FAQ 新增 4 個實際踩到的問題(40.16~40.19)(4) 修正:EmulatorHelper 已 deprecated(改用 PcodeEmulator);Demangler 安全公告改以官方 GHSA 為準;第 39.11 節的抽取程式略過 markdownlint 註解 版本基準與查證日期 本手冊的查證基準日是 2026-11-12。Ghidra 大約每 1~3 個月發布一次修正版,AI 工具更是每週改版。使用前請先用第 30.1 節的方法重新確認,不要直接沿用下表。 ...

November 12, 2026 · 206 min · 43819 words · Eric Cheng

Claude Code Migration Kit 教學手冊

Claude Code Migration Kit 教學手冊(Anthropic 官方大型程式語言遷移入門套件:Rulebook、Dependency Map、對抗式審查、Survey Build 與 Parity Referee 實戰) 一句話定位:Claude Code Migration Kit 是 Anthropic 隨〈How Anthropic runs large-scale code migrations with Claude Code〉一文公開的參考套件,用 8 支 Prompt、3 份範本、6 支確定性腳本與一份 CLAUDE.md,把「整個專案換程式語言」拆成六個有 Gate 的步驟。它不是一鍵翻譯工具:它的價值在於先寫規則、再拿規則去打真實程式碼、用磁碟上的檔案記錄進度、用編譯器與新舊行為比對當裁判——AI 自己說「完成了」不算數。 文件資訊 項目 內容 文件名稱 Claude Code Migration Kit 教學手冊 文件版本 1.1 更新日期 2026-11-11 文件目的 讓第一次接觸 Migration Kit 的同仁,能依本文件完成環境建置、可行性評估、Judge 建立、Rulebook 制定、AI Agent 協作翻譯、編譯收斂、行為比對與最終驗收;並提供企業導入、治理與維運的依據 適用對象 PM、SA、系統架構師、資深工程師、前後端工程師、DevOps/DevSecOps 工程師、AI Agent 開發與維運人員;以資深工程師的實戰與維運為主軸 技術範圍 Migration Kit(commit cf91c9d)、Claude Code 2.1.322(Subagent、Dynamic Workflow、Agent Teams、Skills、Hooks、Permissions)、Python/TypeScript/C/Rust 遷移、GitHub Actions/GitLab CI、Trivy、SBOM 適用環境 Windows 10/11(PowerShell 7、Git Bash)為主要範例,另附 Linux/macOS 指令 文件語言 繁體中文(台灣),技術名詞保留英文 文件性質 作者閱讀官方原始碼、官方文章與 Claude Code 官方文件,並在本機實測後重新組織的內容,不是官方 README 的翻譯;範例中的系統、人名、金額全部虛構 參考資料 官方 Repository、官方文章、Claude Code 官方文件;完整清單見文末「參考資料」 修訂紀錄 版本 日期 主要變更 1.1 2026-11-11 重新查證版本基準(Kit 仍為 cf91c9d、Claude Code 仍為 2.1.322);新增第 6.8 節「上線切換、影子雙跑與回滾」與實測工具 shadow_diff.py(反例測試 14/14、突變 4/4);新增第 8.5 節「業界案例對照」(Google、Airbnb,第一手來源);第 8.1.5 節補充 Bun 合併前後的事實;14.2 節補 AWS Transform;新增附錄 D 審查者速查卡、附錄 E 術語表;目錄依 Hugo 輸出重建 1.0 2026-11-11 初版:14 章+附錄 A~C+重點整理+新進成員 Checklist+參考資料;附一個可實跑的 Python → TypeScript Lab 與 8 支實測過的企業延伸工具 版本基準與查證日期 本手冊的查證基準日為 2026-11-11。Migration Kit 官方已標示不再維護,但 Claude Code 每週都在改版,使用前請以第 10.2 節的方法重新確認,不要直接沿用下表。 ...

November 11, 2026 · 122 min · 25795 words · Eric Cheng

Code Modernization 教學手冊

code-modernization 教學手冊(Anthropic 官方 Claude Code Plugin:舊系統理解、商業規則萃取、Uplift/Transform/Reimagine 與新舊行為一致性證明) 一句話定位:code-modernization 是 Anthropic 放在官方 Marketplace(claude-plugins-official)的 Claude Code Plugin,用 13 個命令、8 個專業 Agent 與一組 Python 驗證腳本,把「理解舊系統 → 萃取商業規則 → 人工核准計畫 → 分階段現代化 → 由腳本計算的獨立證明」做成可重跑、可交接的流程。它不是讓 AI 一次性重寫整個舊系統的工具;它的價值在於每一步都留下檔案、每個關鍵決定都由人做、每個「完成」都要有測試結果檔與新舊輸出比對當證據。 文件資訊 項目 內容 文件版本 1.1 文件日期 2026-11-11 文件語言 繁體中文(台灣),技術名詞保留英文 適用對象 PM、SA、系統架構師、前後端工程師、DBA、QA、DevOps、資安人員;以資深工程師的實戰與維運為主軸 適用環境 Windows 10/11(PowerShell 7、Git Bash、Windows Terminal)為主要範例,另說明 WSL2 核心工具 Claude Code、code-modernization Plugin 1.0.0 文件用途 公司內部教育訓練教材、現代化專案執行參考、SSDLC 檢核依據 文件性質 作者閱讀官方原始碼、官方文件並在本機實測後重新組織的內容,不是官方 README 的翻譯;範例中的帳號、金額、系統名稱全部虛構 修訂紀錄 版本 日期 主要變更 1.0 2026-11-11 初版:16 章+附錄 A~D+新進成員 Checklist+參考資料 1.1 2026-11-11 重新查證版本(Plugin、Marketplace、Claude Code 均無變動);吸收 Anthropic COBOL 現代化文章與 Playbook、Thoughtworks 評估、Martin Fowler〈Patterns of Legacy Displacement〉、Microsoft Shadow Testing;新增並實測 6 支驗證工具(golden master 核准、mutation testing、對帳、雜湊清冊、寫入範圍、規則漂移);新增第 8.3.8、9.3.1、9.3.2、9.4.1、9.9.1、10.10.1、13.23 節;第 1~16 章各節補上判斷範例、好例/壞例與可重跑的審查指令;各章實務案例擴充為多案例 版本基準與查證日期 本手冊的查證基準日為 2026-11-11。Plugin、Claude Code 與各框架都會持續改版,使用前請以第 12.3 節的方法重新確認,不要直接沿用下表。 ...

November 11, 2026 · 150 min · 31857 words · Eric Cheng

Awesome Claude Code 教學手冊

awesome-claude-code 企業級 AI Agent 軟體開發教學手冊(資源探索、工具選型、導入治理與三大場景實戰) 一句話定位:awesome-claude-code 是一份由社群維護的 Claude Code 資源清單(Awesome List),不是 Anthropic 官方產品、不是 Claude Code 的安裝套件,也不是一套開發框架。本手冊教你把它當成「資源探索入口」,建立「探索 → 評估 → 審查 → PoC → 白名單 → 標準化 → 維護」的企業流程,並套用到 Web Application 開發、既有系統逆向工程、Framework 升級三大場景。 文件資訊 項目 內容 文件版本 1.1 文件日期 2026-11-08(1.0 版:2026-11-07) 文件語言 繁體中文(台灣) 適用對象 PM、SA、Architect、SD、PG、QA、DevOps、資安、資訊主管 適用環境 Windows 10/11(PowerShell 7、Windows Terminal、Git Bash)、WSL2、Linux、macOS、VS Code、IntelliJ IDEA 核心工具 Claude Code、awesome-claude-code 文件用途 企業 AI Agent 開發教育訓練與導入標準 文件性質 企業內部教育訓練與開發規範。內容為作者研究、比較、實測後重新組織,不是任何專案 README 的翻譯;範例中的帳號、金額、客戶資料全部虛構 修訂紀錄 版本 日期 主要變更 1.0 2026-11-07 初版:16 章+附錄 A~C 1.1 2026-11-08 (1) 每章新增「本章 AI 產出審查」小節(好例/壞例/可重跑的驗證指令),新增第 16.12 節與附錄 D 審查速查表;(2) 新增第 5.10.1 節:auto mode 自 v2.1.283 起為預設起始模式的企業設定與驗證;(3) 範例修正:guard-shell 一般推送改回傳 ask(補 git -C <dir> push 繞過 ask 規則的缺口)、防護 Hook 加 onFailure: "block"、deny 路徑改為語意明確的 **/ 寫法、Test-ClaudeProjectConfig.ps1 增為 33 項、Hook 測試增為 69 案例;(4) 第 10.18 節對照 OWASP Agentic Top 10(ASI01~ASI10)與 OWASP MCP Top 10,新增第 10.16.1 節 AIBOM;(5) 補強偏薄章節:6.4.6、6.4.14、7.4.x、8.4.1/8.4.2/8.4.9、10.7、11.5/11.7/11.10、12.11(AI 歸屬標示與分級審查)、14.19、15.5.6 版本基準與查證日期 本手冊所有數字、版本、指令都在 2026-11-07 查證,1.1 版於 2026-11-08 複查(awesome-claude-code main 仍為 a79b5a8、Claude Code latest 仍為 2.1.319,數字差異在下表註明)。社群工具變化非常快,使用前請用第 11 章的工具重新查詢,不要直接沿用本表。 ...

November 8, 2026 · 148 min · 31358 words · Eric Cheng

Impeccable 教學手冊

Impeccable 企業級 UI/UX 設計治理與 AI Coding Agent 整合教學手冊(實戰與維運) 一句話定位:Impeccable(pbakaus/impeccable)是一套給 AI Coding Agent 用的設計指導 Skill(Design Skill)+確定性設計檢查器(Deterministic Design Detector)。它讓 Agent 用一致的設計詞彙工作、在改 UI 時自動收到設計問題回饋,並能在 CI 裡用不需要 LLM 的規則掃描 UI。它不是 UI 元件庫、不是 Framework 遷移工具,也不能取代 Accessibility、E2E 與視覺回歸測試。 適用對象:資深前端工程師、前端架構師、SA/SD、UI/UX 設計師、DevSecOps 工程師、AI 技術推動人員。PM 與 QA 可依「閱讀路徑」選讀。 版本基準: 項目 內容 文件名稱 impeccable 教學手冊(Impeccable 企業級 UI/UX 設計治理與 AI Coding Agent 整合) 文件版本 1.1(2026-11-07;1.0 初版同日發行,1.1 補強「審查 AI 產出」與圖像生成,見附錄 E) 研究日期 2026-11-07(所有「查證日期」未另註明者,皆為此日) Impeccable 版本 Skill/CLI v4.8.0(2026-10-26 發布;npm impeccable 的 latest 為 4.8.0;GitHub tag skill-v4.8.0);隨附引擎 engine 0.1.18 上游狀態 main 分支 commit 687bc38(2026-11-06),領先 skill-v4.8.0 90 個 commit;engine-v0.1.19 已於 2026-11-07 發布但尚未進入 npm 的 Skill。只存在於 main 的行為一律標註「main/未發布」。2026-11-07 撰寫 1.1 時複查:npm latest 仍為 4.8.0,main 沒有新 commit 授權 Apache License 2.0(Skill、指令、CLI、偵測引擎皆開源免費;AI 模型與影像生成費用由各工具另計) 適用 AI Coding Agents Claude Code、GitHub Copilot(VS Code/CLI/Cloud Agent)、OpenAI Codex、Cursor、Gemini CLI;另支援 Grok Build、Devin、Replit Agent、OpenCode、Google Antigravity、Kiro、Trae、Rovo Dev、Qoder、Mistral Vibe、Pi、Hermes Agent、DeepSeek Harness、Veto(本手冊以前五者為主) 實測狀態 以 impeccable@4.8.0 實測:CLI 全部子指令說明、detect(原始碼/HTML/URL/桌機與手機 viewport/--json/--github/--scope/--no-config)、62 條規則清單、例外管理(ignores、行內註解、檔案範圍)、detector.extensions(JSP)、DESIGN.md 設計系統規則、install(claude/codex/cursor/github/gemini 五種 Provider)、update、check、link(Windows symlink 失敗情境)、Hook 以模擬事件實際觸發(PostToolUse、Stop、去重)、引擎下載與 checksum 驗證、品質閘門腳本、Playwright 視覺回歸+axe 測試(16 項)、AI 產出審查腳本(PowerShell/Bash,以好例、壞例、錯誤路徑三種情境驗證) 未實測 在各 AI Agent 對話中實際執行 /impeccable 設計指令(需要模型與帳號)、Live Mode 瀏覽器互動、影像生成(mockup-first)、Chrome Extension(含 critique 視覺疊層)、VS Code Extension、Claude Code Plugin Marketplace 安裝、GitHub Actions 實際雲端執行 撰寫環境 Windows 11 Pro 10.0.26300、Node.js 24.16.0、npm 11.13.0、Git for Windows、PowerShell 7、Google Chrome(Edge 因公司政策禁止 DevTools 遠端偵錯而無法用於自動化) 外部版本參照 Vue 3.5.45、PrimeVue 5.0.4、Tailwind CSS 4.3.5、Vite 8.3.6、TypeScript 7.0.2、Playwright 1.65.0、axe-core 4.14.0、@axe-core/playwright 4.14.0、Lighthouse CI @lhci/cli 0.16.0、Storybook 10.6.6、Style Dictionary 5.8.0 文件性質:企業內部教育訓練與開發規範。內容是重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的系統名稱、色碼、銀行情境與數值皆為教學示範,不代表任何公司或銀行的正式設計規範。 ...

November 7, 2026 · 114 min · 24190 words · Eric Cheng

T3 Code 教學手冊

T3 Code 企業級技術教學手冊(實戰與維運) 一句話定位:T3 Code(pingdotgg/t3code)是一個代理執行框架控制介面(Agent Harness Control Surface)。它本身不是 AI 模型,也不是 Coding Agent;它把你電腦(或遠端開發主機)上已經安裝、已經登入的 Claude Code、Codex、Cursor、OpenCode 等 Agent 包起來,提供統一的 Web、桌面與手機操作介面,再加上專案(Project)、執行緒(Thread)、Git Worktree、權限模式、遠端連線與 MCP 等管理能力。真正讀程式、改程式、跑指令的永遠是 Provider 的 Agent,而且是在「執行 T3 Code Server 的那台機器」上執行——這是理解本手冊所有內容的第一原則。 適用對象:資深工程師、SA/SD、架構師、DevSecOps 與維運人員、資安與治理人員、AI 技術推動人員。PM 與 QA 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Git、PowerShell 或 Bash、JSON 與一種主流 Coding Agent。 版本基準: 項目 內容 研究對象 GitHub pingdotgg/t3code,MIT 授權;main 分支 commit 33f8584(2026-11-07 05:15 UTC;1.0 基準 4cb6945 之後的變更均為 Mobile 修正,docs/ 無變動) Stable 版本 v0.1.7(2026-11-04 發布;npm t3 的 latest tag 亦為 0.1.7)——本手冊以此版本為準 Nightly 版本 0.1.8-nightly.20261107.4301(研究當日最新;Nightly 一天會發布數版) 文件基準 docs/ 以 main 為主,並與 v0.1.7 tag 逐檔比對;只存在於 main 的功能(例如 Secrets 設定頁、Web/Desktop 語音輸入)標註為 Nightly/預覽 研究基準日期 2026-11-07(所有「查證日期」未另註明者,皆為此日) 實測狀態 npx t3@0.1.7 以隔離資料目錄實測 CLI 全部子命令說明、t3 serve、project add、auth pairing create/list/revoke、auth session list、status、doctor --dry-run、trace summary、policy check/show/templates、connect status、environment list、service status、MCP 端點未授權回應 ✅。Desktop App、Mobile App、T3 Connect 實際連線、Provider 登入後的 Agent 執行、Tailscale、SSH 遠端環境未實測,依官方文件與原始碼整理,標 📖 撰寫環境 Windows 11 Pro 10.0.26300、Node.js 24.16.0、Git for Windows、PowerShell 7、Claude Code 2.1.319 外部版本參照 Java 25(LTS)、Spring Boot 4.1.2、Spring Framework 7.0.10、Maven 3.9.16(Maven 4 仍為 4.0.0-rc-7,尚未 GA)、Vue 3.5.45;Spring Boot 4.2 仍為 4.2.0-RC2、Framework 7.1 為 7.1.0-RC2(預覽,未 GA)(皆於 2026-11-07 由 Maven Central/npm 查證) 手冊版本 1.1(2026-11-07;1.0 初版同日稍早發布,版本紀錄見附錄 D) 文件性質:企業內部教育訓練與開發規範。內容是重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、系統與資料全部虛構(使用 corp.example、example.com 等保留網域)。各章結尾的「實務案例」是依常見導入情境設計的教學情境範例,不是特定組織的真實事件紀錄。 ...

November 7, 2026 · 129 min · 27381 words · Eric Cheng

Knowledge Work Plugins 教學手冊

knowledge-work-plugins 企業級教學手冊(實戰與維運) 一句話定位:anthropics/knowledge-work-plugins 是 Anthropic 開源的職能型 Plugin 集合與 Marketplace。每個 Plugin 用 Markdown(Skills)與 JSON(MCP 連線設定)把「某個職能怎麼做事、要連哪些工具」打包起來,讓 Claude Cowork 與 Claude Code 能用一致的方式完成業務、財務、法務、資料分析、工程等工作。它是很好的起點範本,但不是可以直接上線的企業系統:它不懂你的公司 SOP、不連你的內部系統、也不會自動符合金融業的權限與稽核要求——這些都要企業自己補上,本手冊就是教你怎麼補。 適用對象:資深工程師、AI 平台工程師、架構師、資安與治理人員、維運人員;各部門 AI 推動負責人與 PM 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Git、JSON、Markdown 與命令列。 版本基準: 項目 內容 研究對象 GitHub anthropics/knowledge-work-plugins,main 分支 commit d900840(2026-11-04 02:50 UTC),Apache-2.0 授權 Release 沒有 GitHub Release 與 tag;版本只能看各 Plugin plugin.json 的 version 與 commit(見 13.2) 實際內容 Marketplace 共 123 個 Plugin:17 個 Anthropic 第一方(repo 內目錄)+ 5 個合作夥伴內嵌於 partner-built/ + 101 個外部來源(以 url 或 git-subdir 指向第三方 repo,並固定 commit sha)(見 4.1) 與 README 的落差 官方 README 仍寫「open-sourcing 11 plugins」,並示範 /finance:reconciliation 等指令;實際已有 17 個第一方 Plugin,且多數 commands/ 已改為 skills/(見 3.1、4.1) Claude Code 撰寫環境 v2.1.318;本手冊引用的功能都註明最低版本需求(例如 claude plugin validate 的 MCP 檢查需 v2.1.281+) MCP 規格 最新穩定版 2026-07-28(前一版 2025-11-25);範例 MCP Server 使用 npm @modelcontextprotocol/sdk 1.32.2 研究基準日期 2026-11-04(所有「查證日期」未另註明者,皆為此日) 實測狀態 見下方「圖示說明」。手冊內附的企業 Marketplace、company-software-engineering Plugin、corp-change-sop Plugin 已以 claude plugin validate --strict 驗證通過;PreToolUse 守門 Hook 20 個案例、MCP Server smoke test 11 項、plugin-preflight.py 三組資料皆已實測 ✅。Claude Cowork 端操作、組織管理後台、MCP tunnels、Compliance API、實際連線第三方 SaaS Connector 未實測(需要 Team/Enterprise 組織與各 SaaS 帳號),依 claude.com/support.claude.com/platform.claude.com 官方文件整理,標 📖 撰寫環境 Windows 11 Pro 10.0.26300、Node.js 24.16.0、Python 3.12、Git for Windows 手冊版本 1.1(2026-11-04;1.0 初版同日發布,1.1 補 Cowork/claude.ai 管理控制、MCP tunnels 與各章範例,版本紀錄見附錄 D) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、系統與資料全部虛構(使用 corp.example、example.com 等保留網域)。 ...

November 4, 2026 · 146 min · 31088 words · Eric Cheng