企业官网建设流程全解析

如何让Comet适配任意AI平台？一条命令支持37款AI编码工具的完整安装指南

【免费下载链接】cometComet: agent skill harness for turning ideas into evaluated workflows项目地址: https://gitcode.com/rpamis/comet

Comet 是面向 Coding 的可恢复长程任务工作流与 Skill 平台，comet init一条命令即可将 Comet 工作流安装到 Claude Code、Cursor、Codex 等37 款 AI 编码平台，自动写入对应平台的技能目录、规则与 Hook，无需手动复制任何文件。

本文是一份面向新手和资深开发者的完整安装指南：先解释一条命令如何适配所有平台，再给出逐步安装步骤、37 款平台完整清单、进阶参数、其他平台的接入方式，以及安装后的验证与更新卸载方法。

为什么一条命令能适配37款AI编码平台

不同 AI 编码工具读取"技能"的位置并不相同：Claude Code 看.claude/，Cursor 看.cursor/，Codex 看.codex/……如果为每个平台手工配置，极易出错。

Comet 把这件事抽象成了平台定义表 + 自动检测：

• 平台定义表：platform/install/platforms.ts#L113-L463 中集中定义了全部 37 个平台的技能目录、规则格式（md / mdc / copilot 等）、Hook 格式和检测路径。新增一个平台，只需在这张表中加一行配置。
• 自动检测：运行时由 platform/install/detect.ts#L119-L142 扫描项目目录，发现.claude/、.cursor/等目录就自动勾选对应平台，交互式列表里会标注"已检测"。
• 统一安装管线：app/commands/init.ts 按"检测平台 → 选择作用域/语言/工作流 → 拷贝 Skill、规则与 Hook → 输出结果摘要"的固定管线执行，每个平台独立汇报 installed / skipped / failed 状态。

也就是说，"一条命令"的本质是：你把 37 个平台的差异全部封装在了一张配置表里，用户只需要选择。

Comet安装步骤：3步完成任意AI编码平台配置

第1步：安装Comet CLI

前置要求（三件套缺一不可）：

全局安装 CLI：

npm install -g @rpamis/comet

第2步：在项目内运行 comet init

进入你的项目目录，执行初始化命令：

cd your-project comet init

交互式流程会依次让你选择 4 项内容，全部有默认值，直接回车也能完成：

1. 安装作用域（scope）：project（仅当前项目）或global（用户主目录，所有项目可用）
2. 工作流（workflow）：Native（面向强模型的自主规划流程）、Classic（OpenSpec + Superpowers 五阶段强约束流程）、两者
3. 平台（platforms）：已自动检测到的 AI 平台会预先勾选，可增减
4. 语言（language）：技能文档使用中文（zh）或英文（en）

执行完成后，终端会输出类似"已安装到.claude/skills/"的逐平台结果摘要，并提示下一步调用方式。下面的截图展示了在 Claude Code 中运行/comet与comet init的实际效果：

第3步：在AI工具中调用 /comet

打开任意一个已安装成功的 AI 编码工具（Claude Code、Cursor、Codex 等），在对话中直接输入：

/comet

/comet只读取项目的.comet/config.yaml配置，确定性地转发到你配置的 Native 或 Classic 永久入口，不会按任务大小"猜"工作流。

37款受支持AI编码平台完整清单

以下是 platforms.ts 中登记的完整平台与技能目录映射（项目级作用域）：

💡 注意个别平台的差异由 Comet 自动处理，例如 Cline 的规则写在项目根.clinerules/而非.cline/内，Grok 复用 Codex 的生成产物再镜像到.grok/，ZCode 复用 OpenCode 的配置结构——你无需关心这些细节。

同一个 Comet 工作流在不同宿主里表现一致：以 Codex 为例，Supervisor Change 可以让多个独立会话在隔离 worktree 中并行实现与验证，最终由 Runtime 按依赖顺序集成：

进阶参数：非交互式安装与全局作用域

comet init的完整参数在 app/cli/index.ts#L27-L53 中注册，日常最常用的有：

一条典型的非交互式命令长这样：

comet init --platform claude --platform cursor --scope project --workflow native --language zh --yes

其他AI平台也能接入：通用skills CLI安装

如果你的平台不在上面 37 款清单里，但支持通用的skillsCLI（例如 OpenClaw、Hermes 等），可以直接安装 Comet 的 Skill 包：

npx skills add rpamis/comet

这样你的平台也能加载/comet、/comet-any等核心技能入口。

安装完成后如何验证

安装成功不代表"能跑通"，建议做三个轻量检查：

1. comet status：查看项目当前活跃的 change 与工作流状态，确认配置读取正常
2. 在任一宿主中输入/comet：应看到 Comet 的工作流引导，而不是被当作普通聊天
3. 打开 Dashboard：comet dashboard在浏览器中提供统一的三栏面板，可查看所有工作区进度、下一步建议、任务进度与 Git 快照，是确认各平台接入状态最直观的方式：

版本更新与干净卸载

• 更新：comet update会为既有安装补齐新增的受管默认值，同时保留你的用户取值和未知扩展字段，升级无感
• 卸载：comet uninstall按 app/commands/uninstall.ts 的流程交互式选择目标平台与范围，精确移除 Comet 的 Skill、规则与 Hook，不会误删你自己的技能

🔁 日常只需记住两件事：装新平台 → 重新跑一次comet init勾上它；升级 →comet update。

常见问题FAQ

Q：项目里已有.claude/，comet init会覆盖我的配置吗？

不会。检测到已存在组件时，交互模式会询问覆盖还是跳过；--skip-existing可直接声明"绝不动已存在的组件"。

Q：可以同时给团队多台机器的不同平台安装吗？

可以。每台机器只需勾选本机使用的平台；--json输出方便接入团队脚本做批量初始化。

Q：为什么选 Native 时不让我选安装模式（copy/symlink）？

Native 工作流采用统一的 copy 模式以保证跨平台行为一致，symlink 选项仅对 Classic 流程开放。

Q：装完某平台后提示"未检测到"，怎么办？

检查该平台的技能目录是否已存在（首次使用需先在工具里打开过一次项目），或改用--platform <id>显式指定，无需等待自动检测。

小结

Comet 把"适配任意 AI 编码平台"做成了配置问题而非工程问题：37 款平台的目录差异沉淀在 platforms.ts 一张表里，detect.ts 负责自动发现，init.ts 负责统一安装。你只需要记住三步——npm install -g @rpamis/comet、comet init、/comet——即可把 Comet 的可恢复工作流接入日常任何一款 AI 编码工具。

【免费下载链接】cometComet: agent skill harness for turning ideas into evaluated workflows项目地址: https://gitcode.com/rpamis/comet