在 DSH 環境中進行智能體開發時,從概念到驗證的實現往往需要嚴謹的流程約束。dsh-specify-lite 提供了一個精簡的、插件化的方式來管理驅動開發。它獨立於 GitHub Spec-Kit,專注於在本地模型上實現,無需複雜的子智能體編排或繁重的 Git 操作。
它是什麼¶
dsh-specify-lite 是一個精簡的 DSH 原生插件,用於驅動開發(SDD)。由 MarcSierszen 維護。它解決了在沒有外部依賴或 Git 變更的情況下,結構化實現路徑的需求。該插件通過一系列命令將開發過程分解爲可驗證的步驟。
核心功能¶
- 驅動開發工作流:通過命令行命令管理規範、計劃、任務和實施。
- 三件套模型:維護規範、計劃和任務作爲獨立工件。
- 單模型執行:在一個智能體會話中運行,不使用子智能體或並行任務執行。
- Git 不可變性:不修改 Git 狀態(無分支、提交、合併或變基)。
- 憲法與規範:支持定義項目級原則和功能規範。
- 計劃與任務:生成技術計劃和排序的任務列表。
- 質量分析:執行只讀的質量審查。
- 實施與驗證:實施批准的任務並記錄驗證證據。
安裝與啓用¶
安裝插件需要使用 DSH 的插件管理器。請確保你的環境滿足依賴要求。
dsh plugin --profile web add git+https://github.com/MarcSierszen/dsh-specify-lite.git
典型用法¶
安裝完成後,可以在 DSH 會話中按順序執行工作流命令。
- 初始化項目:在項目根目錄運行
/speckit init。 - 定義憲法:運行
/speckit-constitution,輸入項目原則(例如:使用 Python,先設計 API 契約,遵循 RESTful 規範)。 - 定義功能規範:運行
/speckit-specify,輸入具體功能描述(例如:“添加健康檢查端點:GET /health 返回 HTTP 200 和 JSON {"status":"ok"}”)。 - 生成技術計劃:運行
/speckit-plan,要求生成保持契約的最小實現方案。 - 生成任務列表:運行
/speckit-tasks,獲取排序的任務列表。 - 實施與驗證:運行
/speckit-implement,插件將逐項實施並記錄驗證結果。
適用場景與注意¶
- 環境要求:插件依賴 Node.js 20 或更高版本。最低測試的 DSH 版本爲 0.1.1-rc.2。
- 運行模式:插件設計爲單模型運行,不涉及子智能體或並行任務,適合本地模型環境。
- Git 權限:插件在寫入文件前會請求顯式確認,且絕不執行 Git 變更操作。
- 任務 ID:任務使用穩定的 T001 風格 ID。
- 版本遷移:Version 0.2.0 引入了基於三件套模型的破壞性重新設計。使用 0.2.0 之前版本的項目,需要手動遷移工件(將功能目錄移至
specs/,重命名specify.md爲spec.md等)。
總結¶
dsh-specify-lite 通過提供一套獨立的命令集,將驅動開發流程標準化。它通過 Git 不可變性和單模型執行,降低了在 DSH 中進行復雜項目管理的複雜度。