前言¶

DeepSeek Harness 插件與 Claude Code 技能組，融合 OpenSpec（規範驅動開發）與 Superpowers（測試驅動紀律），通過銜接指令集將兩者橋接成完整的 Phase 0→4 開發工作流。它防止需求偏離（做了不需要的東西）與實現缺陷（需要的東西做錯了），並通過全流程逐層審查 Gate 防止上下文腐化與產物質量下降。

核心功能¶

該插件基於決策樹、路由與狀態機設計，提供以下核心能力：

• 技能組架構：包含 6 個核心技能與兩級審查體系。
  • specpowers：全局入口，負責決策模式判定（微小/中等/複雜/大規模）。
  • specpowers-design：Phase 0+1，負責需求澄清與 OpenSpec 格式轉換。
  • specpowers-plan：Phase 2，銜接 OpenSpec 與 TDD plan。
  • specpowers-apply：Phase 3，執行 subagent-driven TDD 實現。
  • specpowers-review：橫切審查，執行兩級路由（關鍵/完整）。
  • specpowers-archive：Phase 4，硬 Gate 鏈驗證歸檔。
• 審查體系：兩級路由（按輪數×規模自動判定：關鍵/完整審查），支持多模型漸進式審查與 UltraReview（6 Agent 團隊審查）。

安裝與依賴¶

前置依賴¶

運行該插件需要以下工具作爲硬依賴：

安裝步驟¶

在任意目錄執行以下命令安裝插件：

npx @deepseek-ai/dsh plugin --profile web add github:SAXEM1997/specpowers

若需釘住版本（推薦生產使用）：

npx @deepseek-ai/dsh plugin --profile web add github:SAXEM1997/specpowers#v1.0.0

安裝完成後，必須重啓 profile（停止並重新運行 dsh web 或 npx @deepseek-ai/dsh web）。

依賴安裝¶

specpowers 自身只提供工作流技能，必須單獨安裝以下依賴：

1. OpenSpec CLI（必需）：

    npm install -g @fission-ai/openspec
    openspec init --tools claude  # Claude Code 用戶
    openspec init --tools codex   # Codex 用戶

2. Superpowers 技能組（必需）：

   • DSH 用戶：npx @deepseek-ai/dsh plugin --profile web add superpowers-dsh
   • Claude Code 用戶：安裝 superpowers 插件

3. 上游技能：specpowers 硬依賴以下 8 個上游技能，缺失時對應 Phase 無法執行：

   • brainstorming
   • writing-plans
   • subagent-driven-development
   • test-driven-development
   • systematic-debugging
   • requesting-code-review
   • verification-before-completion
   • finishing-a-development-branch

注意：必須使用 dsh plugin 形式安裝。直接 npm install specpowers 只會將包作爲普通庫安裝，不會註冊進 profile，技能永遠不會被加載。

使用方式¶

觸發方式¶

在對話中輸入以下任意指令即可啓動：

• “啓動 specpowers 流程”
• “用 SDD+TDD 開發這個功能”
• “開始新功能的 specpowers 工作流”

技能調用¶

• DeepSeek Harness：直接加載入口技能

    skill(name: "specpowers")

• Claude Code：使用斜槓命令或工具調用

    /specpowers

Phase 工作流¶

插件根據文件數與複雜度自動判定執行模式（微小/中等/複雜/大規模），並自動路由至對應的 Phase 流程：

1. Phase 0+1（設計與轉換）：通過 specpowers-design 進行需求澄清，生成 OpenSpec 格式文檔，並通過 Gate 0/1 審查。
2. Phase 2（銜接）：通過 specpowers-plan 將 OpenSpec 轉換爲 TDD plan，通過 Gate 2 審查。
3. Phase 3（實現）：通過 specpowers-apply 執行 subagent-driven TDD，包含 RED-GREEN-REFACTOR-COMMIT 流程與代碼合規性檢查，通過 Gate 3 審查。
4. Phase 4（歸檔）：通過 specpowers-archive 進行全量測試、openspec 驗證與歸檔，通過完整性驗證 Gate。

平臺適配與架構¶

插件同時支持 DeepSeek Harness 與 Claude Code 兩個平臺，但技能註冊機制略有不同：

• DeepSeek Harness：通過 lib/index.js provider 註冊進 host 技能註冊表。
• Claude Code：通過 .claude-plugin/plugin.json 配置，支持裸名或命名空間回退。

技能源碼位於 skills/ 目錄，由 DSH 或 Claude Code 加載執行。

項目地址：
* GitHub
* SkillHub 目錄