跳转到主要内容
comet init 是设置 Comet 时运行的第一个命令。它会以交互方式把 OpenSpec、Superpowers 和 Comet skills 安装到你选择的 AI 编程平台。

​
用法

comet init [path]
省略 path 时，默认值为 .（当前目录）。

​
init 会做什么

运行 comet init 会按顺序引导你完成以下步骤：
  1. Detect existing platforms — 扫描现有 AI 平台配置目录（例如 .claude/、.cursor/），并在 platform picker 中预先选中它们。
  2. Choose install scope — 选择 project（当前目录）或 global（home 目录）。
  3. Select language — 为 Comet skill files 选择 English 或 中文。
  4. Select platforms — 选择一个或多个支持的 AI 编程平台来安装 skills。检测到的平台会被预先勾选。
  5. Install OpenSpec skills — 将 OpenSpec spec-lifecycle skills 部署到选中的平台。
  6. Install Superpowers skills — 将 Superpowers development-methodology skills 部署到选中的平台。
  7. Deploy Comet skills — 将 Comet phase-command skills（使用你选择的语言）复制到每个选中平台的 skills/ 目录。
  8. Create working directories — 对 project-scope installs，创建 docs/superpowers/specs/ 和 docs/superpowers/plans/。

​
Flags

​
--yes
boolean
非交互模式。自动选择所有检测到的平台（如果未检测到任何平台，则选择所有支持的平台），默认 scope 为 project，并跳过任何现有组件而不提示。
​
--scope
string
在不提示的情况下设置 install scope。可接受值：project（安装到当前目录）或 global（安装到 home 目录）。
​
--skip-existing
boolean
自动跳过任何已经安装的 skill components，不进行提示。与 --overwrite 的意图互斥。
​
--overwrite
boolean
自动覆盖任何已经安装的 skill components，不进行提示。与 --skip-existing 的意图互斥。
​
--json
boolean
抑制所有交互式输出，并在命令完成时打印单个 structured JSON result。请参阅下方的 JSON output。

​
交互模式

当既未设置 --skip-existing 也未设置 --overwrite 时，comet init 会在写入任何内容之前检测每个平台上已经安装了哪些组件。
  • 同一平台上有多个现有组件 — 你会看到一个批量选择：Overwrite all existing components、Skip all existing components 或 Choose per component。选择 “Choose per component” 后，会针对每个冲突组件（OpenSpec、Superpowers、Comet）进入单独 prompt。
  • 只有单个现有组件 — 会按组件提示你覆盖或跳过。

​
示例输出

   ██████╗ ██████╗ ███╗   ███╗███████╗████████╗
  ██╔════╝██╔═══██╗████╗ ████║██╔════╝╚══██╔══╝
  ██║     ██║   ██║██╔████╔██║█████╗     ██║
  ██║     ██║   ██║██║╚██╔╝██║██╔══╝     ██║
  ╚██████╗╚██████╔╝██║ ╚═╝ ██║███████╗   ██║
   ╚═════╝ ╚═════╝ ╚═╝     ╚═╝╚══════╝   ╚═╝
            OpenSpec + Superpowers Workflow

  Setting up Comet in /your/project

  Language: English

  Installing OpenSpec for: claude, cursor
  OpenSpec: installed

  Installing Superpowers for: claude, cursor
  Superpowers: installed

  Comet -> Claude Code: installed (8 files) -> .claude/skills/
  Comet -> Cursor: installed (8 files) -> .cursor/skills/

  Comet setup complete! (scope: project)

  Installed:
    Claude Code -> .claude/skills/
    Cursor      -> .cursor/skills/

  Working directories: docs/superpowers/specs/, docs/superpowers/plans/

  Get started:
    /comet "your idea"  — Start a new change with full workflow
    /comet-hotfix       — Quick bug fix (skip brainstorming)
    /comet-tweak        — Small change (skip brainstorming and plan)

​
JSON Output

传入 --json 可抑制交互式 prompts，并接收 machine-readable result： 
comet init --yes --json

{
  "projectPath": "/your/project",
  "scope": "project",
  "language": "en",
  "selectedPlatforms": ["claude", "cursor"],
  "results": [
    {
      "platform": "claude",
      "platformName": "Claude Code",
      "openspec": "installed",
      "superpowers": "installed",
      "comet": "installed"
    },
    {
      "platform": "cursor",
      "platformName": "Cursor",
      "openspec": "installed",
      "superpowers": "installed",
      "comet": "installed"
    }
  ],
  "workingDirsCreated": true
}
results 中的每个 entry 针对每个组件都有以下三种 status values 之一：
Value含义
installed组件已成功写入。
skipped组件已存在，且未被覆盖。
failed安装组件时发生错误。
comet init 完成后，运行 comet doctor 验证安装完整且健康。