前言¶
在構建智能體應用時，維護一套統一的工作流標準、測試設計規範和代碼評審流程往往需要重複造輪子。AgentForge 提供了一套經過整合的 agent 工作流與工程技能集，旨在解決這些問題。
簡介¶
這是一個通用 agent 工作流與工程技能集，可安裝到 Codex、Claude Code 與 DeepSeek Harness 中。插件本身基於 JavaScript，零依賴，不需要額外的 MCP 服務。它通過複用項目已有的測試和審計工具，爲不同的 Agent 任務提供標準化的執行路徑。
核心功能¶
插件包含八個核心技能，覆蓋從調研到實施的全流程：
- 調研取證：負責代碼與日誌調查、證據鏈收集和報告生成。
- 測試設計：依據業務規則和項目現有設施，設計用例、評估場景缺口並制定驗證辦法。該技能僅交付設計，不編寫或執行測試。
- Bug 調試：復現問題、驗證根因。執行時會展示原因、證據和修復方案，在用戶同意後再進行修復與迴歸驗證。
- 架構調查：用戶主動發起的架構機會檢查，支持並行取證，允許零候選結果。
- 實施工作流：支持任務拆分、串行或並行實施，以及集成驗證與按風險審計。
- 差異評審：分別從 Correctness（正確性）、Standards（規範）和 Spec（規格）三個軸獨立進行評審。
- 複雜度審計：評估複雜度與覆蓋率風險。當數據不足時，明確給出降級方案。
- 突變測試：調用現有的突變測試工具，查找存活突變體以發現測試漏洞。
安裝與啓用¶
在 DeepSeek Harness 中安裝該插件：
dsh plugin --profile web add github:Lixiuxiu559/AgentForge
安裝完成後，需要重啓該 profile 才能使插件生效。由於本插件未發佈到 npm，DSH 側沒有按版本號升級的途徑。
典型用法¶
在對話中直接調用對應的技能即可：
- 調查錯誤調用鏈：用
research調查這個錯誤的調用鏈，給出證據和未確認項。 - 設計測試用例：用
test-design爲這項功能設計測試用例，檢查業務邊界、異常和狀態變化是否覆蓋充分。 - 排查異常：用
bug-debugging排查這個異常，先說明原因和修復方案，等我同意後再改。 - 實施功能：用
implementation-workflow實現這個功能，獨立模塊可以並行。 - 評審改動：用
diff-review評審當前改動，分別報告三條軸的結果。 - 架構檢查：用
architecture-scout檢查這個模塊是否有值得提煉的邊界。
適用場景與注意事項¶
該插件適合需要結構化工作流、統一測試標準和嚴格評審流程的項目。
需要特別注意以下幾點：
1. 獨立上下文隔離：獨立上下文並不隔離文件系統。因此，對於同文件的修改或共享構建產物等操作，仍需安排互斥，避免衝突。
2. Git 安裝機制：通過 git 安裝沒有版本門控，lockfile 裏釘的是具體 commit。update 操作會將版本跟到 main 分支的最新提交，相當於 main 分支即發佈通道。
3. 審批機制：bug-debugging 技能在修復前需要用戶明確同意方案，單純的“幫我修好”請求不會自動跳過審批步驟。
後續¶
AgentForge 將技能統一維護在 skills/ 目錄下，旨在通過一套代碼服務多個平臺。完整的使用說明和項目結構可參考項目主頁。
