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 钉住。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:specpowers(SAXEM1997/specpowers)
仓库:https://github.com/SAXEM1997/specpowers
本站详情页:https://www.yhbd.top/plugins/saxem1997-specpowers/
本站登记:类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 2 · 最近提交 2026-09-21 · 主语言 JavaScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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
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 →
tt-a1i/archify
ZSeven-W/openpencil
omdsh-dev/dsh_workflow
zenx0x/allinluna
CheshireJCat/blender
limuyang2/agent-team
GZX2211/dsh-Visual-Workflow
sailoumili/novel-writer