前置要求
- Node.js 22 或更高版本
- npm 或 npx
- Git
1. 安装 CLI
2. 初始化项目
进入项目根目录运行安装入口：comet init 会检测平台、安装 Comet Skill，并在项目级初始化时确定 /comet 的默认工作流。新项目默认启用 Native；已有明确 Classic 状态的项目保持 Classic。
完整选项与 Native/Classic 初始化边界见 comet init。
安装范围：项目级还是全局
不确定时先用项目级，它最容易让团队成员看到同一套 Comet 行为。
安装模式：复制还是符号链接
Classic 或 both 初始化在选择平台后会询问安装模式：- Copy（默认）：为每个平台独立复制一份 Skill 文件，适合跨设备同步（提交到仓库）。
- Symlink：在各平台
skills/目录创建指向.comet/skills/的符号链接，多平台共享同一份中央存储，一次更新全部生效。
3. 更新Comet
更新Comet可按如下操作，他会帮你拉取npm新包，刷新已安装的 Skill、Rule、Hook、Runtime及config配置：comet update 选择更新所有已登记项目时会一并更新对应的 npm 包（全局包最多尝试一次）。
用
—current-project 或 —json 把范围限定到单个项目时，默认只刷新资产、不更新 npm
包。这种模式下想同时更新包，再加 —self-update。4. 健康检查
任何时候状态异常，用comet doctor 做完整的安装健康检查：
doctor 会检查 Skill、脚本、工作目录和 change 状态：
fail是阻塞问题（如 Skill 缺失、状态损坏），必须优先处理。warn通常不阻塞（如 openspec CLI 未装但项目不依赖）。
5. 卸载
comet uninstall 只移除 Comet 管理的 Skill、规则和 hooks，保留你的 OpenSpec change、设计文档、实施计划和项目代码。
--all-projects。详见 comet uninstall。
什么时候需要重装或更新
- 升级
@rpamis/comet后。 comet doctor提示 Skill 或脚本版本不一致。- 切换中文或英文 Skill。
- 团队更新了项目级 Comet 配置。
- 安装摘要里某平台显示
failed，或写文件时 hook 报[COMET-HOOK] crash——通常是安装不完整，重跑comet init/comet update补齐文件。