AI Comet 技能系统

概述

@rpamis/comet 是给 AI 程序员的"项目经理"：自己不写代码，负责制定流程、监督进度、保管文档，把不可控的"即兴对话"变成有流程、有记录、可恢复的标准化工程流水线。它提供 Native 与 Classic 两种相互独立的工作流，共享同一套阶段守卫：跨阶段写入被阻止、确认点不可跳过、状态可恢复。

---

一、准备工作：环境与安装

Comet 基于纯 Node.js Runtime，支持 Windows、macOS、Linux，无需 Bash 或 WSL。开始前请确保具备以下环境：

• Node.js 22.16+（22.x 版本线）或 24+
• npm 或 npx
• Git
• 受支持的 AI 编程平台：如 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、ZCode 等

步骤 1：安装 Comet 命令行工具

npm install -g @rpamis/comet

确认命令可用：

comet -v

步骤 2：在项目中初始化

进入你的项目目录，然后运行：

cd your-project
comet init

向导会自动检测本机的 AI 编程平台，安装 Skill、规则与阶段守卫，并引导你完成关键选择：

1. 选择工作流：Native（强模型，自主实现与验证）、Classic（完整 Spec 与阶段约束）或 两者（安装两个独立入口，/comet 默认走 Native）
2. 选择安装范围：project（写入当前项目，便于团队协作）或 global（写入用户目录，跨项目共享）
3. 选择安装模式（仅 Classic / 两者时询问）：copy（默认，为每个平台复制独立 Skill 文件）或 symlink（各平台软链到 .comet/skills/，一处更新处处生效）

非交互式安装的新项目默认使用 Native。也可跳过向导显式指定：

comet init --workflow classic
comet init --workflow both
comet init --scope global --workflow native

初始化完成后，项目配置统一生成在 .comet/config.yaml，记录默认工作流与各项设置；任务状态同样保存在项目中，因此中断或更换会话后可随时恢复。

---

二、核心工作流：从想法到交付

初始化成功后，在 AI 编程工具的对话框输入 /comet，Comet 读取项目配置进入对应工作流。两种模式不是轻量与重量的分级关系，也互不升级：

维度	Native	Classic
定位	强模型全自动编码	Spec 驱动，更多人工确认（HITL）
实现方式	模型自主规划、实现、测试、审查	OpenSpec + Superpowers 五阶段管控
适用场景	Fable 5、GPT-5.6 等强模型	流程要求严格的大型变更或能力较弱的模型

Native：强模型全自动

由 Loop Engineering 驱动，按以下循环运行：

1. 需求澄清：模型以结构化问题集中澄清需求
2. 目标 Spec：起草完整目标 Spec，由用户确认
3. 自动实现：模型在自动循环中自主规划、实现、测试与审查
4. 验证归档：Comet 守卫结果验证并支持可恢复归档

用户可读产物默认存放在 docs/comet/，也可通过 /comet-native 直接进入。

Classic：五阶段管控

五个阶段连接 OpenSpec 与 Superpowers，通过 Design Doc 和明确的确认点约束每个阶段——当前阶段任务未全部完成无法进入下一阶段：

阶段	命令	主导者	输入	输出
1 开启（Open）	/comet-open	OpenSpec	自然语言需求描述	proposal.md、design.md、tasks.md
2 设计（Deep Design）	/comet-design	Superpowers	阶段 1 的 design.md、tasks.md	详细技术方案（Design Doc，含实现思路与接口设计）
3 构建（Plan & Build）	/comet-build	Superpowers	阶段 2 的技术方案与任务清单	实际代码编写与提交
4 验证（Verify & Finish）	/comet-verify	Comet、Superpowers	阶段 3 的代码	测试、代码审查与验证报告
5 归档（Archive）	/comet-archive	OpenSpec	所有阶段产出物	归档规格文档，历史清晰可追溯

---

三、进阶功能

Skill 创建、评估与发布

• /comet-any："万能"命令，组合任意技能（Skills）创建自定义工作流，打包为可复用的 Skill Bundle
• comet eval：在隔离环境中用真实任务评估 Skill，基于 Rubric、Pass@k、Pass^k 多维打分（支持 LangSmith / Langfuse），为迭代提供依据
• comet publish：评审、发布并分发 /comet-any 产物

项目运维与可视化

• comet status / comet doctor：查看当前阶段与下一步操作；doctor 对安装做完整健康检查
• comet update：升级 npm 包并刷新已安装的 Skill、Rule、Hook、Runtime 与配置
• comet dashboard：在浏览器中查看 Native / Classic 进度、Git worktree、验收结果与归档，并可管理个人记忆与项目知识（只读）
• Supervisor Change：复杂需求按交付边界拆分为子变更，经依赖 DAG 排序后由 Codex 多会话或 Claude Code Agent Teams 在隔离 worktree 中并行实现与验证