377bf86076
- CLAUDE.md 精简为入口：保留铁律+约定，移除内联重复，新增文档地图 - openspec-superpowers-bridge/SKILL.md 成为工作流五步唯一权威源 - docs/architecture.md 移除重复的阶段映射表，改为引用 bridge Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
46 lines
2.5 KiB
Markdown
46 lines
2.5 KiB
Markdown
---
|
||
name: openspec-superpowers-bridge
|
||
description: 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:*` 命令
|
||
负责；本技能只负责过程编排。
|
||
|
||
## 工作流五步（唯一权威）
|
||
|
||
任何功能/变更请求，按以下流程推进：
|
||
|
||
1. **brainstorming 分类**：用 `superpowers:brainstorming` 将请求分为 spike / bounded / architectural。
|
||
2. **architectural → 开 change**：走 `/opsx:propose`（proposal → specs → design → tasks），
|
||
配合 `.claude/skills/openspec-*` 技能。
|
||
3. **写计划**：用 `superpowers:writing-plans` 生成实施计划（存 `docs/superpowers/plans/`）。
|
||
4. **应用**：按 `/opsx:apply` 落地任务，执行期遵循 TDD、systematic-debugging、
|
||
requesting-code-review、verification-before-completion。
|
||
5. **归档**：`/opsx:archive` 把增量 spec 合并回主 spec。
|
||
|
||
## 何时开 change（而非直接写）
|
||
|
||
1. 任何功能/变更请求，先用 `superpowers:brainstorming` 分类为 spike / bounded / architectural。
|
||
2. **architectural**（新子系统、跨接口重构、多文件新功能）→ 开 openspec change，
|
||
走 `/opsx:propose`：proposal → specs → design → tasks。
|
||
3. **bounded** → 走了 in-chat 短设计即可，不强开 change。
|
||
4. **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 属于进行中工作。
|