SAXEM1997/specpowers 预览 preview

SAXEM1997/specpowers

SpecPowers — SDD+TDD engineering methodology as a DeepSeek Harness (DSH) plugin and Claude Code skill group: 6 skills fusing OpenSpec spec-driven development with Superpowers TDD discipline into one Phase 0→4 workflow.

Project Overview项目介绍

specpowers is a dual-platform skill bundle targeting both DeepSeek Harness and Claude Code, blending the Fission-AI/OpenSpec specification-driven development workflow with obra/Superpowers' test-driven discipline into a Phase 0→4 engineering methodology with layered Gate reviews that guard against requirement drift and context rot. The repository ships DSH-native packaging including a package.json dsh.bundle.patch field, a cordis.patch.yml patch, and a lib/index.js provider that registers six SKILL.md files through ctx.skills, while Claude Code integration is delivered through a separate .claude-plugin/plugin.json manifest that references the same skills/ source tree. Installation on DSH is performed with the dedicated command npx @deepseek-ai/dsh plugin --profile web add github:SAXEM1997/specpowers (optionally pinned with #v1.0.0 for reproducibility), after which the user restarts the profile and confirms with dsh --profile web --dump-config. A Codex CLI landing path is reserved under .agents/skills/<name>/ but is explicitly noted as unverified, and plain npm install will not register anything into any DSH profile.

Typical usage begins by running openspec init --tools claude (or --tools codex) inside the target project so OpenSpec generates the openspec/ directory plus its own openspec-* skills and /opsx:* commands, and then layering Superpowers on top as the TDD foundation. With both installed, the specpowers entry skill performs decision-tree routing by scale (tiny / medium / complex / large) and dispatches to specpowers-design for Phase 0+1 brainstorming and OpenSpec conversion, specpowers-plan for Phase 2 writing-plans hand-off, specpowers-apply for Phase 3 subagent-driven TDD execution with Gate 3 review, specpowers-review for the cross-cutting two-tier critical/complete review system, and specpowers-archive for Phase 4 hard Gate validation and archival. The audience is engineering teams and solo developers who want a coding agent to enforce spec + test discipline instead of silently drifting off requirements.

Hard dependencies are OpenSpec CLI installed globally via npm install -g @fission-ai/openspec and the Superpowers skill bundle installed on DSH as superpowers-dsh (or on Claude Code as the superpowers plugin); eight upstream skills (brainstorming, writing-plans, subagent-driven-development, test-driven-development, systematic-debugging, requesting-code-review, verification-before-completion, finishing-a-development-branch) are required or the corresponding phases will not run. CodeGraph and Graphify are optional and only affect architectural understanding. The repository ships under MIT, with upstream attributions to obra/superpowers (MIT, © 2025 Jesse Vincent) and Fission-AI/OpenSpec (MIT, © 2024 OpenSpec Contributors) recorded in NOTICE. First-run caveats include running node scripts/verify-dsh-provider.mjs after any frontmatter parser changes (because DSH routes skills purely by description and the four supported scalar forms must be preserved), keeping .claude/ and .superpowers/ out of version control, and pinning releases with #v1.0.0 since unpinned installs resolve to the current main HEAD.

specpowers 是面向 DSH(DeepSeek Harness)与 Claude Code 的双平台技能组插件,核心能力是把 OpenSpec 的规范驱动开发与 Superpowers 的测试驱动纪律桥接成 Phase 0→4 的工程化开发方法论,通过逐层 Gate 审查防止需求偏离与上下文腐化。它以 DSH bundle 形式分发,在 DSH 中用 npx @deepseek-ai/dsh plugin --profile web add github:SAXEM1997/specpowers 安装并写入 package.json + cordis.patch.yml,由 lib/index.js 通过 ctx.skills 把 6 个 SKILL.md 注册进技能层;在 Claude Code 中通过 .claude-plugin/plugin.json 装载 skills。仓库预留 Codex CLI 承载路径但未做验证。

典型使用流程是:在目标项目运行 openspec init 生成规范目录与命令,再叠加 Superpowers 技能组作为 TDD 基础;之后由 specpowers 入口技能按规模路由,分别调用 design、plan、apply、review、archive 完成需求澄清→规划→subagent 驱动实现→多级审查→硬 Gate 验证归档。适用人群是需要在 AI 编码 agent 里推行规范+测试纪律、避免需求蔓延的工程团队和单人开发者。

硬依赖为 OpenSpec CLI(npm i -g @fission-ai/openspec)和 Superpowers 技能组(DSH 端装 superpowers-dsh、Claude 端装 superpowers),缺少 8 个上游技能时对应 Phase 无法执行;CodeGraph 与 Graphify 为可选。许可证 MIT,上游来自 obra/superpowers 与 Fission-AI/OpenSpec。首跑注意:必须用 dsh plugin add 而非 npm install 才能注册到 profile;版本可用 #v1.0.0 钉住。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

npx @deepseek-ai/dsh plugin --profile web add superpowers-dsh

把 SAXEM1997/specpowers 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

English | 简体中文

specpowers

specpowers

SDD + TDD 工程化开发方法论 — DeepSeek Harness 插件 + Claude Code 技能组

specpowers 融合 OpenSpec(规范驱动开发)与 Superpowers(测试驱动纪律),通过衔接指令集把两者桥接成完整的 Phase 0→4 开发工作流。它防止需求偏离(做了不需要的东西)与实现缺陷(需要的东西做错了),并通过全流程逐层审查 Gate 防止上下文腐化与产物质量下降。

flowchart LR
    classDef src fill:#ddf4ff,stroke:#0969da,stroke-width:2px,color:#0a3069
    classDef dsh fill:#ddf4ff,stroke:#0969da,stroke-width:2px,color:#0a3069
    classDef cc fill:#fff8c5,stroke:#9a6700,stroke-width:2px,color:#7d4e00
    classDef cx fill:#f6f8fa,stroke:#8c959f,stroke-width:2px,color:#57606a,stroke-dasharray:6 4

    SRC["skills/ — 双平台唯一技能真源<br/>6 个技能 · refs/ · scripts/"]:::src

    SRC ==> DSH["DeepSeek Harness"]:::dsh
    SRC ==> CC["Claude Code"]:::cc
    SRC -.->|预留 · 未验证| CX["Codex CLI"]:::cx

    DSH --> D["package.json · cordis.patch.yml<br/>lib/index.js → ctx.skills<br/>skill 工具 · 裸名寻址"]:::dsh
    CC --> C[".claude-plugin/plugin.json<br/>skills: ./skills<br/>Skill 工具 · 裸名 + 插件前缀回退"]:::cc
    CX --> X["目标承载路径<br/>.agents/skills/ · 每技能一目录"]:::cx

技能组架构

specpowers (入口 — 决策树 + 路由 + 状态机)
  ├── specpowers-design  Phase 0+1: 需求澄清 → OpenSpec 格式转换
  ├── specpowers-plan    Phase 2: OpenSpec → TDD plan 衔接
  ├── specpowers-apply   Phase 3: subagent-driven TDD 实现 + Gate 3 审查
  ├── specpowers-review  审查体系: 两级路由(关键/完整)/ 最终通读
  └── specpowers-archive Phase 4: 硬 Gate 链验证归档
技能 Phase 职责
specpowers 全局 决策模式判定(微小/中等/复杂/大规模)+ 路由 + 状态机
specpowers-design 0+1 brainstorming → OpenSpec 格式转换 + Gate 0/1
specpowers-plan 2 writing-plans 衔接 + Gate 2
specpowers-apply 3 subagent-driven TDD 逐 task 执行 + code-review + spec-compliance-check
specpowers-review 横切 两级路由(按轮数×规模自动判定:关键/完整审查)/ 防退化机制
specpowers-archive 4 全量测试 → openspec validate → archive → 完整性验证

安装

前置依赖

工具 用途 安装验证
DeepSeek Harness 或 Claude Code 运行环境 dsh --version / claude --version
superpowers-dsh(DSH)或 Superpowers(Claude Code) TDD 技能组(硬依赖) 见下方依赖安装步骤
OpenSpec CLI SDD 规范管理(硬依赖) openspec --version
CodeGraph(可选) 代码知识图谱 仓库根 .codegraph/ 目录 / MCP codegraph_explore
Graphify(可选) 多模态知识图谱(架构理解) /graphify 命令

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-compact-provider 下一个 Next dsh-ui-customizer →