前言¶

DeepSeek Harness（DSH）的核心哲學是“一切皆插件”。在智能體開發流程中，直接從代碼入手容易導致需求模糊或實現偏離預期。DSH 插件 dsh-spec 提供了一套 Spec-Driven Development（SDD）技能，將開發順序調整爲先寫規格，再寫代碼，最後驗收。

插件簡介¶

這個插件由 rongyishuaige7 維護，是一個單包三技能的組合。它不提供代碼生成功能，而是提供將 Idea 收斂爲可執行的 Spec，再將 Spec 轉化爲實現和驗收標準的能力。

核心功能¶

插件包含三個獨立技能，通過自然語言觸發。

dsh-spec-new：從 Idea 到 Spec¶

當需要開始一個新項目或需求變更時，使用該技能。觸發詞包括“幫我做一個 X”、“開個新項目”、“先寫規格”或“需求變了”。它會生成 specs/ 目錄，並寫入 requirements.md（包含 Given/When/Then 驗收標準）、design.md（設計思路）和 tasks.md（有序執行的任務列表）。

dsh-spec-implement：從 Spec 到 Code¶

當規格確認後，使用該技能。觸發詞包括“開始實現”、“按 spec 做”或“繼續實現”。它會讀取 tasks.md，並按順序執行任務，將實現進度寫回 Spec。

dsh-spec-validate：從 Spec 到 Acceptance¶

當需要驗證實現是否符合預期時，使用該技能。觸發詞包括“驗收”、“測試一下”或“驗證”。它會將驗收標準轉化爲可運行的檢查項，並生成 specs/validation.md。

安裝與啓用¶

安裝前請確保環境滿足依賴要求：
* Node.js >= 22
* @deepseek-ai/cordis (^4.0.1)

安裝命令如下：

dsh plugin --profile <name> add @rongyi7/dsh-spec

注：如果是通過 Git 安裝，倉庫必須包含 prepare 構建腳本。

典型用法¶

在 DSH 中按照以下步驟操作：

1. 定義需求：輸入“幫我做一個文件分享網站”。插件會創建 specs/ 目錄，並填充 requirements.md、design.md 和 tasks.md。
2. 執行實現：輸入“開始實現”。插件會按照 tasks.md 中的順序生成代碼。
3. 執行驗收：輸入“驗收”。插件會生成 specs/validation.md，用於對照驗收標準進行校驗。

適用場景與注意¶

該插件適合需要在開發前明確規格、希望保持單一數據源（Spec）的開發者。使用時請注意：
* 插件以當前 DSH 進程的權限運行。
* 安裝前建議查看源碼與許可證。
* 社區目錄（如 skillhub.cn）是獨立站點，與 DeepSeek 或幻方無官方從屬關係。

結語¶

Spec-Driven Development（SDD）讓智能體開發更可控。dsh-spec 通過維護 specs/ 目錄下的三個文件，實現了從需求到驗收的閉環。更多細節可查閱其 GitHub 倉庫。