AI Comet 技能系统

可以把 @rpamis/comet 想象成给 AI 程序员（比如 OpenCode）请的一位 "项目经理" 。它自己不写代码，但负责制定流程、监督进度、保管文档，确保你的 AI 助手不会"放飞自我"。

它的核心思想是把一个开发任务，拆解成 "开启 → 设计 → 构建 → 验证 → 归档" 这五个标准步骤。每一步都有明确的输入和输出，并且有"守卫"把关，必须完成当前步骤才能进入下一步，防止 AI 偷懒或跳步。

🛠️ 准备工作：环境与安装

在开始前，先确保你的电脑准备好了：

Windows 用户注意

Comet 的脚本是 bash 写的，需要用 Git Bash 来运行。

• Node.js 20+ 和 npm
• Git
• OpenCode：确保你已经在项目里运行过 /init，让 OpenCode 了解了项目结构

一切就绪后，就可以开始了。

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

在终端（Windows 用户请用 Git Bash）执行：

npm install -g @rpamis/comet

输入与输出

【输入】：这条命令。

【输出】：npm 会开始下载并全局安装 @rpamis/comet 命令。

步骤 2：在项目中初始化 Comet

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

cd your-project
comet init

输入与输出

【输入】：comet init 命令。

【输出】：Comet 会启动一个交互式的设置向导，依次问你几个问题：

1. 选择 AI 平台：它会自动检测到你电脑上的 AI 编程工具。用空格键选中 OpenCode 然后按回车。
2. 选择安装范围：选 project（项目），这样 Comet 只影响当前项目。
3. 选择技能语言：选 zh（中文） 或 en（英文）都可以。
4. 选择 Comet 模式：
   • Native：轻量模式，适合 Claude 4 这类顶级模型，流程自由度高。
   • Classic：严谨模式，流程严格，适合小模型或高合规性项目。
   • 两者：两种模式都安装。

选择完成后，Comet 会自动完成安装。

🚀 核心工作流：项目经理的"五步法"

初始化成功后，你会在项目根目录看到一个 .comet.yaml 文件，它就是 Comet 的"账本"，记录着项目的所有进度。

现在，打开 OpenCode，开始你的开发任务吧。

👋 阶段 0：一切开始的地方 入口

输入与输出

【输入】：在 OpenCode 的对话框里输入 /comet。

【输出】：Comet 会"复活"，读取 .comet.yaml，告诉你当前项目处于哪个阶段，并提示你下一步该做什么。

📝 阶段 1：开启 (Open) 开启

• 命令：/comet-open
• 主导者：OpenSpec

输入与输出

【输入】：用自然语言向 AI 描述你的需求，比如："开发一个用户登录功能"。

【输出】：AI 会生成一系列文档：

• 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 产出的技术方案和任务清单。

【输出】：AI 开始编写实际的代码，并完成提交。

✅ 阶段 4：验证与收尾 (Verify & Finish) 验证

• 命令：/comet-verify
• 主导者：Comet 和 Superpowers

输入与输出

【输入】：阶段 3 写好的代码。

【输出】：AI 会执行测试、代码审查等，输出一份验证报告。

📦 阶段 5：归档 (Archive) 归档

• 命令：/comet-archive
• 主导者：OpenSpec

输入与输出

【输入】：所有阶段的产出物。

【输出】：将最终的规格文档归档，项目历史清晰可追溯。

💡 高级功能

• /comet status：随时查看项目进度和下一步该做什么。
• /comet-any：一个"万能"命令，可以自由组合不同的技能（Skills）来创建自定义工作流。
• comet codegraph：给 AI 配备一副"透视眼镜"，能快速理解整个项目的代码结构和关系。可以在 comet init 时选择安装。

---

总的来说，@rpamis/comet 就是一套用代码固化的、可恢复的、自动化的 AI 编程工作流。它把一次不可控的"即兴对话"，变成了一条有流程、有记录、可恢复的标准化工程流水线。