377bf86076
- CLAUDE.md 精简为入口：保留铁律+约定，移除内联重复，新增文档地图 - openspec-superpowers-bridge/SKILL.md 成为工作流五步唯一权威源 - docs/architecture.md 移除重复的阶段映射表，改为引用 bridge Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
| name | description |
|---|---|
| openspec-superpowers-bridge | Use when starting feature or change work to route the request through the right Superpowers process skill and decide whether an openspec change is warranted before implementation. |
openspec ↔ superpowers 桥接
本项目用 openspec 追踪需求与变更，用 superpowers 过程技能驱动开发。此技能说明两者
如何衔接，避免「该走 change 还是直接写」的失序。openspec 的具体命令与步骤，交由
.claude/skills/openspec-*（propose/apply-change/archive-change/…）与 /opsx:* 命令
负责；本技能只负责过程编排。
工作流五步（唯一权威）
任何功能/变更请求，按以下流程推进：
- brainstorming 分类：用
superpowers:brainstorming将请求分为 spike / bounded / architectural。 - architectural → 开 change：走
/opsx:propose（proposal → specs → design → tasks）， 配合.claude/skills/openspec-*技能。 - 写计划：用
superpowers:writing-plans生成实施计划（存docs/superpowers/plans/）。 - 应用：按
/opsx:apply落地任务，执行期遵循 TDD、systematic-debugging、 requesting-code-review、verification-before-completion。 - 归档：
/opsx:archive把增量 spec 合并回主 spec。
何时开 change（而非直接写）
- 任何功能/变更请求，先用
superpowers:brainstorming分类为 spike / bounded / architectural。 - architectural（新子系统、跨接口重构、多文件新功能）→ 开 openspec change，
走
/opsx:propose：proposal → specs → design → tasks。 - bounded → 走了 in-chat 短设计即可，不强开 change。
- spike → 只出答案，不开 change。
openspec 阶段 → superpowers 技能
| openspec 阶段 | superpowers 技能 |
|---|---|
| proposal / specs / design | superpowers:brainstorming（先）→ superpowers:writing-plans |
| tasks 编排与执行 | superpowers:writing-plans 产物 → superpowers:executing-plans 或 superpowers:subagent-driven-development |
| 实现 | superpowers:test-driven-development、superpowers:systematic-debugging |
| 收尾 | superpowers:requesting-code-review、superpowers:verification-before-completion、superpowers:finishing-a-development-branch |
归档
change 实现、评审、验证完成后：/opsx:archive（或 openspec archive <change>）把增量
spec 合并回主 spec。未归档的 change 属于进行中工作。