跳转到内容
逍遥自在轩

Comet - 开源琅嬛阁

rpamis/comet

Comet: agent skill harness phase-guarded automation from idea to archive

—
22
1,479
158
github.com · rpamis/comet
AI 编程Agent工作流
官方主页 / 文档 在 GitHub 查看

项目介绍

Comet（@rpamis/comet）是面向 AI 编程场景的 Agent Skill 编排工具。它把 OpenSpec 的「做什么」（大纲、提案、Spec 生命周期与归档）与 Superpowers 的「怎么做」（技术设计、规划、执行与收尾）串成五阶段自动化流水线，并用阶段守卫脚本校验状态，避免代理仅凭口头确认就推进流程。

主入口 /comet 支持读取当前 Spec 状态并从中断处继续，适合跨会话的长任务开发。

核心特性

  • 五阶段流水线：从想法到归档，OpenSpec + Superpowers 自动衔接
  • 阶段守卫脚本，不依赖代理自述「已完成」
  • .comet.yaml 记录阶段、执行模式与验证结果，支持断点恢复
  • 可配置审查模式（off / standard / thorough）控制 Build/Verify 代码审查强度
  • 研究型示例：嵌套 Skill 触发、跨阶段自动交接与文档同步自动化

对用户价值

对日常用 Cursor、Claude Code 等 AI 编程工具的用户，Comet 把「写 Spec → 设计 → 实现 → 验证 → 归档」从反复提醒代理同步文档，变成可脚本化、可恢复的流程，减少会话中断后重新读文档、猜进度的 token 浪费。

对 Skill 作者而言，它也是可参考的实现：如何可靠触发嵌套 Skill、如何在阶段间自动交接，以及如何把脆弱流程从 Prompt 抽到可测试的 Shell 脚本里。

与替代方案

  • 相比单独使用 OpenSpec 或 Superpowers，Comet 提供二者协同的编排层与状态机。
  • 相比纯 Prompt 约定流程，阶段守卫脚本更可验证、可恢复。
  • 若团队不使用 Cursor/Superpowers 生态，接入成本较高，需评估 Skill 兼容性。

适应人群

  • 已在使用 OpenSpec 或 Superpowers，希望两者协同而非二选一的开发者。
  • 需要可中断、可恢复的 Spec 驱动开发流程的团队。
  • 想研究 Agent Skill 安装分发与阶段状态机设计的工具作者。

如何使用

前置条件

  • Node.js 20+、npm。
  • Bash 兼容终端（Windows 建议 Git Bash）。
  • 项目中已安装或计划安装 OpenSpec 与 Superpowers 相关 Skill。

安装方式

Terminal window
npm install -g @rpamis/comet

在项目根目录执行：

Terminal window
comet init

首次运行

在 AI 编程会话中输入 /comet 启动或恢复流程；Comet 会读取 .comet.yaml 与 OpenSpec 工件，从中断阶段继续。

验证是否成功

完成一个小需求的全流程后，检查各阶段守卫是否通过、Spec 是否归档，以及 .comet.yaml 状态与预期一致。

常见坑 / 注意事项

  • 审查模式与项目默认需在 init 后按 README 配置，避免 Verify 阶段过严或过松。
  • 首次接入建议在可回滚分支上跑通，再接入主仓库。
  • 平台差异（路径、Shell）请以 README 与 NEWS.md 为准；子命令细节需对照官方文档核实。