Comet:可恢复的长任务工作流,从需求到验收归档
📌 适用场景:核对运行时 → 全局安装 → 初始化工作流 → 写目标与验收项 → 确认决策推进 → 证据验收 → 归档交付 → 中断恢复与复盘
rpamis/comet 的可恢复长任务工作流与 Skill 平台:Native 与 Classic 独立,/comet 按配置转发,运行时管理阶段、工作区与验收证据,支持恢复、并行子变更与 Eval。默认 SDK 接受结果后归档状态,Git commit/merge/push/PR 按授权另行执行核实;--finish 与内建 Git 归档提交属于旧 Compat。
📋 完整步骤
- 1
核对运行时与仓库状态
确认 Node 满足 ^22.16.0 || >=24.0.0(不含 23.x),Git 可用,目标仓库工作区干净且已建分支
- 2
全局安装并自检
用 npm 全局安装 @rpamis/comet,跑 comet doctor 看依赖与配置是否齐全
- 3
在单仓初始化工作流
在项目根目录执行 comet init,按需求强度选择 native、classic 或 both,确认 .comet/config.yaml
- 4
写清目标与验收项
在宿主里用 /comet 描述交付目标,先给范围、默认值与可验收的结果,而不是实现步骤
- 5
确认决策并让流程自动推进
只回答影响范围、默认值、兼容性与风险的决策,之后由运行时管理 Shape、Build、Verify 的切换
- 6
按证据验收
逐条核对原始请求与验收项,失败项回到 Build 并写入具体原因,不靠「已完成」的口头结论
- 7
归档与交付
默认 SDK 在验收接受后由 Runtime 归档状态;Git commit、merge、push、PR 按授权另行执行和核实,不套用 Compat 的 --finish 流程
- 8
中断恢复与复盘
用 comet status 或 /comet continue 从检查点继续,必要时开 comet dashboard 看轨迹与验收记录
这是什么?适合谁?
Comet 由 rpamis/comet 开源维护,官方给自己的定位是「面向智能体的可恢复长任务工作流与 Skill 平台」。它不是一个新的模型,也不是一个代码编辑器,而是把「需求 → 规格 → 实现 → 验收 → 归档」这条链做成有状态、可恢复、可复核的流程。
它提供两条独立的需求工作流:
- Native:给强模型用,只由 Comet 自己的运行时治理。你在 Shape 阶段确认目标与验收项,之后由运行时推进 Build 与 Verify,不再要求模型逐段写程序化文档。
- Classic:保留完整的 OpenSpec + Superpowers 五阶段治理模型,适合需要明确方法与强约束的任务。
/comet 本身是一个确定性入口:它只读项目里的 .comet/config.yaml,据此转发到 /comet-native 或 /comet-classic,不会按任务大小去猜,也不会把两条工作流的状态与目录混在一起。
适合的人群与任务:手上是「要跨多次会话才能做完」的需求,需要有人记录阶段、验收证据与恢复点;团队想让多个智能体在隔离工作区里并行做子任务,再按依赖顺序合并。
不适合的场景:一处明确的小改动(直接改更快);不愿意让工具在仓库里创建分支、工作区与状态文件的项目;把「流程跑完」等同于「质量达标」的期待——验收项仍然要人写清楚。
核验日期:2026-11-19。
本文基于官方文档和公开资料整理,AI辅助生成,MagicNetWorld 尚未完成独立实测。
我们核对了仓库 README、官方文档站的 Native Quickstart、npm 包元数据与 GitHub 元数据,但没有全局安装 Comet、没有执行 comet init、没有在任何宿主里触发过 /comet,也没有跑过验收或归档。
前置准备与平台边界
官方要求很明确:
- Node.js 22.16 或更高的 22.x,或 24 及以上。npm 包声明的 engines 为
^22.16.0 || >=24.0.0,低于这个范围不要硬上。 - npm / npx。安装与技能分发都走 npm 生态。
- Git。工作流会创建或复用分支与工作区,没有 Git 就没有恢复点。
- 一个受支持的 AI 编码平台。官方说
comet init支持 39 个平台,从 Claude Code、Codex、Cursor 到 Antigravity、Kimi Code 等,各自有对应的技能目录(例如 Claude Code 用.claude/,Codex 用.codex/,Antigravity 用.agents/)。
平台边界要提前说清:
- 运行时是纯 Node.js 实现,官方说明在 Windows、macOS、Linux 上都不需要 Bash 或 WSL。这一点与「必须跑在 Unix shell 里」的编排工具不同。
/comet是宿主里的技能入口,不是终端命令。终端里能跑的是comet init、comet status、comet doctor、comet dashboard这类 CLI 子命令。- 工作流会在你的仓库里写
.comet/config.yaml、状态文件(新 Classic 变更用comet-state.yaml,旧的.comet.yaml继续兼容)与默认落在docs/comet/的文档。先确认这些路径不会被你们的仓库策略拦住。
逐步流程
第一步:核对运行时与仓库状态
node -v
git --version
git status --short
Node 版本不在允许范围时先升级,不要指望运行时报错后还能安全继续。目标仓库应当是干净工作区,并且已经在一个明确的分支上,避免 Comet 创建的工作区与未提交改动纠缠。
第二步:全局安装并自检
npm install -g @rpamis/comet
comet doctor
comet doctor 检查安装、配置与环境依赖。核验时 npm registry 上 @rpamis/comet 的最新版本为 0.5.5,engines 为 ^22.16.0 || >=24.0.0,许可 MIT。版本会继续变,装完以 comet doctor 的实际输出为准,不要照抄任何文章里的版本号。
第三步:在单仓初始化工作流
cd your-project
comet init
交互式初始化会解释并让你选 Native、Classic 或两者都装。非交互的新项目默认 Native。也可以直接指定:
comet init --workflow native
comet init --workflow classic
comet init --workflow both
初始化会安装对应的 Skills 与规则;支持 Hooks 的平台还会收到统一路由。项目设置写入 .comet/config.yaml。
如果你的宿主是走通用 skills CLI 的平台(例如 OpenClaw、Hermes 一类),官方另给了技能包安装方式:
npx skills add rpamis/comet
第四步:写清目标与验收项
在宿主里用技能入口启动,而不是在终端敲:
/comet implement avatar upload for the user profile page
/comet 读取项目配置后启动对应工作流。创建变更时可以选择在当前工作区做,也可以让 Comet 准备独立分支或工作区;并行推进多个任务时,它会把每个变更隔离在独立工作区里。
这一步的关键不是把实现步骤写细,而是把可验收的结果写清:范围、默认值、兼容性要求、不能退化的行为。
第五步:确认决策并让流程自动推进
Native 会先读现有代码库,只就有范围、默认值、兼容性或系统风险的问题向你确认,例如:
Comet: Analyzed repository. Found existing src/components/Avatar.tsx. Please confirm:
1. Maximum upload file size (default: 2MB)?
2. Allowed image formats (default: JPG/PNG/WebP)?
你回答后,规格写进 brief.md,流程进入 Build(实现)与 Verify(逐项验收),中间的阶段切换由运行时管理,不需要你手工喊「下一步」。
第六步:按证据验收
运行时会执行或复用有效的检查,Verify 阶段对照原始请求与全部验收项逐条判定,失败项带着具体原因回到 Build。这里的纪律是:不要用「已完成」的口头结论替代证据。你也要在验收项里写清哪些是必须项,避免流程为了收敛而放宽标准。
第七步:归档与交付
按 0.5.5 Archive and Delivery,默认 SDK 任务先完成 Verify 并接受当前结果,再由 Runtime 归档状态。除非已明确预先授权「通过后接受并归档」,否则仍须接受本次结果。若响应已确认 Archive 完成,直接核对实际交付;若仍有 Archive 动作,按返回的 continuation 在项目目录执行 comet native archive <change-name> --json,需要预览可加 --dry-run,不要加 Compat 的 --finish。
SDK Archive 完成不等于 Git 交付完成。commit、merge、push 和 PR 要按用户授权及仓库规则独立执行,并核实实际提交和远端结果;未获 push/PR 授权就应停在相应边界。旧 Compat 任务保留原验证契约,--finish 收尾选项、事务式预检和 Runtime 内建 Git 归档提交属于这条兼容路径,不是所有新任务的默认流程。
第八步:中断恢复与复盘
任何时候中断(关会话、换机器、上下文丢失),回来这样接:
/comet continue
它会重读当前变更、工作区绑定与下一步,从最近的检查点继续;如果代码或工作区路径对不上,它会解释问题,而不是在错误目录里静默建文件。
终端里核对阶段:
comet status
需要可视化时:
comet dashboard
comet dashboard 起本地 Web 控制台,可以看 Native 与 Classic 的进度、Git 工作区、验收结果与归档状态,也能管理 Personal Memory、Project Knowledge 与插件设置。
初级用法
1. 先只用一个工作流,别急着 both
both 会装两套独立入口,默认 /comet 走 Native。第一次上手建议只装 Native,把「目标 + 验收项」这件事练顺,再考虑引入 Classic 的强约束。
2. 需求写结果,不写步骤
「让头像上传支持 2 MB 以内、JPG/PNG/WebP、失败给出可读错误」比「先写组件、再写接口、再写测试」更容易验收,也更适合让运行时自己安排实现顺序。
3. 用 comet status 代替猜进度
阶段、活动变更、下一步提示都在 comet status 的输出里;不要靠回忆上次聊到哪。
4. 一个变更只做一件事
变更越聚焦,验收项越少,失败定位越快;把「顺手重构」塞进同一个变更,会让 Verify 阶段无法判断失败原因。
高级玩法
1. 用 Supervisor Change 做依赖感知的并行
复杂需求可以拆成有依赖关系的子变更(DAG),由多个 Codex 会话或 Claude Code 的 Agent Teams 在运行时创建的隔离工作区里实现与验证,再按依赖顺序合并,最后做父变更的总体验收。前提是拆分边界要按真实交付边界切,而不是按文件切。
2. 把 PRD 直接当输入
官方有「从文档直接交付」的实践页:把现成的 PRD 交给 Native,让它先做 Shape 阶段的澄清,再推进 Build/Verify。适合需求文档已经存在、但没人手写实现计划的团队。
3. 用 Comet Eval 给技能做版本对比
Comet Eval 支持 Rubric 评分与 Pass@k / Pass^k 指标,并能接 LangSmith / LangFuse 做轨迹记录。用法不是「跑一次看分数」,而是固定一组 case,比较两个版本的通过率与消耗,再决定是否替换。
4. 用 Comet SDK 组合自己的流程
SDK 提供 JavaScript / TypeScript 公开 API,可以把工具、技能、用户确认、并行任务与子流程组合成工作流,并持久化执行进度。适合已经有内部工具链、需要把 Comet 的恢复能力接到自有系统里的团队。
5. 用 Personal Memory 与 Project Knowledge 减少重复解释
这两项会跨任务保留协作偏好与项目知识,并按当前任务按需注入。官方强调可检查、可纠正、可遗忘、可暂停,新经验先进入试用态再靠实际采用与验证积累证据。团队场景要先约定哪些内容允许写入。
五个具体使用技巧
- 初始化后先
git status看一眼新增了哪些文件,确认.comet/config.yaml与状态文件确实落在预期位置。 - 验收项写成可判定的句子(有阈值、有输入样例),不要写「体验良好」这类无法核对的描述。
- 中断后先
/comet continue,不要重开一个变更——重开会丢掉已记录的验收证据。 - 并行子变更前先确认它们改的文件集合不重叠,重叠就改成串行。
- 归档前把
comet dashboard里的验收记录过一遍,比事后翻聊天记录可靠。
踩坑记录
1. Node 版本不够,安装后命令行为异常
- 症状:
comet能装上,但运行时行为不对或直接报错。 - 原因:官方要求 Node 22.16+(22.x 线内)或 24+;npm 包 engines 声明为
^22.16.0 || >=24.0.0。 - 排查:
node -v对照 engines;用版本管理器切到合规版本后重装。来源:README「Install」的 Requirements。
2. 在终端里敲 /comet,提示找不到命令
- 症状:终端报
command not found。 - 原因:
/comet是宿主里的技能入口,不是 shell 命令;终端里可用的是comet init、comet status、comet doctor、comet dashboard。 - 排查:回到宿主的对话里触发
/comet;命令行侧用comet doctor确认安装与依赖。来源:Native Quickstart 第三步。
3. 以为改任务大小就能切换 Native / Classic
- 症状:小任务也按 Classic 走,或大任务莫名其妙走了 Native。
- 原因:
/comet只按.comet/config.yaml确定性转发,不按任务规模猜。 - 排查:看
.comet/config.yaml的实际配置;要换流程就重新comet init --workflow …,或直接用/comet-native、/comet-classic显式指定。来源:README「What is Comet」。
4. 把 Archive 完成误当成代码已提交或已推送
- 症状:SDK Run 已完成,却找不到预期的 Git commit、远端分支或 PR。
- 原因:默认 SDK 归档状态与 Git 交付是两件事;Runtime 内建归档提交与
--finish是 Compat 行为,不能直接套给新 SDK 任务。 - 排查:先用
comet status核对原任务与 Archive 状态,按 continuation 恢复,不手改状态伪造完成;随后在已授权范围内另行提交/合并/推送/建 PR,检查实际 SHA 与远端结果。若是 Compat,按该任务原契约及预检提示执行。来源:Archive and Delivery。
5. 把官方的 eval 数字当成通用收益
- 症状:在立项材料里引用「token 少 76.8%」当作必然收益。
- 原因:那是官方在特定对齐实验里的自述结果(16 个任务、每种处理 48 次运行、41 组配对样本),有明确的条件与局限,且发布方就是工具作者。
- 排查:在自己的任务集上重跑对比再引用;引用时标明来源与样本量。来源:Native vs 0.4.0 Classic 实验报告。
6. 跨平台技能目录写错位置
- 症状:
comet init跑完了,宿主里看不到 Comet 技能。 - 原因:不同平台的技能目录不同(Claude Code
.claude/、Codex.codex/、Antigravity.agents/等),39 个平台各有约定。 - 排查:对照官方 Supported Platforms 表确认你的平台目录名;走通用
skillsCLI 的宿主改用npx skills add rpamis/comet。来源:README「Supported Platforms」。
7. 并行子变更互相踩文件
- 症状:两个子变更合并时冲突,或验收结果互相矛盾。
- 原因:工作区隔离的是目录与进程,不是文件所有权;同时改同一文件的子变更仍会冲突。
- 排查:拆分时按交付边界切;改同一文件的子变更改为串行,或在父变更里统一处理。来源:README「Supervisor Change」段落。
常见问题 FAQ
1. 用 Comet 要花多少钱?
工具本身 MIT 开源、免费。真正的成本是模型调用:Comet 的长任务会跨很多轮,强模型的上下文与轮次直接决定费用;并行子变更会成倍放大调用量。README 里有赞助商(模型聚合网关)的广告,那是项目赞助,不是 Comet 的收费方案,也不代表你必须在那些网关开户。
2. 它和 OpenSpec、Superpowers 是什么关系?
Classic 工作流就是把 OpenSpec 与 Superpowers 的五阶段治理组合起来,并加了状态机、阶段检查与脚本自动化;Native 则不再沿用这套程序化流程,改为由运行时按验收证据治理。也就是说,选择 Classic 意味着接受既有方法论的约束,选择 Native 意味着把实现方法交给模型,但验收仍是硬门槛。
3. 和 GitHub Spec Kit、Taskmaster 这类工具比,边界在哪?
github/spec-kit 侧重把规格作为开发起点,配套命令与模板,目标是「先写规格再实现」;Fission-AI/OpenSpec 用 proposal / specs / tasks 组织变更归档。Comet 的差异在于可恢复的运行时:阶段、工作区绑定、验收记录与归档状态都落盘,中断后能续跑,并且支持把长任务拆成依赖感知的子变更并行推进。它不是更会写代码,而是更会把长任务管住。
4. 必须用 Native 吗?什么情况选 Classic?
官方给的判断是:强模型、能自主实现与验证的任务用 Native;需要完整 Spec / TDD 阶段约束、团队要求明确方法论的用 Classic。没有把握时先用 Native 跑通一条,再评估是否要更强的流程约束。
5. Windows 上需要 Bash 或 WSL 吗?
不需要。官方说明运行时是纯 Node.js,在 Windows、macOS、Linux 上都不要 Bash 或 WSL。但你的宿主(编码 CLI)本身可能有自己的平台前提,这部分要按宿主的文档确认。
6. 数据会离开本机吗?
工作流状态、规格与验收记录默认留在项目里(docs/comet/、.comet/config.yaml、状态文件)。模型调用本身会把上下文发给所选模型的提供方;Personal Memory 与 Project Knowledge 是本地可管理的条目,但接入 LangSmith / LangFuse 做评估时,轨迹会进入这些外部服务,需要按你们的合规要求评估。
7. 版本怎么跟?
核验时 npm 最新为 0.5.5,文档站也显示 0.5.5;README 的发布说明仍以 0.5.0 为标题在讲 SDK 能力。以 comet doctor 与官方 Changelog 为准,也要区分任务契约:默认 SDK Archive 不证明 Git commit、push 或 PR 已完成;旧 Compat 的内建 Git 收尾仅适用于原任务,不因更新版本就改套契约。
权限、安全、成本与平台限制
- 仓库写入:初始化会改仓库结构(配置文件、技能目录、默认文档目录),首次运行前确认这些路径在你们的仓库策略内。
- 分支与工作区:Comet 会创建或复用分支与工作区;并行任务会在独立工作区里跑。工作区隔离不等于权限隔离,同一个用户凭据对文件系统与网络的访问范围不变。
- 归档与交付权限:默认 SDK 由 Runtime 归档状态,Agent 在授权范围内另行执行和核实 Git 操作;旧 Compat 才有 Runtime 内建 Git 归档提交与
--finish选项。无论哪条路径,归档不扩大 commit/merge/push/PR 权限。 - 外部服务:LangSmith / LangFuse 接入会把评估轨迹发到外部;是否启用按合规要求决定。
- 成本:模型调用是大头,长任务与并行会放大;没有统一的单任务价格,需按所选模型与验收轮次估算。
- 平台限制:39 个平台的支持深度不一致(技能目录、规则、Hooks 能力各不相同);支持 Hooks 的平台才有统一路由。
参考链接
- 仓库与 README:github.com/rpamis/comet
- 官方文档站:docs.comet.rpamis.com
- Native Quickstart:docs.comet.rpamis.com/en/native/quickstart
- 归档与交付:Archive and Delivery
- 支持平台列表:Supported Platforms
- 评估报告(Native vs 0.4.0 Classic,官方自述):docs.comet.rpamis.com/en/eval/comet-native-vs-040-experiment
- npm 包元数据:npmjs.com/package/@rpamis/comet
- 仓库元数据(stars / forks / pushed_at):api.github.com/repos/rpamis/comet
📊 评分与标签
核验口径:已按现行口径通过,待按新证据契约复核 · 证据状态:仅公开资料 · 核验日期:
评分说明
总分 7.9/10 · S_入选
核验日期:2026-11-19。评分依据可追溯至仓库 README(Native / Classic 双工作流、/comet 的确定性转发、Supervisor Change、归档与 Eval 说明、安装要求与平台表)、官方文档站的 Native Quickstart(安装、初始化、/comet continue、comet status、comet dashboard、comet doctor)、归档页与 npm 包元数据,以及 GitHub REST 元数据。
这是资料核验判断:我们没有全局安装 Comet、没有执行 comet init、没有在任何宿主里触发 /comet、没有跑过验收、归档或 Eval。
分数不沿用采集阶段的排序值,也不是从百分制换算得来;分项评价的是可核实的流程设计、文档与生态,不代表实测成功率。
可观测社区指标
采集日期:2026-11-19。GitHub REST 返回 stars 3,306、forks 317、open issues 12(包含 PR),pushed_at 为 2026-11-18T12:21:57Z,created_at 为 2026-05-14T09:22:35Z,未归档,默认分支 master,语言标注为 JavaScript,API 识别许可为 MIT。
npm registry 的 @rpamis/comet 最新版本为 0.5.5,engines 为 ^22.16.0 || >=24.0.0,许可 MIT;官方文档站版本号同样显示 0.5.5,而 README 的发布说明仍以 0.5.0 为标题介绍 SDK 能力,属于说明文字滞后于小版本,不影响安装。
这些是关注度与维护快照,不是采用量、任务成功率或支持承诺的证据。
🧩 流程完整性 2.4/3.0
- 证据:两条独立工作流各成闭环。Native 的四个阶段是 Shape(确认目标)→ Build(实现与检查)→ Verify(逐项验收)→ Archive(归档与交付),阶段切换由运行时管理;Classic 保留 OpenSpec + Superpowers 的五阶段模型,并加状态机、阶段检查与
comet-guard.mjs、comet-yaml-validate.mjs、comet-state.mjs一类守卫脚本,阶段出口不依赖模型自称「完成」。 - 竞品对比 1(Fission-AI/OpenSpec):OpenSpec 用 proposal / specs / tasks 组织变更与归档,流程清晰但状态推进较多依赖约定与提示词;Comet 把状态机与守卫写成可执行脚本,并记录验收证据。
- 竞品对比 2(github/spec-kit):Spec Kit 覆盖「规格先行」的命令与模板,重心在规格生成与实现衔接;Comet 的重心是在长任务里维持阶段、工作区绑定与可恢复性。
- 扣分:Native 把实现方法交给模型,流程约束比 Classic 弱;验收项仍需人写,写不好就会退化成「模型自评」;本站未验证守卫脚本在真实仓库里的拦截效果。
♻️ 可复用性 2.0/2.5
- 证据:
/comet只读.comet/config.yaml做确定性转发,同一套配置可在多次任务里复用;comet init覆盖 39 个平台,项目级与全局安装各有落点;状态与验收记录留在项目文件里,换会话、换机器都能续跑;SDK 允许把工具、技能、子流程组合成自有工作流并持久化进度。 - 竞品对比 1(Fission-AI/OpenSpec):OpenSpec 用变更目录和规格文件组织变更;Comet 用工作流配置与持久运行记录恢复任务。两者持久化对象不同,本文未测跨任务一致性优劣。
- 竞品对比 2(github/spec-kit):Spec Kit 的 Preset/Extension 机制用于复用和调整模板、命令与流程;Comet 的
comet init选择工作流、安装 skills/规则并写项目配置。初始化不等于已锁定所有依赖版本。 - 扣分:39 个平台的支持深度不一致(技能目录、规则、Hooks 能力不同),跨平台迁移仍需逐项确认;
both模式会带来两套目录与状态,团队需要约定用哪一套。
📖 文档清晰度 1.5/2.0
- 证据:文档站按「Get started / Understand Native / Advanced / Practical scenarios / Classic / Compose / Eval / CLI / SDK / FAQ」组织,Native 部分给出可执行的三步流程、
/comet continue的恢复语义、comet status的实际输出样例、comet dashboard与comet doctor的用途;另有归档、状态文件、决策归属与恢复专题页。 - 竞品对比 1(Fission-AI/OpenSpec):其 README 展示 proposal/specs/tasks 的变更流程;Comet Quickstart 另区分 Native/Classic 入口。读者应按所选流程读对应文档,不以篇幅推断谁更清楚。
- 竞品对比 2(github/spec-kit):其 README Capabilities 表链接 Integration、Extension、Preset 与 Workflow 文档;Comet 的 Quickstart 链接归档、恢复与 CLI 页,提供不同主题的查阅路径。
- 扣分:README 仍以 0.5.0 为标题介绍 SDK,npm/文档站已是 0.5.5;归档页并列 SDK 与 Compat,读者必须核对任务契约,不能仅凭 README 摘要使用旧 Git 收尾方式。这里评价版本与路径识别成本,不断言全站缺少故障排查索引。
🔌 工具集成 1.2/1.5
- 证据:
comet init覆盖 39 个 AI 编码平台并区分技能目录;Classic 复用 OpenSpec 与 Superpowers;Eval 可接 LangSmith / LangFuse 记录轨迹与基线;SDK 提供 JS/TS 公开 API;插件中心与npx skills add rpamis/comet覆盖走通用skillsCLI 的宿主。 - 竞品对比 1(github/spec-kit):Spec Kit 有 Integration 连接编码代理、Extension 连接外部工具等机制;Comet 有 39 平台目录映射与 skills/规则/Hooks 安装。没有同口径支持集测试,不作平台宽窄排名。
- 竞品对比 2(Fission-AI/OpenSpec):OpenSpec 以文件与命令为主要接口,不绑定特定宿主;Comet 需要宿主支持技能加载,接入成本与宿主强相关。
- 扣分:我们没有逐个平台验证「装上就能用」;Hooks 能力只对部分平台开放;LangSmith / LangFuse 集成会把轨迹发到外部服务,合规成本另计。
💡 创新性 0.8/1.0
- 证据:把「可恢复」做成第一等公民——需求、进度与验收记录落盘,
/comet continue从检查点续跑,路径不匹配时解释而不是静默建文件;Supervisor Change 用依赖感知的子变更与隔离工作区做并行交付;Eval 用 Rubric 与 Pass@k / Pass^k 固定 case 比较版本。 - 竞品对比 1(Fission-AI/OpenSpec):OpenSpec 的创新点在规格组织方式;Comet 的创新点在把长任务的运行时状态与验收证据产品化。
- 竞品对比 2(github/spec-kit):Spec Kit 提供规格驱动开发及可组合流程;Comet 的 默认 SDK Archive 在接受验收结果后归档状态,Git commit/merge/push/PR 按授权另行执行核实。Runtime 内建 Git 归档提交和
--finish是旧 Compat 路径,不能作为新任务普遍优势。 - 扣分:这些机制在业界已有相近实践(官方自己也写了与 industry practices 的对照);真正的差异要靠长期使用验证,本站没有实测。
局限与未实测
- 未安装、未初始化、未触发:所有关于流程行为的描述来自 README 与文档站,本文没有跑过任何一个变更。
- 官方 eval 数字为自述:Native vs 0.4.0 Classic 的实验(16 个任务、每种处理 48 次运行、41 组配对样本,token 少 76.8%、轮次少 57.4%、时间少 47.4%,Native 的 pass^3 为 87.5%,两者 pass@3 均 100%)由工具作者发布,附有条件与局限说明,本站未复现。
- 版本口径以核验日为准:npm 与文档站为 0.5.5,README 仍以 0.5.0 为标题讲 SDK;版本会继续变。
- 39 个平台的支持深度没有逐项验证。
- stars / forks / open issues 为采集当日快照。
来源核实
- 元数据与许可:GitHub REST
/repos/rpamis/comet(MIT,未归档,默认分支master);npm registry/@rpamis/comet/latest(0.5.5,engines、MIT)。 - 安装与命令:README「Install」「Quick Start」「Support for OpenClaw and Hermes」;Native Quickstart(
comet init --workflow native、/comet、/comet continue、comet status、comet dashboard、comet doctor)。 - 流程与边界:README「What is Comet」「Why Comet」「Supervisor Change」「What You Can Learn」。
- 归档语义:文档站 Archive and Delivery 页。
- 评估:README 中的实验摘要与官方 eval 报告页。
标签说明
- 工作流编排:Native 与 Classic 两条工作流,
/comet按配置确定性转发,阶段由运行时治理。 - 长任务:面向跨会话、需多次推进的需求,状态与验收记录落盘,支持中断续跑。
- 可恢复:
comet resume-probe、/comet continue、检查点与工作区绑定校验共同构成恢复路径。 - Skill平台:除自带工作流外,还提供 Comet Any、SDK 与 Eval,用于组合、分发与评估技能。
- 开源:MIT 许可,仓库
rpamis/comet公开,npm 包可安装。