# OpenSpec+Superpowers协作开发

前面有写过两篇文章单独介绍OpenSpec和Superpowers的使用方法，分别是 [[OpenSpec实现SDD开发模式]] 和 [[Superpowers给AI装上工程纪律]] 。但是当你装了这两个框架后，大概率会遇到下面这些问题：
- OpenSpec生成了规范文档，Superpowers的brainstorming又开始问需求，两个在重复劳动。
- Superpowers的TDD说“先写测试”，OpenSpec的tasks.md里面已经列好了实现步骤，AI该听谁的。

用了一段时间你会发现：OpenSpec管好了“做什么”，但AI实现的时候还是乱写代码；Superpowers管好了“怎么做”，但做出来的东西和需求对不上。

## Comet：五阶段自动串联

OpenSpec 管 WHAT，Superpowers 管 HOW，但两者不会自动衔接——在 `/opsx:apply` 执行时，Superpowers 的 TDD 等 skills 不会自动触发，需要你手动在 CLAUDE.md 里加规则。

Comet 解决的就是这个问题。它是一个中国开发者做的开源项目，把两个工具串成一条五阶段自动化流水线。

GitHub地址：github.com/rpamis/comet

**安装（三个工具一次全装）：**

```
npm install -g @rpamis/comet
cd your-project
comet init
```

`comet init` 会自动检测你已有的 AI 平台配置，询问安装范围（项目级或全局），选语言（支持中文），然后自动安装 OpenSpec skills、Superpowers skills 和 Comet 自身的 skills，最后创建工作目录。支持 28 个 AI 编程平台，Cursor、Windsurf、通义灵码、CodeBuddy 都在列，装一次全覆盖。

**五阶段工作流：**

```
/comet-open → /comet-design → /comet-build → /comet-verify → /comet-archive
  OpenSpec      Superpowers    Superpowers      两者            OpenSpec
```

|阶段|命令|产出|
|---|---|---|
|1. 开启变更|/comet-open|proposal.md, design.md, tasks.md|
|2. 深度设计|/comet-design|Design Doc, delta spec|
|3. 计划构建|/comet-build|实施计划, 代码提交|
|4. 验证收尾|/comet-verify|验证报告, 分支处理|
|5. 归档|/comet-archive|delta 合并进主 spec|

每个阶段退出前都有守卫脚本验证条件，不满足会输出 `[HARD STOP]` 并告诉你下一步怎么做，防止 AI 假装完成直接跳阶段。

**状态文件：**

Comet 用两个解耦的 YAML 记录进度：`.openspec.yaml`（OpenSpec 管）和 `.comet.yaml`（Comet 管）。

```
# .comet.yaml 示例
workflow: full
phase: build
build_mode: subagent-driven-development
isolation: branch
verify_result: pending
archived: false
```

**中途断开不怕，直接续接：**

```
/comet continue
# 自动读取 .comet.yaml，识别当前阶段，从断点继续
```

**两个快捷路径，不用走完整流程：**

```
/comet-hotfix  # 跳过 brainstorming，快速修 bug
/comet-tweak   # 跳过 brainstorming 和完整计划，小改动用
```

**项目目录结构（装完之后长这样）：**

```
your-project/
├── .claude/skills/
│   ├── comet/SKILL.md
│   ├── comet-open/SKILL.md
│   ├── comet-design/SKILL.md
│   ├── comet-build/SKILL.md
│   ├── comet-verify/SKILL.md
│   ├── comet-archive/SKILL.md
│   ├── openspec-*/SKILL.md
│   └── brainstorming/SKILL.md
├── openspec/
│   └── changes/
│       └── your-feature/
│           ├── .openspec.yaml
│           ├── .comet.yaml
│           ├── proposal.md
│           ├── design.md
│           └── tasks.md
└── docs/superpowers/
    ├── specs/       # Design 文档
    └── plans/       # 实施计划
```

---

## 怎么选，怎么上手

三个工具不是必须一起用，按需叠加就好。

**推荐顺序：**
- 第一步，先安装 Superpowers。一行命令，装完立刻有效果，零学习成本，任何用 Claude Code 的人都值得装。
- 第二步，项目复杂起来之后，加 OpenSpec。需要需求可追溯、多人协作、长期迭代的时候再引入。
- 第三步，觉得手动衔接两者麻烦，上 Comet，一键把三个工具全装好，五阶段流水线自动跑。

**快速参考：**

|工具|安装命令|GitHub|
|---|---|---|
|Superpowers|`/plugin install superpowers@claude-plugins-official`|obra/superpowers|
|OpenSpec|`npm install -g @fission-ai/openspec`|Fission-AI/OpenSpec|
|Comet（含前两者）|`npm install -g @rpamis/comet && comet init`|rpamis/comet|

赶快去试试吧！期待你回来留言反馈！





---

> 作者: XiongNeng  
> URL: https://xiongneng.me/posts/ai/openspec-superpowers-comet/