跳转到主要内容
本页是 Comet CLI 的最短上手路径。只需要三条命令就能完成安装、检查和恢复。想了解每个命令的完整选项，再看进阶内容。

​
前提

  • Node.js 20+
  • npm/npx
  • Git
0.4.0-beta.1 起 Comet 是纯 Node 运行时，不再需要 Bash、Git Bash 或 WSL。macOS、Linux、Windows 用同一套命令。

​
第一步：安装 Comet

全局安装 CLI： 
npm install -g @rpamis/comet

​
第二步：初始化项目

在项目根目录运行： 
comet init
它会检测你的 AI 编码平台，安装 OpenSpec、Superpowers 和 Comet Skill。中文环境推荐： 
comet init --scope project --language zh
CI 或脚本环境用非交互模式： 
comet init --yes --scope project --language zh --json
初始化后建议跑一次 comet doctor 确认安装完整。

​
第三步：日常用这两条命令

​
恢复工作流：comet status

会话中断后，先看状态再继续： 
comet status
它会告诉你当前活跃 change、所在阶段和推荐的下一条命令。然后输入 /comet 继续，Agent 会从文件状态恢复，而不是靠记忆。

​
排障：comet doctor

如果 comet status 显示异常，或安装看起来有问题： 
comet doctor
它会检查项目级和全局安装、平台目录、Skill、脚本和活跃 change 状态，并给出恢复提示。

​
升级和卸载

升级到最新版： 
npm install -g @rpamis/comet@latest
comet update --scope project --language zh
comet doctor
卸载（保留你的 OpenSpec change、设计文档和代码）： 
comet uninstall --scope project

​
常见问题

默认检测当前项目的 AI 编码平台目录。用 --scope project 只装项目级，--scope global 装全局。
先跑 comet doctor 看是否有畸形 .comet.yaml 或缺失证据。修复后重新跑 status。
0.4.0-beta.1 起所有脚本都通过 Node.js 运行，Windows 不再需要 Git Bash 或 WSL。

​
进阶内容

基础路径到这里就结束了。下面是按场景分组的完整命令参考：
进阶主题适合场景
comet init完整初始化选项和组件选择
comet status完整状态字段和 runtime 数据
comet doctor完整诊断范围和排障流程
comet update升级流程和语言切换
comet uninstall安全卸载和范围控制

​
Skill、评估、发布命令

这三组命令属于进阶场景，普通用户通常通过 /comet-any 间接使用：
进阶主题适合场景
comet skill本地 Skill 包管理和 Engine Run
comet eval通用 Skill 评估入口
comet publishSkill 发布和分发
comet bundle高级 Bundle 后端（审计/调试）
想创建可复用 Skill，从组合任意 Skill 快速上手开始；想评估 Skill，从评估快速上手开始。