Comet Skill 技能

技能简介

Comet 是一款面向 AI 编程的长任务工作流与 Skill 平台，由 rpamis 团队开发并开源（MIT 协议）。它把「需求确认 → 计划 → 实现 → 测试 → 验收 → 归档」这条完整的软件交付链路，做成可断点续跑、可恢复的自动化流程，并以 Skill 的形式直接装进 Claude Code、Codex 等主流编程 Agent。Comet 让 AI 编程从「一次性对话」升级为「可治理的工程项目」——任务状态留在项目里，中断后能续，换会话不丢进度。

核心能力

• 双工作流引擎：Native 工作流面向强模型，需求确认后由 Agent 自主规划、实现、测试与评审；Classic 工作流则保留完整的 OpenSpec + Superpowers 五阶段方法学，适合需要强约束的复杂任务。
• 可续跑的长任务内核：任务状态、阶段、验证结果、归档状态都记录在项目的 .comet.yaml 中，中断或换会话后可精确恢复，无需重读文档猜进度。
• 多 Agent 并行交付（Supervisor Changes）：把一个目标拆成带依赖关系的子任务 DAG，交给多个独立 Codex 会话或 Claude Code Agent Teams 在隔离 worktree 中并行实现与验证，最后按依赖顺序集成。
• 个人记忆与项目知识管理：跨任务保留协作偏好与可复用经验，并按当前任务渐进式供给上下文，可随时查看、纠正、遗忘或暂停。
• Skill 创作、分发与评估：用 /comet-any 组合任意 Skill 打包分发；用 comet eval 配合 Rubric、Pass@k、Pass^k 与 LangSmith 做科学化评估，让 Skill 进化基于证据而非直觉。
• 统一三栏 Dashboard：浏览器中查看 Native/Classic 进度、Git worktree、验收结果与归档，并管理记忆、知识与插件设置。
• 跨平台执行与恢复：纯 Node.js 运行时，Windows / macOS / Linux 通用，无需 Bash 或 WSL。

安装配置

1. 环境要求：Node.js 22.16+（22.x）或 24+，npm/npx，以及 Git。
2. 全局安装：执行 npm install -g @rpamis/comet。
3. 初始化项目：进入目标项目目录，运行 comet init，交互式选择 Native、Classic 或两者都装；项目配置统一落在 .comet/config.yaml。
4. 非交互初始化：comet init --workflow classic 或 comet init --workflow both。
5. 配置更新：comet update 会补充新增的托管默认值，同时保留用户自定义值与未知扩展。

使用步骤

1. 在项目中完成 comet init 后，在宿主 Agent（如 Claude Code）中调用 /comet，它会读取 .comet/config.yaml 并确定性地转发到 /comet-native 或 /comet-classic。
2. 用 /comet-native 进入 Native 工作流，让强模型自主完成规划、实现、测试与评审；用户可读产物默认落在 docs/comet/ 下。
3. 对于复杂需求，使用 Supervisor Change 将目标拆成子任务 DAG，派发给多个 Agent 在隔离 worktree 中执行与验证。
4. 用 /comet-any 组合任意 Skill 并打包成可分发的 Bundle，一条命令分发到各编程平台。
5. 用 comet eval 对任意 Skill 做 Rubric、Pass@k、Pass^k 评估，依据结果迭代改进。
6. 归档阶段：comet 先返回单条 dry-run 续跑命令，确认后由 Runtime 主导归档提交。

适用场景

• 跨天甚至跨周的中大型功能开发，需要断点续跑与状态追踪。
• 需要完整阶段性方法学（规格 / TDD / 评审）约束的高风险任务。
• 可拆分为多个独立交付物、适合多 Agent 并行实现的复杂需求。
• 团队希望统一 Skill 的创作、分发与科学评估标准。
• 需要在 Windows / macOS / Linux 上统一执行、无需 WSL 的工程环境。

适用人群

• 使用 Claude Code、Codex 等编程 Agent 的开发者与工程团队；
• 需要把 AI 编程流程工程化、可审计化的技术负责人；
• 构建与分发 Agent Skill 的 Skill 作者与平台维护者。

工作原理

Comet 以配置驱动的共享入口 /comet 为核心，先读取项目 .comet/config.yaml 再确定性转发到对应工作流，绝不按任务大小猜测或跨工作流混用变更与目录。Native 工作流仅依赖 Comet 自身运行时，用详细任务简报、完整目标规格、阶段检查与可恢复归档来约束交付结果，而把规划、实现、测试、评审的方法交给模型；Classic 工作流则把 OpenSpec 的变更/规格产物与 Superpowers 的设计/计划文档链接起来，并在每个变更的 .comet.yaml 中记录阶段、执行模式、验证结果与归档状态，配合 comet-guard.mjs、comet-yaml-validate.mjs、comet-state.mjs 等脚本做阶段门禁，把文档同步从「提醒」变成「自动化」。据官方对齐实验（16 任务、每处理 48 次运行、41 组双通过样本），Native 相比 Classic 总 token 减少 76.8%、Agent 轮次减少 57.4%、耗时减少 47.4%；全样本下 Native 的 pass^3 达 87.5%（+12.5 个百分点），两者 pass@3 均为 100%。

官方链接

• npm 包：https://www.npmjs.com/package/@rpamis/comet
• 官方文档：https://docs.comet.rpamis.com/
• GitHub 仓库：https://github.com/rpamis/comet