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

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

1
2
3

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

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

五阶段工作流：

1
2

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

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

状态文件：

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

1
2
3
4
5
6
7

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

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

1
2

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

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

1
2

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

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

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，一键把三个工具全装好，五阶段流水线自动跑。

快速参考：

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