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