开始前
- Node.js 22 或更高版本
- Git
- 一个受支持的 AI 编码平台
三步开始一次 Native 变更
1
安装并初始化 Comet
在项目根目录运行:初始化会安装 Native 所需的 Skill 和 Rule;支持 Hook 的平台还会安装统一 Router。项目配置会保存在
.comet/config.yaml,新的 Native 文档默认放在 docs/comet/。2
告诉 Comet 你想完成什么
打开 Agent,在项目中输入:
/comet 会读取项目配置并进入 Native。它是 Agent 中的 Skill 入口,不是终端命令。创建 change 时,你可以继续使用当前目录,也可以让 Comet 创建分支或 worktree。明确要求并行处理时,
Comet 会使用独立 worktree 隔离任务。3
确认目标,然后让 Comet 推进
Native 会先调查仓库里已经能确定的事实,只询问仍会改变范围、默认行为、兼容性或风险的决定。你确认目标、
非目标和验收标准后,Comet 会继续实现、检查、独立验收和归档,不需要你手动切换阶段。
Comet 管理的内容
- 准备并绑定工作区:创建或复用分支和 worktree,恢复时回到正确目录;工作区不匹配时停止写入,避免代码落到错误目录。
- 持续推进工作流:模型负责调查和实现,Runtime 决定当前阶段与下一步。只有出现用户决定或阻塞时才暂停。
- 独立判断是否完成:Runtime 先运行必要检查,再由新的只读 Verifier 对照验收标准检查结果;发现有验收项未通过,就带着明确问题回到 Build 修复。
- 从中断处继续:需求、进度和验收结论保存在项目文件中。换窗口、换会话或上下文压缩后,不需要重新讲一遍背景。
- 加载相关记录:启用 Personal Memory 和 Project Knowledge 后,Comet 会按当前任务选择相关的个人偏好与项目知识,不会一次载入全部历史内容。
中断后继续
重新打开项目后,在 Agent 中输入:comet status;想在浏览器中查看 Change、任务、验收和工作区进度,可以使用
comet dashboard。安装或状态异常时,再运行 comet doctor 排查。

