/comet。
前置要求
- Node.js 22.16 及以上的 22.x 版本，或 Node.js 24 及以上版本
- npm 或 npx
- Git
- 一个受支持的 AI 编码平台，例如 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 或 ZCode
1. 安装 CLI
@rpamis/comet v0.5.0）即表示安装成功。
2. 初始化项目（默认 Native）
进入你的项目根目录并运行：.comet/config.yaml。你可以运行诊断命令确认环境就绪：
✗ 失败项）说明配置完整。
其他初始化情况
其他初始化情况
新项目默认 Native，上面的命令覆盖绝大多数情况。只有确实需要时才用下面的变体：如果你的项目已有明确的 Classic 状态，只有 Classic 会安装或配置 OpenSpec、Superpowers 和 CodeGraph。项目级 Native、Classic 或 both 都会安装一份 Comet 工作流规则（Rule）；支持 Hook 的平台只会安装一个统一路由入口（Router），再按当前 change 把写入操作交给对应阶段的守卫（Guard）。global 安装会设置所选工作流的全局默认值；尚未配置的项目首次明确调用
comet init 会保持 Classic，不要手动把这类项目改回 Native。需要显式选择工作流或 Native 产物目录（如 docs）时，使用 --workflow、--root、--scope 参数，例如：/comet 时，会把全局默认值固化到项目的 .comet/config.yaml，产物仍只写在项目内。已激活项目不会因之后的全局默认值变化而被改写。全部参数和配置合并规则见 comet init；工作流取舍见 Native 还是 Classic。3. 调用 /comet
打开你的 Agent 平台，在项目里输入：
/comet 会读取 .comet/config.yaml 并将请求转发到对应工作流（新项目默认为 /comet-native）。Native 会自动为需求创建 change，并按 Shape → Build → Verify → Archive 四阶段推进：
comet status，随时查看当前活跃的 change 及其所处阶段。
安装、初始化、调用 /comet，并在中断后从文件状态恢复
查看状态
任何时候都可以在终端运行：comet doctor 检查安装与配置诊断：
继续中断的工作
如果会话中断，重新打开项目后输入：下一步
- 了解轻量工作流：阅读 Native 工作流。
- 需要经典五阶段强约束：详见 Classic 工作流概念。
- 想做快速修复：详见 hotfix 预设。