Comet快速上手教程:5分钟让AI编码不再跑偏,只需记住3个命令
【免费下载链接】cometComet: agent skill harness for turning ideas into evaluated workflows项目地址: https://gitcode.com/rpamis/comet
刚接触Comet 快速上手时,新手最怕的就是记不住一堆 AI 编码工具命令。这篇 Comet 新手教程会带你 5 分钟搞定安装,并只记住3 个核心命令,让 AI 编码 Agent 从需求到归档全程不跑偏。
Comet 是一个面向编码场景的Agent Skill 工作流与评估平台,口号是"把想法变成可评估的工作流"。你可以把它理解为给 AI 编码 Agent 套上的一条"轨道":AI 负责写代码、跑测试,而 Comet 负责记录状态、做阶段检查、验证验收,任务中途断了也能随时恢复。项目定位详见 README-zh.md。
为什么 AI 编码会"跑偏"?
🤖 用 AI 写代码时,你可能遇到过这些情况:
- Agent 干到一半"忘记"了最初的需求细节;
- 说"完成了",实际测试没跑、文档没更新;
- 会话一断,下次又要从头猜进度;
- 自己写的 Skill 好不好用,全凭感觉。
Comet 的解法是:把"想法 → 规格 → 实现 → 验证 → 归档"沉淀成一条可恢复的工作流,关键节点由脚本和状态机把关,而不是听 Agent 口头汇报。
第0步:5分钟安装步骤
Comet 要求Node.js 22.16+(或 24+)、npm/npx 和 Git。全局安装只需一行:
npm install -g @rpamis/comet然后进入你的项目目录执行初始化:
cd your-project comet initcomet init会交互式引导你选择工作流:
| 选项 | 适用场景 |
|---|---|
--workflow native | 强模型(Claude、GPT 等),AI 自主规划、实现、测试、评审 |
--workflow classic | 需要完整"规格 → 设计 → 计划 → 验证 → 归档"五阶段强约束 |
--workflow both | 两套都装,/comet默认走 Native |
它会自动安装 OpenSpec 与 Superpowers 技能包,并在.comet/config.yaml生成带中文注释的配置。初始化过程和可用命令一览如下图所示:
记住3个命令,覆盖90%场景
官方给出的记忆法非常省心:2 个技能 + 1 个命令,编码、创作、评估全覆盖。
1️⃣ /comet:进入项目工作流
在任意宿主平台(Claude Code、Codex、Cursor 等 37 个平台都支持)里输入:
/comet它就是整个项目的统一入口:读取.comet/config.yaml,确定性地转发到 Native 或 Classic 工作流。AI 会自动识别当前变更(change)所处阶段,自动触发对应的核心技能,你只在关键节点做决策。
跑起来之后,你可以随时用一条命令查看进度:
comet status它会列出进行中的变更、当前阶段、验证失败次数和下一步建议。如果想用浏览器统一查看所有变更、Git worktree 和验收结果,comet dashboard会打开三栏式面板:
对于复杂需求,Native 还支持Supervisor Change:把一个大目标拆成带依赖的子变更,让多个 Agent 会话在隔离的 worktree 中并行实现、验证,再按依赖顺序合并。多个 Codex 会话协同开发的样子如下:
2️⃣ /comet-any:组合任意Skill
想把自己的经验和常用技能沉淀成可复用的 Skill?输入:
/comet-any用自然语言描述你的 Skill 偏好即可,稳定性相关的 hook、规则、脚本和引用文件全部由 Agent 帮你搞定,成品还可以一键分发到各 Coding 平台。相关技能包源码在 assets/skills/comet-any/SKILL.md。
3️⃣ comet eval:科学评估Skill效果
"这个 Skill 到底比上次好还是差?" —— 用comet eval让数据说话:
comet eval ./my-skill --quick --html它采用"主 Agent 执行 + 独立 LLM 评审"的双 Agent 架构,按 Rubric 打分并计算Pass@k / Pass^k指标,自动生成可视化报告。下图就是官方基线实验的对比结果:接入 Comet 后,工作流维度的严格通过率明显更稳:
更多参数与用法(如--collect静态检查、LangSmith 集成)见 docs/operations/EVAL-USAGE.md。
遇到问题?两条救命命令
| 命令 | 作用 |
|---|---|
comet doctor | 体检安装与变更状态,报告畸形状态并给出修复方向,不会破坏性改文件 |
comet update | 补齐新版本的托管默认配置,同时保留你的自定义字段 |
小结
✅ 回顾一下,Comet 上手只需记住:
/comet—— 统一入口,让 AI 按工作流推进需求;/comet-any—— 组合任意 Skill,沉淀你的专属技能;comet eval—— 用 Rubric 和 Pass@k 科学评估 Skill 效果。
再加上comet status和comet dashboard两个"看进度"的命令,你的 AI 编码就有了完整的轨道。从npm install -g @rpamis/comet到第一条/comet,5 分钟就能跑通——现在就可以试试,让 AI 编码不再跑偏 🚀
【免费下载链接】cometComet: agent skill harness for turning ideas into evaluated workflows项目地址: https://gitcode.com/rpamis/comet
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考