支持的平台

Comet 会把 Skill、Rules、Hooks 安装到目标 AI 编码平台的约定目录。你可以在 comet init 里选择一个或多个平台。Comet 目前支持 38 个 AI 编码平台。

全部平台一览

下表列出所有平台、平台 id（用于 CLI --platform <id>）、项目级 Skill 目录、全局 Skill 目录，以及各自支持的能力。

完整能力（Skill + 规则 + hooks）

平台	平台 id	项目目录	全局目录	规则格式	Hooks	说明
Claude Code	`claude`	`.claude`	`.claude`	`md`	✅ `claude-code`	参考平台，支持 PreToolUse hooks
Codex	`codex`	`.agents`	`.agents`	`md`	✅ `claude-code`	Skill 使用 `.agents/skills`；配置、规则和 hooks 保留在 `.codex`
Amazon Q Developer	`amazon-q`	`.amazonq`	`.amazonq`	`md`	✅ `claude-code`	复用 claude-code hook 格式
Devin Desktop（原 Windsurf）	`windsurf`	`.devin`	`.devin`	`md`	✅ `windsurf`	写入 `pre_write_code` hooks；旧项目自动识别 `.windsurf`
GitHub Copilot	`github-copilot`	`.github`	`.github`	`copilot`	✅ `copilot`	用 `.github/instructions/*.instructions.md`
Gemini CLI	`gemini`	`.gemini`	`.gemini`	无（GEMINI.md）	✅ `gemini`	唯一无规则目录但支持 hooks 的平台
Qwen Code	`qwen`	`.qwen`	`.qwen`	`md`	✅ `qwen`
Qoder	`qoder`	`.qoder`	`.qoder`	`md`	✅ `qoder`	与 qwen 共享 PreToolUse 处理
Kiro	`kiro`	`.kiro`	`.kiro`	`md`（steering）	✅ `kiro`	规则在 `.kiro/steering/`，hook 是独立 `.kiro.hook` 文件
Grok	`grok`	`.grok`	`.grok`	`md`	✅ `claude-code`	Skill 在 `.grok/skills/`，规则在 `.grok/rules/`，hook 写入 `.grok/hooks/comet.json`；OpenSpec 输出按 Codex 生成并镜像到 `.grok`
Oh My Pi	`oh-my-pi`	`.omp`	`.omp/agent`	`mdc`	✅ `omp`	Skill 在 `.omp/skills/`，规则使用 always-apply MDC，Hook 使用 `.omp/hooks/pre/comet-hook-router.ts` 扩展模块
CodeBuddy	`codebuddy`	`.codebuddy`	`.codebuddy`	`md`	✅ `codebuddy`	规则写入 `.codebuddy/rules/`；PreToolUse hook 合并到 `settings.json`，保留用户已有配置
DeepSeek Harness	`dsh`	`.dsh`	`.dsh`	`dsh`	✅ `dsh`	使用 Claude 兼容的 OpenSpec 集成；规则写入托管 `AGENTS.md` 块，Hook 配置写入 `hooks.json`
Trae	`trae`	`.trae`	`.trae`	`md`	✅ `trae`	Hook 写入 `.trae/hooks.json`，使用版本化的 `PreToolUse` 分组
Trae CN	`trae-cn`	`.trae-cn`	`.trae-cn`	`md`	✅ `trae`	Skill 使用 `.trae-cn`；项目级 Hook 写入 `.trae/hooks.json`，全局 Hook 写入 `.trae-cn/hooks.json`
ZCode	`zcode`	`.zcode`	`.zcode`	`md`	✅ `zcode`	基于 OpenCode；0.4.2 起 Hook 写入 `.zcode/config.json` 的 `PreToolUse` process hook，安装时打开 `hooks.enabled`，全局 Hook 写入 `~/.zcode/cli/config.json`

Skill + hooks（无规则）

平台	平台 id	项目目录	全局目录	Hooks	说明
WorkBuddy	`workbuddy`	`.workbuddy`	`.workbuddy`	✅ `codebuddy`	把 PreToolUse hook 合并到 `.workbuddy/settings.json`，保留用户已有配置

Skill + 规则（无 hooks）

平台	平台 id	项目目录	全局目录	规则格式	说明
Cursor	`cursor`	`.cursor`	`.cursor`	`mdc`	唯一使用 Cursor MDC frontmatter 格式的平台
OpenCode	`opencode`	`.opencode`	`~/.config/opencode`	`md`	OpenCode 风格 slash 命令，全局目录与项目不同
Cline	`cline`	`.cline`	`.cline`	`md`	规则在项目根的 `.clinerules/`，不在 `.cline/` 内
RooCode	`roocode`	`.roo`	`.roo`	`md`
Continue	`continue`	`.continue`	`.continue`	`md`
Kilo Code	`kilocode`	`.kilocode`	`.kilocode`	`md`
Auggie	`auggie`	`.augment`	`.augment`	`md`	Augment CLI
Lingma	`lingma`	`.lingma`	`.lingma`	`md`
MimoCode	`mimocode`	`.mimocode`	`~/.config/mimocode`	`md`	基于 OpenCode，OpenCode 风格 slash 命令 + 镜像 OpenSpec 输出

仅 Skill（无规则、无 hooks）

平台	平台 id	项目目录	全局目录	说明
Kimi Code	`kimicode`	`.kimi-code`	`.kimi-code`	OpenSpec 工具 id 为 `kimi`
Junie	`junie`	`.junie`	无全局目录
CoStrict	`costrict`	`.cospec`	无全局目录	目录名与 id 不同
Crush	`crush`	`.crush`	无全局目录
Factory Droid	`factory`	`.factory`	无全局目录
iFlow	`iflow`	`.iflow`	无全局目录
Prime Agent	`prime-agent`	`.prime/agent`	`~/.prime/agent`	Skill 安装在项目目录和全局目录下的 `skills/`。
Pi	`pi`	`.pi`	`~/.pi/agent`	全局目录是子目录
Antigravity	`antigravity`	`.agents`	`~/.gemini/antigravity`	项目和全局目录完全不同，支持 CodeGraph
Antigravity 2.0	`antigravity2`	`.agents`	`~/.gemini/config`	与 Antigravity 共享项目级 `.agents/`，全局走 `~/.gemini/config`
Bob Shell	`bob`	`.bob`	无全局目录
ForgeCode	`forgecode`	`.forge`	无全局目录	目录名与 id 不同

小鱼把 Claude Code、Codex、Cursor、Devin Desktop、Gemini CLI、GitHub Copilot 和 OpenCode 等平台卡片放入能力分层手账

平台支持按 Skill、规则和 hooks 逐层增强

能力汇总

规则格式

Comet 支持四种规则格式：

格式	使用平台
`md`	绝大多数支持规则的平台
`mdc`	Cursor 和 Oh My Pi；Oh My Pi 使用 always-apply MDC
`copilot`	仅 GitHub Copilot
`dsh`	仅 DeepSeek Harness；写入托管 `AGENTS.md` 块

Hooks 格式

当前列表中的 17 个 Hook 平台使用 12 种 hook 格式：

Hook 格式	写入文件	使用平台
`claude-code`	`settings.local.json`	Claude Code、Codex、Amazon Q、Grok
`qwen`	`settings.json`	Qwen Code
`qoder`	`settings.json`	Qoder
`codebuddy`	`settings.json`	CodeBuddy、WorkBuddy
`gemini`	`settings.json`	Gemini CLI
`windsurf`	`hooks.json`	Devin Desktop（原 Windsurf）
`copilot`	`hooks/<id>.json`	GitHub Copilot
`kiro`	`hooks/<id>.kiro.hook`	Kiro
`omp`	`hooks/pre/comet-hook-router.ts`	Oh My Pi
`dsh`	`hooks.json`	DeepSeek Harness
`trae`	`hooks.json`	Trae、Trae CN
`zcode`	`config.json`	ZCode

DeepSeek Harness 的 Hook 激活

DSH 的工作流保护需要官方 Hook bridge 加载 Comet 配置。项目级安装或更新后，使用项目 patch 启动 DSH：

dsh --patch .dsh/cordis.patch.yml

全局安装会为已有 profile 配置 bridge；重启 DSH 后生效。新增 profile 后，再运行 comet update --scope global。更新会迁移 Comet 管理的旧 patch，并保留其他配置。运行 comet doctor 检查 bridge 配置和激活提示。配置文件存在不代表当前 Agent 平台已加载 Hook；按提示启动后，工作流保护会检查 write 和 edit 操作，在 Windows PowerShell 下拒绝写入的结果同样生效。

OpenCode 系平台

OpenCode、ZCode、MimoCode 都基于 OpenCode 运行时，支持 OpenCode 风格 slash 命令和镜像 OpenSpec 输出：

平台	镜像行为
OpenCode	原生支持
ZCode	把 `.opencode/{skills,commands}` 迁移镜像到 `.zcode/`
MimoCode	镜像 OpenSpec 输出到 `.mimocode/`

特殊安装路径

平台	项目级目录	全局目录
Codex Skill	`.agents`	`~/.agents`
OpenCode	`.opencode`	`~/.config/opencode`
MimoCode	`.mimocode`	`~/.config/mimocode`
Antigravity	`.agents`	`~/.gemini/antigravity`
Antigravity 2.0	`.agents`	`~/.gemini/config`
Pi	`.pi`	`~/.pi/agent`

其他平台的全局安装使用同名目录（如 Claude Code 全局为 ~/.claude，CodeBuddy 全局为 ~/.codebuddy，WorkBuddy 全局为 ~/.workbuddy）。Junie、CoStrict、Crush、Factory Droid、iFlow、Bob Shell、ForgeCode 不支持全局安装。

WorkBuddy 项目级 Skill 位于 .workbuddy/skills/，用户级 Skill 位于 ~/.workbuddy/skills/。阻塞 Hook 只写入项目级 .workbuddy/settings.json ；全局安装不会添加全局阻塞 Hook，因此不需要项目外的 Hook 配置。

Codex 的 Skill 发现根与配置根不同：项目和全局 Skill 使用 .agents/skills，Codex 专属配置、规则、hooks 和插件缓存仍位于 .codex。0.4.0-beta.4 的 update/uninstall 会迁移 Comet 管理的旧 .codex/skills 安装，并保留其他 Skill 和共享目录。0.4.0-beta.5 起，Codex 的阶段守卫 hook 改写到受支持的 .codex/hooks.json。Grok 同样使用 claude-code hook 格式，但写入 .grok/hooks/comet.json ，并额外匹配 Grok 原生的 write/search_replace 工具。

Antigravity 和 Antigravity 2.0 共享项目级的 .agents/ Skill 目录，所以 comet init 自动检测时会同时选中两者。如果你只想给其中一个安装，可在交互式安装流程（不加 —yes ）里手动取消勾选另一个。

comet init 会自动检测项目里已存在的平台配置目录并预选。你也可以用 --yes 跳过交互，自动安装到所有检测到的平台。

选择项目级还是全局

安装范围	适合场景	特点
project	团队项目、仓库约定、需要提交配置	配置写入当前项目，便于协作
global	个人默认环境、多个项目共享	配置写入用户目录，切项目更省事

如果你不确定，先用项目级安装：团队成员会共享同一套配置，行为保持一致。

安装模式：复制 vs 符号链接

comet init 和 comet update 在选择平台后，会询问安装模式（install mode）。0.4.0-beta.1 起新增了符号链接（symlink）模式：

模式	行为	适合
Copy（复制，默认）	把每个平台的 Skill、规则和脚本独立复制一份到目标目录	传统方式、需要平台间互相隔离、跨设备同步（提交到仓库）
Symlink（符号链接）	在目标平台的现有 `skills/` 目录内链接 Comet 管理的 Skill，共享 `.comet/skills/` 中央存储	多平台开发、节省磁盘空间、想一次更新所有平台

Symlink 模式的工作方式

选择 Symlink 后，Comet 不再为每个平台复制一份 Comet Skill，而是在各平台已有的 skills/ 目录中为 Comet Skill 创建指向项目中央 .comet/skills/ 的符号链接：

.comet/skills/          ← 中央存储（唯一一份）
├── comet-open/
├── comet-design/
└── ...
.claude/skills/comet-*  →  .comet/skills/comet-*   （Comet 创建的符号链接）
.cursor/skills/comet-*  →  .comet/skills/comet-*   （Comet 创建的符号链接）
.agents/skills/comet-*  →  .comet/skills/comet-*   （Comet 创建的符号链接）

运行 comet update 时只需更新中央存储，所有平台立即生效。终端摘要会显示 symlink created 或 symlink creation failed。

符号链接依赖文件系统支持。某些 Windows 配置或同步工具（如部分云盘）可能不正确处理符号链接。如果遇到问题，回退到 Copy 模式即可。

如果目标平台已有自己的 skills/ 目录，Comet 会保留目录和其中的本地/第三方 Skill，只创建或刷新 Comet 管理的链接。

选择哪种模式不影响 Comet 的行为，只影响文件如何落到磁盘。提交到仓库时，Copy 模式会产生真实文件；Symlink 模式产生的是符号链接（通常需要团队成员各自 comet init）。

通用 skills 注册表平台

有些 AI 编码平台通过通用 skills CLI 注册表管理 Skill。对这些平台（包括 OpenClaw、Hermes 等），直接用通用命令安装 Comet skill 包：

npx skills add rpamis/comet

这条命令从通用 skills 注册表拉取 Comet skill 包并安装到平台期望的位置，不需要全局 Comet 安装。它和 comet init 可以并存。

hooks 和可执行能力

部分平台支持 hooks。Comet 会合并自己管理的 hook 配置，保留用户已有配置。如果文件中已经有插件、hook 或其他用户设置，Comet 会保留这些内容；如果 JSON 无法解析，安装会直接报错失败，并保持原文件不变。

安装后验证（非必须）

comet doctor

如果平台目录、Skill 文件、脚本或 hooks 缺失，doctor 会给出诊断。需要更新时运行：

comet update

入门

理解 Comet Native

进阶

实践场景

全部平台一览

完整能力（Skill + 规则 + hooks）

Skill + hooks（无规则）

Skill + 规则（无 hooks）

仅 Skill（无规则、无 hooks）

能力汇总

规则格式

Hooks 格式

DeepSeek Harness 的 Hook 激活

OpenCode 系平台

特殊安装路径

选择项目级还是全局

安装模式：复制 vs 符号链接

Symlink 模式的工作方式

通用 skills 注册表平台

hooks 和可执行能力

安装后验证（非必须）

​全部平台一览

​完整能力（Skill + 规则 + hooks）

​Skill + hooks（无规则）

​Skill + 规则（无 hooks）

​仅 Skill（无规则、无 hooks）

​能力汇总

​规则格式

​Hooks 格式

​DeepSeek Harness 的 Hook 激活

​OpenCode 系平台

​特殊安装路径

​选择项目级还是全局

​安装模式：复制 vs 符号链接

​Symlink 模式的工作方式

​通用 skills 注册表平台

​hooks 和可执行能力

​安装后验证（非必须）

全部平台一览

完整能力（Skill + 规则 + hooks）

Skill + hooks（无规则）

Skill + 规则（无 hooks）

仅 Skill（无规则、无 hooks）

能力汇总

规则格式

Hooks 格式

DeepSeek Harness 的 Hook 激活

OpenCode 系平台

特殊安装路径

选择项目级还是全局

安装模式：复制 vs 符号链接

Symlink 模式的工作方式

通用 skills 注册表平台

hooks 和可执行能力

安装后验证（非必须）