前言¶
在使用 DeepSeek Harness 或其他 Agent Skills 兼容工具時，智能體往往容易在需求不明確的情況下直接跳轉到代碼實現，這容易導致返工或交付物不符合預期。SpecWorkflow 爲智能體提供了一條從粗糙請求到需求澄清、實現規範、代碼執行、交付審查、修復規劃，再到基於源碼研究的完整路徑。
是什麼¶
SpecWorkflow 是一個共享工作流技能包，由 MoonCoder-HAPPY 維護。它兼容 DeepSeek Harness 和其他 Agent Skills 工具。其核心作用是賦予智能體一條有序的工作流：從最初的模糊請求出發，經過需求質詢，生成實現規範，執行代碼，進行交付審查，制定修復計劃，診斷故障，最後完成基於源碼的研究。
核心功能¶
SpecWorkflow 提供以下技能：
- Research (deep-research)：基於源碼、文檔、API、標準或其他第一手資料的調查。
- Requirement Grilling (to-grill)：需求質詢、消除歧義、風險審查，以及決定是直接修復還是進入完整工作流。
- Implementation Specs (to-spec)：生成實現就緒的規範、修改、驗收標準、驗證計劃和可選的任務工單。
- Execution (spec-do)：從已批准的規範、問題集、修改或修復計劃中執行代碼。
- Delivery Review (do-review)：對照原始請求、規範、代碼差異、測試和證據進行最終交付審查。
- Repair Planning (fix-review)：針對審查中發現的必須修復項，生成修復規範和修復工單。
- Bug Diagnosis (bugs-fix)：重現故障、根因診斷、修復並生成修復證據。
安裝與啓用¶
在 DeepSeek Harness 中安裝：
dsh plugin --profile web add specworkflow
dsh web
安裝完成後，可以通過 dsh --profile web --dump-config 檢查配置是否包含 specworkflow 插件。
典型用法與工作流¶
SpecWorkflow 並非對每個請求都強制走完整流程。對於小而具體的編輯（如“把表格字體變大”），智能體會直接進行實現，避免流程冗餘。只有涉及跨模塊影響、產品層面的需求、數據語義、權限邊界、API 或發佈敏感性的工作，纔會被提升到完整工作流中。
進入完整工作流後，順序如下：
to-grill -> to-spec -> spec-do -> do-review -> fix-review -> spec-do repair -> do-review
to-grill 會將模糊請求轉化爲具體的結論，並決定後續走向；to-spec 將其轉化爲實現契約；spec-do 是首次接觸生產代碼的階段；do-review 決定是否可以交付；fix-review 針對必須修復的問題生成計劃；bugs-fix 和 deep-research 則作爲輔助技能，分別用於故障診斷和深度源碼研究。
目錄結構與目標模式¶
SpecWorkflow 將工作流文件保存在項目根目錄下的 .spec-workflow 文件夾中，以確保項目代碼和智能體的證據記錄相互分離。
目錄結構示例：
.spec-workflow/<feature-slug>/
requirements.md
spec.md
issues/
amendments/
implementation/
review/
repair-spec.md
repair-issues/
verification/
debug/
bugs/
research/
Goal Mode 是一個連續執行開關。開啓後，智能體可以在不中斷的情況下連續完成一個規範的實施、審查、修復實施和二次審查，直到完成或遇到產品選擇、安全、Git 決策等阻斷點。
總結¶
SpecWorkflow 通過標準化的技能組合，幫助 DeepSeek Harness 中的智能體在複雜任務中保持清晰的執行路徑。通過區分簡單編輯和複雜工作流，它既保證了效率，又確保了交付質量。
- GitHub: https://github.com/MoonCoder-HAPPY/SpecWorkflow
- 目錄: https://www.skillhub.cn/plugins/MoonCoder-HAPPY/SpecWorkflow
