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

PentAGI 教學手冊

PentAGI 企業級教學手冊(實戰與維運) 一句話定位:PentAGI 是一套自我託管(self-hosted)的多 Agent AI 滲透測試平台。它用 LLM 規劃測試步驟,在 Docker 容器裡呼叫 nmap、sqlmap 等安全工具執行,並把過程、結果與記憶存進 PostgreSQL/pgvector。它能加速授權範圍內的安全驗證,但不會自動讓你的系統安全,也不能取代資安人員、SAST/DAST/SCA 與正式安全驗收。 適用對象:資深工程師、架構師、DevSecOps、資安測試人員、平台維運人員。SA、PM 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git 與至少一種 AI Coding 工具(Claude Code、GitHub Copilot、Codex 等)。 版本基準: 項目 內容 PentAGI 版本 v2.2.0(GitHub Release,2026-10-05 發布);本手冊所有原始碼與設定核對都以 tag v2.2.0 為準 main 追蹤 研究日 main 為 cffed94(2026-10-22),領先 v2.2.0 共 3 個 commit,全部是 README 文件修改,沒有程式或設定變更;另有多個尚未合併的安全與穩定性 PR 需追蹤(見 16.2、16.2.1) 前一版 v2.1.0(2026-05-29)、v2.0.0(2026-04-11);v2.1.0 以前受 CVE-2026-14784 影響(見 6.4) 授權 原始碼 MIT;另有 EULA(僅限合法滲透測試用途、可撤銷)與 NOTICE(VXControl Cloud SDK 授權說明);官方另販售 Enterprise Edition 授權。不能只看 GitHub 的 MIT 標籤(見 20.8) 原始碼核對範圍 README.md、.env.example、docker-compose*.yml、EULA.md、NOTICE、backend/docs/{docker,config,database}.md、examples/guides/{worker_node,installation_configuration}.md、examples/prompts/*、backend/pkg/config/config.go、backend/pkg/docker/{client,sandbox}.go、Release notes v2.0.0~v2.2.0 研究基準日期 2026-10-29(1.1 版於同日重新查核上游 Release、main、Docker Hub digest、NVD 與 open issue/PR) 實測狀態 未在實機安裝 PentAGI(需要真實 LLM API Key、Docker 主機,且平台本身會主動發起攻擊行為)。所有 PentAGI 指令都對照 v2.2.0 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 3 支企業自訂審查工具(.env 安全檢查、任務範圍檢查、弱點報告檢查)與第 18 章的稽核 SQL 已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8(僅用於撰寫與驗證審查工具,只用標準函式庫);PostgreSQL 16(Podman 暫時容器,只用於驗證第 18 章 SQL) 手冊版本 1.1(2026-10-29;補齊第 18 章、加入上游已知問題與待合併修補;版本紀錄見 21.12) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、系統與資料全部虛構(使用 example.com、corp.example、10.x、192.0.2.x 等保留或私有範圍)。 ...

October 29, 2026 · 114 min · 24088 words · Eric Cheng

NemoClaw 教學手冊

NemoClaw 企業級 AI Agent 沙盒參考堆疊教學手冊(實戰與維運) 一句話定位:NVIDIA NemoClaw 是一套「把受支援的 AI Agent 裝進 NVIDIA OpenShell 沙盒」的開源參考技術堆疊。它提供引導式安裝(onboarding)、版本化 Blueprint、託管推理路由、網路政策 preset、狀態保存與生命週期指令;真正執行隔離、攔截網路、保管憑證的是底下的 OpenShell。NemoClaw 讓你「少做整合工作」,不會讓 Agent「自動變安全」。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理者。PM、SA、SD 可依「閱讀路徑」選讀。內容偏實戰與維運,假設讀者熟悉 Linux、Docker、Git,以及至少一種 AI Coding 工具。 版本基準: 項目 內容 NemoClaw 版本 v0.0.139(tag commit a08ae7a,2026-10-26);官方文件站 latest 已對應此版 安裝程式預設版本 官方安裝程式預設追蹤 lkg(last known good)標籤,研究當日指向 v0.0.137(f00fb1d,2026-10-21);要用 v0.0.139 必須明確指定 NEMOCLAW_INSTALL_TAG=v0.0.139(第 4 章) 搭配的 OpenShell 0.0.116(Blueprint 的 min_openshell_version 與 max_openshell_version 都是 0.0.116;@nvidia/openshell-sdk 也釘 0.0.116) 支援的 Agent OpenClaw(預設)、Hermes、LangChain Deep Agents Code(dcode 0.1.71);三者在官方平台矩陣皆為 Tested,但 Hermes 官方註明「尚未宣稱與 OpenClaw 的正式環境同等」 專案階段 alpha/Early preview(官方平台矩陣:自 2026-03-16 起),維護者以 best effort 回應、無 SLA 原始碼核對 NVIDIA/NemoClaw tag v0.0.139:docs/(官方文件原始檔)、install.sh、scripts/install-openshell.sh、nemoclaw-blueprint/(Blueprint 與政策)、agents/*/(各 Agent 的 manifest 與政策)、src/lib/(CLI 實作) 研究基準日期 2026-10-27;main 追蹤至 bafe6cc(2026-10-26,領先 v0.0.139 共 18 個 commit);另有 Rust 重寫的 v1 分支(見 1.7)。1.1 版於同日再核對:沒有新 tag,lkg 仍指向 v0.0.137,main 仍為 bafe6cc(18.11) 實測狀態 未在實機安裝 NemoClaw 或 OpenShell。所有 NemoClaw/OpenShell 指令都對照 v0.0.139 官方文件與原始碼,標 📖;需要實際環境才能確認的內容標 🧪 並附驗證步驟。手冊內附的 5 支企業自訂審查工具(政策 lint、交付報告比對、架構依賴檢查、逆向工程引用檢查、測試弱化檢查)、安全公告版本下限腳本與 ArchUnit 範例,已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300、Python 3.12.8、PyYAML 6.0.3、OpenJDK 21.0.4、Maven 3.9.9、Node.js 24.16.0(僅用於撰寫與驗證審查工具) 手冊版本 1.1(2026-10-27;1.0 於同日初版;版本紀錄見 18.13) 文件性質:企業內部教育訓練與開發規範。內容為重新整理、分析與教學化撰寫,不是官方文件翻譯。範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、corp.example、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 117 min · 24890 words · Eric Cheng

OpenShell 教學手冊

OpenShell 企業級 AI Agent 安全執行環境教學手冊(實戰與維運) 一句話定位:NVIDIA OpenShell 是讓 AI Agent「在受控邊界內做事」的安全執行與治理 Runtime。它不是模型、不是 Agent Framework,也不只是容器管理工具;它把檔案、程序、網路、憑證四件事從 Agent 手中收回,交給 Agent 碰不到的 Gateway 與 Supervisor 來決定。 適用對象:資深工程師、架構師、DevOps/DevSecOps、資安與維運人員、AI 平台管理人員。PM、SA、SD 可依 1.6 的學習路徑選讀。內容偏實戰與維運,假設讀者熟悉 Linux、容器、Git 與至少一種 AI Coding 工具。 版本基準: 項目 內容 OpenShell 版本 v0.1.5(Stable,2026-10-20 發布,tag commit bdb956f) 官方文件版本 docs.nvidia.com/openshell/latest(頁首標示「Latest (v0.1.5)」) 原始碼核對 NVIDIA/OpenShell tag v0.1.5:crates/openshell-cli/src/main.rs(CLI 參數)、providers/*.yaml(Provider Profile 範例)、examples/(官方範例) 研究基準日期 2026-10-27;main 分支追蹤至 commit 2ff59bf(2026-10-26),未發布變更見 18.2.1 實測狀態 未在本機安裝或實測(使用者決定只依文件撰寫)。所有指令都對照 v0.1.5 官方文件與 CLI 原始碼,標 📖;需要實際環境才能確認的內容標 🧪,並附驗證步驟與預期結果。1.1 新增的 4 支審查工具(policy-lint.py、check-test-evidence.py、check-dockerfile.sh、引用檢查)已在撰寫環境以合成資料實測,標 ✅ 撰寫環境 Windows 11 Pro 10.0.26300(僅用於撰寫與文件驗證,未安裝 OpenShell) 手冊版本 1.1(2026-10-27:新增 AI 產出審查方法與工具、main 未發布變更追蹤;版本紀錄見 24.11) 文件性質:企業內部教育訓練與開發規範。內容為重新整理與組織,不是官方文件翻譯;所有範例中的主機名稱、帳號、Token、IP、專案與客戶資料均為虛構(使用 example.com、example.internal、10.x 等保留或私有範圍)。 ...

October 27, 2026 · 124 min · 26236 words · Eric Cheng

Pstack 教學手冊

pstack:企業級 AI 輔助軟體工程教學手冊(Claude Code、Codex、Pi 實戰與維運) 一句話定位:pstack 是一包純文字的 Agent Skills(skills/<name>/SKILL.md)加上 24 條工程原則,目標是讓 AI 寫「更少但更扎實」的程式碼。本手冊把它從「個人工作風格」整理成「團隊可執行、可稽核、可維護」的企業做法。 適用對象:資深工程師、架構師、DevSecOps、QA、技術主管。偏實戰與維運,假設你已熟悉 Git、Node.js 與至少一種 AI Coding Agent。 研究對象:pstack 的兩個來源,兩者指令不可混用(詳見 1.1 與 5.1): 上游:cursor/plugins 儲存庫的 pstack/ 目錄,https://github.com/cursor/plugins/tree/main/pstack 獨立 mirror:backnotprop/pstack,https://github.com/backnotprop/pstack Claude Code Plugin 實際安裝的內容:上游根目錄的 harness/pstack/claude-code/(由 pstack/ 產生,詳見 1.1),https://github.com/cursor/plugins/tree/main/harness/pstack/claude-code 版本基準: 項目 內容 pstack 版本 技能、原則、範例逐檔核對的基準是 0.15.28(mirror 0c3333f/上游 d457567);上游 cursor/plugins/pstack 在 2026-10-20 已前進到 0.15.29(88d4751,只改 /sharpen 與同步文件,無新增技能、無可執行檔變更,見 14.2.1) mirror 最新 commit 0c3333f(2026-10-19,訊息為「Sync upstream cursor/plugins/pstack @ d457567 (0.15.28)」);2026-10-20 查證時尚未同步 0.15.29 技能資料夾數量 56(32 個一般技能+24 個 principle-*;Skills CLI 與本機 clone 兩種方式數量一致) 授權 MIT(LICENSE 署名 Lauren Tan,2026) 版本機制 沒有 release tag,只有 plugin.json 的版本字串與 commit hash;鎖版請用 commit hash(第 14 章) 事實查證日期 2026-10-20(官方文件、GitHub 原始碼、本機實測) 實測環境 Windows 11 Pro(10.0.26300)、Git Bash/PowerShell、Node.js 24.16.0、npm 11.13.0、Git 2.45.2、Skills CLI 1.7.4、Claude Code 2.1.303(查證日最新為 2.1.304)、JDK 21 教學環境 Windows 11(原生 PowerShell/Git Bash)為主;WSL、macOS、Linux 為補充(依官方文件,未實測) 手冊版本 1.1(2026-10-20):1.0 為同日初版;1.1 依上游 0.15.29、Claude Code 2.1.299~2.1.304、Codex Plugin 與 Pi 最新文件增補(版本紀錄見 19.5) 文件性質:企業內部教育訓練與開發規範。內容為作者整理後重新組織,非官方文件翻譯;引用來源列於第 19 章。範例中的帳號、密碼、金額、客戶資料全部是虛構資料。 ...

October 20, 2026 · 151 min · 32040 words · Eric Cheng

e2e 教學手冊

e2e:AI Agent 驅動的企業級端到端測試、逆向工程與軟體升級教學手冊 一句話定位:用 e2e(TesterArmy 開源專案)把「使用者看得到的行為」寫成可重複執行的驗收測試,讓 AI Coding Agent 在開發、逆向工程、Framework 升級時有一把可以量測的尺。 適用對象:資深前後端工程師、測試/品質工程師、DevOps、架構師。偏實戰與維運,假設你已熟悉 Node.js、TypeScript、Git 與 CI/CD。 研究對象:tester-army/e2e(npm 套件名稱 e2e),不是泛指所有 E2E 工具,也不等於 Playwright。 官方 Repository:https://github.com/tester-army/e2e 官方文件:https://e2e.tester.army/docs 官方介紹文章:https://tester.army/blog/introducing-e2e 版本基準: 項目 內容 e2e 版本 0.21.2(npm latest,GitHub Release 日期 2026-10-16) 搭配套件 @e2e-dev/web 0.15.2(已實測)、@e2e-dev/github 0.4.2(已實測,選用)、@e2e-dev/mobile 0.12.3(僅依 Release 資訊,未實測) 實測環境 Windows 11 原生、Node.js 24.16.0、npm 11.13.0、Chromium 156(Playwright 1.64.0);詳見 17.3 Node.js 需求 ^22.22.3 或 >=24.8.0(官方 CI 範例使用 Node 26) 授權 Apache-2.0 專案狀態 pre-1.0,積極開發中;官方明講 API 與設定在 minor 版本之間可能變動 資料研究日期 2026-10-19 事實查證日期 2026-10-19(以官方文件與 npm registry 為準) 教學環境 Windows 10/11 + WSL2(Ubuntu)(官方要求);Linux、macOS、GitHub Actions 為補充 文件性質:企業內部教育訓練與開發規範。內容為作者整理後重新組織,非官方文件翻譯;引用來源列於第 18 章。 ...

October 19, 2026 · 158 min · 33503 words · Eric Cheng