【开源】已在20天时间内破1.2kstar~ Comet: 如何组合高Star Spec项目(OpenSpec+Superpowers)做出更好用的Spec Skills

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

• 我的帖子已经打上 开源推广 标签： 是


• 我的开源项目完整开源，无未开源部分： 是


• 我的开源项目已链接认可 LINUX DO 社区： 是


• 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是


• 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

佬友们，我最近基于OpenSpec和Superpowers做了一个开源Skills

开源链接如下

Comet: OpenSpec + Superpowers 双星开发工作流 — 从创意到归档，一条命令

另外还有B站视频介绍~ ^-^

开源！Comet: 基于OpenSpec和Superpowers怎么做出更好用的自动Spec Skills

核心主要是解决OpenSpec执行能力不够强，Superpowers对Spec全生命周期管理能力不够强的问题，只组合这两个Skill做串联流程

在这个项目可以学到：

1. 嵌套Skill如何稳定触发，比如项目里面依赖的OpenSpec和Superpowers，本质不会对他们进行修改


2. 轻量化状态机机制、长程任务断点恢复(省token版)


3. 如何让组合Skill多阶段自动触发，而不是靠人工介入(因为现阶段想要组合两个Spec功能，还得靠自己手动敲斜杠命令，怪麻烦的)

等等内容

希望佬们多多点赞star，欢迎参与一起贡献~，学AI，上L站! ^-^

2026-06-09-0.3.7更新

一、CodeGraph 语义代码索引能力接入

comet init与comet update命令现已支持一键安装 CodeGraph，为Agent提供专业的语义代码索引能力。自动完成CLI安装与项目索引初始化工作。官方实测数据显示，接入该能力后，工具调用次数减少约58%，整体使用成本降低约16%，大幅提升代码解析与任务执行效率。

二、新增上下文压缩能力（Beta）

新增Design到Build阶段交接的spec投影压缩功能，开启后可有效降低Build阶段的Token输入量，单次大型任务可减少25–30%输入Token，极致场景下绝对节省Token可达15000。Beta版本采用全文投影运行机制，原生支持中英文Spec文档，无需依赖固定需求关键词，适配性更强。

开启方式：在 项目级.comet.yaml配置文件中设置 context_compression: beta

详细使用说明和Benchmark可参考文档：comet/docs/CONTEXT-COMPRESSION.md at master · rpamis/comet · GitHub

三、主动上下文压缩机制升级

在Design阶段新增Step 1e主动压缩逻辑，在头脑风暴完成、设计文档生成前，Agent会主动触发平台原生上下文压缩能力（如Claude Code的compact功能），主动释放Spec读取、头脑风暴过程占用的上下文空间，为后续Build阶段预留充足上下文窗口。压缩完成后将自动重载交接文件，继续推进任务执行。对于不支持程序化触发压缩的平台，会主动暂停任务并提示用户手动完成压缩操作。

四、可控自动流转（Auto Transition）功能上线

新增 项目级/change级auto_transition配置项，用于控制阶段推进逻辑：开启后可自动调用下一阶段技能，关闭后任务阶段结束会暂停，等待用户手动触发下一阶段，满足用户人工审查、精准把控任务流程的需求。功能默认开启（true全自动模式）。

配置优先级分层清晰：环境变量 COMET_AUTO_TRANSITION > 项目级 .comet/config.yaml > 单次变更级 .comet.yaml，全面适配full、hotfix、tweak全类型工作流。

详细规则可参考文档：comet/docs/AUTO-TRANSITION.md at master · rpamis/comet · GitHub

五、Token 优化套件

推出6项独立Token优化能力，全方位缩减Token消耗、优化会话性能：

优化项—— 节省/优化效果：

• TDD skill 单次加载优化：每10个任务工作流可节省约44K tokens


• Brainstorming 检查点压缩：生成压缩恢复点，避免任务决策数据丢失


• Plan子代理调度卸载：释放主会话上下文，降低资源占用


• Verify skill 内容去重：剔除冗余技能内容，精简会话信息


• tasks.md 增量扫描：以grep增量读取替代全文读取，提升效率


• Hash按需读取机制：跳过未变更的OpenSpec制品，减少无效读取

六、新增更健壮的长程任务防漂移阶段守护机制

针对长上下文会话中，Agent易遗忘当前阶段、在open/design阶段误写源码的问题，新增双层防护机制，严格规范任务执行流程：

• Rule：通过 .claude/rules/comet-phase-guard.md每轮会话注入阶段感知规则、技能调用规范、脚本执行及上下文压缩恢复要求，全平台通用生效


• Hook：依托 comet-hook-guard.sh前置钩子，在open、design、archive阶段直接拦截违规文件写入操作，仅允许openspec、docs/superpowers、.claude、.comet指定路径文件修改，仅适配支持Hook能力的平台

七、多项功能优化与体验升级

• TDD模式自定义：.comet.yaml 新增 tdd_mode 配置，支持 tdd（强制测试驱动）、direct（直接开发）两种模式，用户可自主选择Build阶段开发模式


• 子代理调度校验：新增 subagent_dispatch 配置，确保子代理开发模式仅在平台真实支持后台调度时，才会结束Build阶段，避免任务流程异常


• 大型PRD分流预检：/comet-open 指令新增大型PRD预处理能力，可自动拆分超大需求为多个独立Comet变更，适配复杂项目开发场景


• 验证重试防死循环：连续3次验证失败后自动暂停，强制交由用户决策，彻底杜绝无限重试问题


• 归档容错优化：/comet-archive归档前新增用户确认环节，用户拒绝归档后，可通过 archive-reopen 回退至验证阶段调整内容，无需手动修改配置文件


• 系统化强制调试：Build、hotfix阶段出现程序崩溃、测试失败时，将强制加载systematic-debugging技能，确保定位根因后再执行修复，提升问题修复质量


• 验证闭环强化：/comet-verify执行前强制加载前置验证技能，要求所有验证结果均基于真实证据，杜绝虚假完成状态


• 变更阈值优化：代码变更超50%范围时，新增「当前变更内继续完成」选项，不再强制拆分任务，灵活适配大规模迭代场景


• 平台兼容性优化：移除硬编码用户提问逻辑，Codex等非Claude Code平台可调用自身原生确认机制，实现全平台适配统一


• 分支选项优化：开发时分支模式支持用户输入


• 语言跟随：支持Spec产出文档跟随用户语言


• review优化：支持执行计划后派发reviewer
  
  完整内容请查看release changelog