前言¶

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 目录