跳转到主要内容
Comet 可以在几秒内完成安装，并用一个命令让你的 AI 编程工具运行结构化的五阶段工作流。本指南会带你从零开始，完成第一次 /comet 调用。

​
前置条件

安装 Comet 之前，请确保你的机器上具备以下环境。
  • Node.js 20+ — Comet 需要 Node 20 或更高版本（使用 node --version 检查）
  • npm / npx — 随 Node.js 捆绑；用于安装和运行 CLI
  • Git — build 阶段进行 branch/worktree 隔离时必需
  • Bash-compatible shell — macOS 和 Linux 原生支持；Windows 用户应使用 Git Bash 或等价的 bash 环境来运行工作流脚本
  • AI 编程工具 — Claude Code、Cursor、Windsurf、GitHub Copilot、Gemini CLI，或任意 28 个支持的平台

​
Step 1：全局安装 Comet

从 npm 安装 Comet CLI，让 comet 命令可在系统任意位置使用。 
npm install -g @rpamis/comet
验证安装： 
comet --version

​
Step 2：进入你的项目目录

Comet 会相对于项目根目录安装 skills（global install 则安装到 home 目录）。切换到你想使用 Comet 的项目： 
cd your-project
如果你还没有开始项目，请先创建新目录并初始化 Git repository：mkdir my-app && cd my-app && git init。

​
Step 3：运行 comet init

交互式 initialiser 会把 OpenSpec skills、Superpowers skills 和 Comet skills 安装到你选择的 AI 编程平台。 
comet init
comet init 会依次引导你完成以下 prompts：
Prompt如何选择
Install scopeproject 会把 skills 安装到当前目录（随 repo 提交）。global 会安装到 home 目录，供所有项目使用。
Language为 Comet skill text 选择 English 或 中文。OpenSpec 和 Superpowers skills 使用各自的语言设置。
Platform selection选择你使用的 AI 编程工具。Comet 会自动检测已有的平台配置目录（例如 .claude/、.cursor/）并预先选中它们。
Conflict handling如果 skills 已存在，可选择全部覆盖、全部跳过，或按组件逐个决定。

​
示例 comet init 输出

$ comet init

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

? Install scope:
  ● Project (current directory)
  ○ Global (home directory)

? Language for Comet skills:
  ● English
  ○ 中文

? Select platforms to set up:
  ◉ Claude Code  (detected)
  ◯ Cursor
  ◯ Windsurf
  ◯ GitHub Copilot

  Installing OpenSpec for: claude
  OpenSpec: installed
  Installing Superpowers for: claude
  Superpowers: installed
  Comet -> Claude Code: installed (12 files) -> .claude/skills/

  Comet setup complete! (scope: project)

  Installed:
    Claude Code -> .claude/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)
comet init 完成后，你的项目会为每个选中的平台包含一个 skills 目录（例如 .claude/skills/），里面包含完整的 Comet、OpenSpec 和 Superpowers skill files 以及 automation scripts。

​
Step 4：使用 comet doctor 验证

运行内置 health check，确认一切都已正确连接： 
comet doctor

​
预期的健康输出

$ comet doctor

Comet Doctor — project scope
────────────────────────────────────────────────
✔ Node.js           v22.4.0  (>=20 required)
✔ Git               available
✔ Bash              available
✔ Platform          Claude Code (.claude/)
✔ Skills installed  comet, comet-open, comet-design, comet-build,
                    comet-verify, comet-archive, comet-hotfix, comet-tweak
✔ OpenSpec skills   installed
✔ Superpowers skills installed
✔ Scripts           comet-guard.sh, comet-env.sh, comet-handoff.sh,
                    comet-archive.sh, comet-yaml-validate.sh, comet-state.sh
✔ Working dirs      docs/superpowers/specs/  docs/superpowers/plans/

All checks passed. Comet is ready.
如果某项检查显示 ✗，输出会包含建议修复方式。重新运行 comet init，或查看 CLI Reference 了解修复选项。

​
Step 5：打开你的 AI 编程工具并输入 /comet

启动你的 AI 编程工具（Claude Code、Cursor、Windsurf 等），打开项目，然后输入： 
/comet
Comet 的主入口 skill 会自动运行。它会：
  1. 扫描 active specs — 在 openspec/changes/ 中查找进行中的变更。
  2. 读取 .comet.yaml — 判断当前工作流阶段（open、design、build、verify 或 archive）。
  3. 分发到正确的 sub-skill — 如果还没有 spec，则进入 /comet-open；否则进入适当的 phase skill 来恢复中断的工作流。
  4. 显示选择列表 — 如果找到多个 active specs，让你选择要继续哪一个。
对于没有 active spec 的全新项目，/comet 会启动 Phase 1（/comet-open），并询问你想要进行的变更。
你也可以直接调用各阶段：/comet-open、/comet-design、/comet-build、/comet-verify、/comet-archive。不过推荐入口是 /comet，因为它会验证阶段前置条件并防止乱序执行。

​
使用 OpenClaw、Hermes 或其他 Generic Platforms

对于直接使用通用 skills CLI 的平台（例如 OpenClaw 和 Hermes），使用以下命令安装 Comet skill package： 
npx skills add rpamis/comet
npx skills add rpamis/comet 使用通用 skills registry，不需要全局安装 Comet。它会把 Comet skill bundle 直接安装到平台的 skills 目录中。

​
保持 Comet 最新

若要获取最新功能和修复： 
comet update
或者直接更新 npm package： 
npm install -g @rpamis/comet@latest
comet update 会刷新 npm package，以及所有检测到的 project 和 global targets 中已安装的 skill files。

​
下一步

Workflow Deep Dive

了解五个阶段、guard conditions、state machine 和 preset paths。

Platforms

查看全部 28 个支持的 AI 编程平台及其 skills 目录路径。

CLI Reference

查看 comet init、comet doctor、comet status 和 comet update 的完整选项。

Scripts Overview

了解 guard、handoff、state 和 archive scripts 如何保护你的工作流。