Comet开源项目20天破1.2k星,组合OpenSpec与Superpowers优化AI工作流
速览
Comet是一个基于OpenSpec和Superpowers的开源Skills项目,旨在解决单一工具在执行能力和全生命周期管理上的不足。该项目在20天内获得1.2k Star,近期更新引入了CodeGraph语义索引、上下文压缩、Token优化套件及长程任务防漂移机制。这些改进显著降低了Token消耗,提升了Agent在多阶段自动触发和代码解析方面的效率与稳定性。
AI 深度解读
背景
在 AI 辅助开发领域,OpenSpec 与 Superpowers 是两款备受关注的开源技能(Skills)。OpenSpec 擅长规范化的需求定义与规格说明书(Spec)管理,而 Superpowers 则在执行力和自动化方面表现优异。然而,在实际工作流中,单一技能往往存在局限:OpenSpec 的执行能力相对较弱,难以独立完成复杂的代码构建任务;而 Superpowers 虽然执行力强,但对 Spec 全生命周期的管理能力不足,缺乏对需求变更、版本归档等流程的精细化控制。
为了解决这一痛点,开发者 rpamis 推出了开源项目 Comet。该项目并非简单地将两者并列,而是通过“双星开发工作流”将 OpenSpec 与 Superpowers 进行深度串联与组合。Comet 旨在从创意构思到最终归档,提供一条自动化、标准化的命令式工作流。该项目在发布后迅速获得社区认可,在 20 天内 Star 数突破 1.2k,并在 LINUX DO 社区及 B 站等平台进行了开源推广。
核心内容
Comet 的核心价值在于通过组合现有 Skill 来解决单一工具的能力短板,同时引入了多项创新机制以提升长程任务执行的稳定性、效率及用户体验。以下是 2026-06-09 版本(v0.3.7)的核心更新与功能详解:
1. 语义代码索引与 Token 优化
- CodeGraph 接入:
comet init与comet update命令现支持一键安装 CodeGraph,为 Agent 提供专业的语义代码索引能力。实测数据显示,接入后工具调用次数减少约 58%,整体使用成本降低约 16%,显著提升了代码解析与任务执行效率。 - Token 优化套件:推出了 6 项独立的 Token 优化能力:
- TDD Skill 加载优化:每 10 个任务工作流可节省约 44K tokens。
- Brainstorming 检查点压缩:生成压缩恢复点,避免任务决策数据丢失。
- Plan 子代理调度卸载:释放主会话上下文,降低资源占用。
- Verify Skill 内容去重:剔除冗余技能内容,精简会话信息。
- tasks.md 增量扫描:以 grep 增量读取替代全文读取,提升效率。
- Hash 按需读取机制:跳过未变更的 OpenSpec 制品,减少无效读取。
2. 上下文压缩与长程任务管理
- 新增上下文压缩能力(Beta):在 Design 到 Build 阶段交接时引入 Spec 投影压缩功能。开启后可有效降低 Build 阶段的 Token 输入量,单次大型任务可减少 25–30% 输入 Token,极致场景下绝对节省 Token 可达 15000。该功能采用全文投影运行机制,原生支持中英文 Spec 文档,无需依赖固定需求关键词。
- 主动上下文压缩机制升级:在 Design 阶段新增 Step 1e 主动压缩逻辑。在头脑风暴完成、设计文档生成前,Agent 会主动触发平台原生上下文压缩能力(如 Claude Code 的 compact 功能),主动释放 Spec 读取和头脑风暴过程占用的上下文空间。压缩完成后自动重载交接文件。对于不支持程序化触发的平台,会暂停任务并提示用户手动操作。
- 长程任务防漂移守护机制:针对长上下文会话中 Agent 易遗忘当前阶段或在错误阶段(如 open/design)误写源码的问题,新增双层防护:
- Rule:通过
.claude/rules/comet-phase-guard.md每轮会话注入阶段感知规则、技能调用规范等,全平台通用生效。 - Hook:依托
comet-hook-guard.sh前置钩子,在 open、design、archive 阶段直接拦截违规文件写入操作,仅允许指定路径文件修改(适配支持 Hook 能力的平台)。
- Rule:通过
3. 自动化流转与配置管理
- 可控自动流转(Auto Transition):新增项目级或变更级的
auto_transition配置项。开启后,任务阶段结束会自动调用下一阶段技能;关闭后则暂停等待用户手动触发,满足人工审查需求。默认开启(全自动模式)。配置优先级分层清晰:环境变量COMET_AUTO_TRANSITION> 项目级.comet/config.yaml> 单次变更级.comet.yaml。 - 轻量化状态机与断点恢复:项目实现了嵌套 Skill 的稳定触发机制,不修改底层 OpenSpec 和 Superpowers 源码,而是通过轻量化状态机机制和长程任务断点恢复(省 Token 版)来串联流程。
4. 工作流体验与兼容性优化
- TDD 模式自定义:
.comet.yaml新增tdd_mode配置,支持tdd(强制测试驱动)和direct(直接开发)两种模式。 - 大型 PRD 分流预检:
/comet-open指令新增大型 PRD 预处理能力,可自动拆分超大需求为多个独立 Comet 变更,适配复杂项目开发场景。 - 验证闭环强化:
- 连续 3 次验证失败后自动暂停,强制交由用户决策,杜绝无限重试。
/comet-verify执行前强制加载前置验证技能,要求所有验证结果基于真实证据。
- 归档容错优化:
/comet-archive归档前新增用户确认环节。若用户拒绝归档,可通过archive-reopen回退至验证阶段,无需手动修改配置文件。 - 系统化强制调试:Build、hotfix 阶段出现程序崩溃或测试失败时,强制加载
systematic-debugging技能,确保定位根因后再修复。 - 平台兼容性:移除硬编码用户提问逻辑,Codex 等非 Claude Code 平台可调用自身原生确认机制,实现全平台适配统一。
- 其他体验升级:支持语言跟随(Spec 产出文档跟随用户语言)、分支选项优化(支持用户输入分支模式)、Review 优化(支持执行计划后派发 reviewer)等。
关键要点
- 组合优于单一:Comet 的核心逻辑不是重写 OpenSpec 或 Superpowers,而是通过工作流编排解决 OpenSpec 执行力弱和 Superpowers 生命周期管理弱的互补性缺陷。
- 自动化与可控性的平衡:通过
auto_transition配置,用户可以在“全自动推进”和“人工审查介入”之间灵活切换,既保证了效率,又保留了关键节点的控制权。 - Token 效率极致优化:通过 CodeGraph 语义索引、主动上下文压缩、增量扫描及去重机制,大幅降低了长程任务中的 Token 消耗(如大型任务节省 25-30% 输入 Token),解决了 LLM 上下文窗口限制和高成本问题。
- 稳定性增强:引入“防漂移守护机制”(Rule + Hook),有效防止 Agent 在长会话中迷失阶段或违规操作,提升了复杂工作流的可靠性。
- 全平台适配:通过移除硬编码逻辑和适配原生确认机制,Comet 不仅限于 Claude Code,还能兼容 Codex 等其他 AI 编程平台,扩大了适用范围。
- 嵌套 Skill 触发机制:解决了多 Skill 组合时依赖手动输入斜杠命令的麻烦,实现了多阶段自动触发,提升了工作流的流畅度。
意义与影响
Comet 的出现标志着 AI 辅助开发工作流从“单点工具使用”向“系统化工程编排”的转变。
- 标准化 Spec 驱动开发:通过将 OpenSpec 的规范化能力与 Superpowers 的执行能力结合,Comet 为“规格说明书驱动开发”(Spec-Driven Development)提供了一套可落地的自动化范式,有助于提升软件开发的规范性和可追溯性。
- 降低长程任务复杂度:通过断点恢复、上下文压缩和防漂移机制,Comet 有效缓解了 LLM 在处理长程、多步骤任务时的“遗忘”和“幻觉”问题,使得 AI 能够更稳定地承担
