跳转到主要内容
comet update 会同时更新 npm package 和部署到 AI 编程平台的 skill files，让你的 Comet 安装保持最新。

​
用法

comet update [path]
省略 path 时，默认值为 .（当前目录）。你也可以只直接更新 package，而不刷新 skills： 
npm install -g @rpamis/comet@latest

​
update 会做什么

  1. Updates the npm package — 根据 Comet 最初的安装方式，运行 npm install -g @rpamis/comet@latest（global install）或 npm install @rpamis/comet@latest（project install）。如果 npm update 失败，该命令会继续使用当前已安装 package 中的 bundled skill files。
  2. Detects installed targets — 同时扫描项目目录和 home 目录，查找已经安装 Comet skills 的平台（平台 skills/ 目录中以 comet 开头的文件）。
  3. Detects installed language — 读取每个 target 的现有 skill files，判断安装的是 en 还是 zh skills。除非使用 --language 覆盖，否则会保留该语言。
  4. Refreshes Comet skill files — 从更新后 package 的 assets 中复制最新 skill files 到每个检测到的 target，并始终覆盖。
如果没有找到已安装的 targets，comet update 会退出并提示先运行 comet init。

​
Flags

​
--json
boolean
抑制进度输出，并在命令完成时打印单个 structured JSON result。请参阅下方的 JSON output。
​
--language
string
覆盖所有 targets 自动检测到的 skill language。可接受值：en（English）或 zh（Chinese）。没有此 flag 时，会分别保留每个 target 的现有语言。
​
--scope
string
将 update 限制到单个 scope。可接受值：project 或 global。没有此 flag 时，会扫描并更新两个 scopes。

​
示例输出

  Comet Update v1.3.0

  Updating npm package (global scope)...
    $ npm install -g @rpamis/comet@latest
  npm package: updated to latest @rpamis/comet

  Updating comet skills on 2 installed target(s):
    - Claude Code (project (/your/project), en)
      $ copy assets/skills -> .claude/skills/ (project)
    - Cursor (global, en)
      $ copy assets/skills -> ~/.cursor/skills/ (global)

  Copying 8 skill files...

  Claude Code (project, skills): 8 copied, 0 skipped
  Cursor (global, skills): 8 copied, 0 skipped

  Summary:
    npm: updated (global)
    skills: 2 target(s), 16 files updated
    scope: project, global
    language: en

  Update complete.

​
JSON Output

comet update --json

{
  "npm": {
    "scope": "global",
    "status": "updated",
    "command": "npm install -g @rpamis/comet@latest"
  },
  "skills": {
    "totalCopied": 16,
    "targets": [
      {
        "scope": "project",
        "platform": "claude",
        "platformName": "Claude Code",
        "language": "en",
        "source": "skills",
        "copied": 8,
        "skipped": 0,
        "command": "copy assets/skills -> .claude/skills/ (project)"
      },
      {
        "scope": "global",
        "platform": "cursor",
        "platformName": "Cursor",
        "language": "en",
        "source": "skills",
        "copied": 8,
        "skipped": 0,
        "command": "copy assets/skills -> ~/.cursor/skills/ (global)"
      }
    ]
  }
}
npm.status 字段是以下值之一：
Value含义
updatednpm package 已成功更新。
failednpm update command 以非零 code 退出；改用当前 package 中的 skill files。
skippednpm update step 被跳过。
定期运行 comet update，获取最新的 skill improvements、新 phase commands 和 bug fixes。Skill files 始终会被覆盖，不会出现 conflict prompt。
comet update 只刷新 Comet skill files。OpenSpec 和 Superpowers skills 由各自独立的 packages 管理，此命令不会触碰它们。