升级到当前 SDK 版本前，建议先完成并归档仍在运行的 0.4.5 Native、Classic 任务，再更新
Comet。日常阶段与操作方式保持原有入口。新版本能力见 Changelog。
前置要求
- Node.js 22.16 及以上的 22.x 版本，或 Node.js 24 及以上版本
- npm 或 npx
- Git
1. 安装 CLI
2. 初始化项目
进入项目根目录运行安装入口：comet init 会检测平台、安装 Comet Skill，并在项目级初始化时确定 /comet 的默认工作流。新项目默认启用 Native；已有明确 Classic 状态的项目保持 Classic。
完整选项与 Native/Classic 初始化边界见 comet init。
安装范围：项目级还是全局
不确定时先用项目级，团队成员会共享同一套配置，行为保持一致。
安装模式：复制还是符号链接
Classic 或 both 初始化在选择平台后会询问安装模式：- Copy（默认）：为每个平台独立复制一份 Skill 文件，适合跨设备同步（提交到仓库）。
- Symlink：在各平台
skills/目录创建指向.comet/skills/的符号链接，多平台共享同一份中央存储，一次更新全部生效。
3. 更新 Comet
更新前先刷新本地 npm 包，再刷新已安装的 Skill、Rule、Hook、Runtime 和 config 配置：comet update 选择更新所有已登记项目时，会一并更新每个项目对应的 npm 包；全局包最多尝试更新一次。
用
—current-project 或 —json
把范围限定到单个项目时，默认也会更新对应的 npm 包。只需要刷新资产时，加
—skip-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/cometnpm 包之后。 comet doctor提示 Skill 或脚本版本不一致。- 切换中文或英文 Skill。
- 团队更新了项目级 Comet 配置。
- 安装摘要里某平台显示
failed，或写文件时 hook 报[COMET-HOOK] crash——通常是安装不完整，重跑comet init/comet update补齐文件。
下一步
未登记的项目平台
内置平台使用--platform <id>。确需安装到未登记的 Claude 兼容目标平台时，同时显式传入 --custom-platform；init 和 update 都不会再把未知名称自动当作兼容平台。先核对目标平台支持的 Skill、规则与 Hook 能力，再确认安装。