兼容范围包含国内外 AI 编码工具、IDE 插件、CLI、远程及云端工作区。CodeBuddy、Qoder、Trae 是明确支持的目标。根 SKILL.md 是唯一通用原则正文;根据当前宿主部署原生 Skill、导入技能或转换成原生规则/自定义指令。日常任务无需手动引用仓库规则。
工具目录 包含 88 个具体宿主配置,另有未列出工具的通用接入流程。每项记录产品、作用域、入口、选择机制、来源与注意事项;这不是本机已安装工具清单。
核对日期:2026-10-11。vendor-docs 表示厂商文档已核对;installer-registry 表示 Vercel Skills 安装器源码 声明了入口,实际宿主版本仍需确认。源码抓取的 SHA-256 保留在 JSON,动态 main 链接不当作固定版本证据。目录信息、原生发现、模型表现分别验收。
~ 是当前执行端的用户目录;${VAR:-default} 表示配置根可能随环境变量变化,不能照字面创建目录。Windows 使用实际用户目录及宿主路径规则。远程容器、SSH、云端在实际运行 Agent 的环境解析路径。
下表技能目录均再包含 agent-coding-guidelines/SKILL.md、LICENSE 和 references/{clarify,plan,verify}.md。
| 产品 / 目录 ID | 用户级 | 项目级或原生导入 | 加载与注意事项 | 依据 |
|---|---|---|---|---|
CodeBuddy Code / CLI codebuddy |
~/.codebuddy/skills/ |
.codebuddy/skills/ |
描述匹配;检查 skillOverrides 和禁用状态,保留其他设置 |
CLI Skills |
CodeBuddy IDE / 插件 codebuddy-ide |
用当前 IDE 技能管理/导入确定位置 | .codebuddy/skills/ |
发现不等于调用;按下文配置开发任务短触发 Rule,不把 CLI 用户目录泛化到 IDE | IDE Skills |
Qoder CLI qoder |
~/.qoder/skills/ |
.qoder/skills/ |
/skills reload;CLI 文档规定同名用户技能优先 |
CLI Skills |
Qoder CN CLI qoder-cn |
${QODERCN_CONFIG_DIR:-~/.qoder-cn}/skills/ |
.qoder/skills/ |
厂商确认配置根,安装器声明 skills 入口;确认当前 CLI 发现结果 | 配置作用域、安装器 |
Qoder IDE qoder-ide |
Extensions → Skills → Add Skills → Upload Skill | 导入 SKILL.md 或 ZIP |
官方提供导入机制,未给磁盘路径;按 Installed 及 / 建议验收 |
Skills |
Qoder CN IDE qoder-cn-ide |
使用 CN 客户端的同名导入入口 | 原生导入 | 不与 CLI、旧 Lingma 路径混用 | CN Skills |
QoderWork / CN qoderwork / qoderwork-cn |
~/.qoderwork/skills/ |
也支持原生上传;未确认项目级目录 | 描述匹配,可把仓库链接交给它安装 | QoderWork、CN |
TRAE CN IDE trae-cn |
~/.trae-cn/skills/ |
.trae/skills/;或启用项目 .agents/skills/ 导入开关 |
自动选择;同名 .trae 优先于 .agents。未确认读取用户 ~/.agents/skills |
CN Skills |
TRAE 国际版 IDE trae |
~/.trae/skills/ |
.trae/skills/ |
安装器声明入口;国际文档本次未能读取,安装时确认当前客户端 | 安装器 |
Lingma / 旧 Qoder CN IDE lingma |
~/.lingma/skills/ |
.lingma/skills/ |
该代文档入口,同名项目优先,不能泛化到新 CLI/IDE | 技能指南 |
Kimi Code CLI kimi-code-cli |
~/.agents/skills/ |
.agents/skills/ |
模型选择;同时检查 Kimi 专属根及 KIMI_CODE_HOME,避免重名 |
Kimi Skills |
Qwen Code qwen-code |
~/.qwen/skills/ |
.qwen/skills/ |
安装器入口;先核对当前版本功能及启用状态 | 安装器 |
iFlow CLI iflow-cli |
~/.iflow/skills/ |
.iflow/skills/ |
文档要求 SKILL.md,管理结果可能显示 skill.toml 注册;用 /skills list、/skills refresh 验收 |
iFlow |
| CodeArts Agent / MiniMax Code / ZCode | 各自专属根 | 各自项目技能目录 | 安装器声明的独立目标,不根据模型供应商推断加载路径 | 工具目录 |
百度 Comate / Zulu comate |
本次只确认项目规则 | .comate/rules/*.mdr,用原生界面创建 |
导入转换正文,保留界面生成的元数据;也读取 Cursor 规则,先查等价内容 | Comate Rules |
| 产品 / 目录 ID | 用户级 | 项目级 | 依据与差异 |
|---|---|---|---|
Codex codex / Cursor cursor |
~/.agents/skills/ |
.agents/skills/ |
Codex、Cursor;检查专属及兼容目录,已有共享入口不再复制 |
Copilot in VS Code copilot-vscode |
~/.agents/skills/ |
.agents/skills/ |
VS Code Skills;CLI 是独立目标 |
Claude Code claude-code |
${CLAUDE_CONFIG_DIR:-~/.claude}/skills/ |
.claude/skills/ |
Claude Code;不等于 Desktop 或网页版 |
Cline cline |
~/.cline/skills/ |
.cline/skills/ |
Cline;厂商路径与安装器不同,采用厂商原生目录;同名全局优先 |
Windsurf / Cascade windsurf |
~/.codeium/windsurf/skills/ |
.windsurf/skills/ |
Cascade;检查 Devin 兼容入口 |
| Continue / Roo / Kilo | 见各自工具目录 | 见各自工具目录 | 安装器 声明的目标;版本及开关按宿主确认 |
| Gemini CLI / Antigravity / Amp / OpenCode | 见各自工具目录 | 部分共用 .agents/skills/ |
公共项目目录不意味着公共用户目录;配置根分别确认 |
| Junie / Kiro CLI / Augment / Droid / Goose / Zed / Warp | 见各自工具目录 | 见各自工具目录 | 独立产品入口;Junie 不等于 JetBrains AI Assistant,Kiro CLI 不等于 IDE |
Amazon Q Developer IDE amazon-q-ide |
未确认用户级 | .amazonq/rules/agent-coding-guidelines.md |
项目规则,常驻加载项目聊天上下文 |
JetBrains AI Assistant jetbrains-ai |
本入口使用项目规则 | .aiassistant/rules/agent-coding-guidelines.md |
项目规则,支持时选择 By model decision 并填入技能描述;默认 Always 成本不同 |
Aider aider |
现有用户配置 read 可指向实际绝对路径 |
AGENT_CODING_GUIDELINES.md,合并至 .aider.conf.yml 的 read |
配置;保留其他配置及 read 项 |
更多宿主完整列在 工具目录:AiderDesk、AstrBot、IBM Bob、Codemaker、Code Studio、Command Code、Cortex Code、Crush、Deep Agents、Devin Terminal、Dexto、Eve、Firebender、ForgeCode、fx、Grok Build、Hermes、inference.sh、Jazz、Kimchi、Kode、Loaf、MCPJam、Mistral Vibe、Moxby、Mux、OpenClaw、OpenHands、Ona、Pi、Posit Assistant、Replit、Reasonix、Rovo Dev、Sarvam Code、Tabnine CLI、Terramind、Tinycloud、Zencoder、Zenflow、Neovate、Pochi、PromptScript、AdaL、Autohand Code CLI、Antigravity CLI。
- 原生 Skills:只部署运行时文件——
SKILL.md、LICENSE与references/{clarify,plan,verify}.md(可用node scripts/pack-skill.mjs --out <dir>生成);不要复制benchmarks/、docs/、scripts/、profiles/。保留正常自动选择;确认启用状态、发现目录和技能列表。无额外运行时依赖。 - 原生技能导入:上传同一目录结构或 ZIP,在客户端完成导入并确认管理列表。若 UI 只接收单个
SKILL.md,先检查其是否支持引用文件;不支持时用规则型自包含正文,不能留下失效链接。无法操作 UI 时交付导入文件并报告待导入状态,磁盘暂存不能说成已安装。 - 规则 / 自定义指令:默认使用
scripts/export.mjs --format instructions,移除 YAML frontmatter,把双语 description 作为适用范围,保留完整根正文,只移除可选文件链接。需要参考细节时选择instructions-full,内联实际参考正文各一次并改为文内链接。两种方式检查引用有效性,均不维护另一份摘要。合并至原生入口或原生 UI 创建的规则正文;完整导出成本不同于原生 Skill 的按需文件读取。支持模型判断或文件作用域时使用相应机制,不同时启用 Skill 与等价规则。
安装 AI 根据当前宿主选择一个入口,用户无需日常手工引用。通用正文不绑定厂商 MCP 名、工具 API、hooks 或固定流程,也不改变宿主权限与实际加载优先级。
本节针对 CodeBuddy IDE/插件,CLI 的接口与配置另行核实。IDE Skills 文档说明名称与描述用于选择,正文在触发后加载。因此,模型看到技能清单仍可能直接使用普通编码工具。安装本技能用于日常开发时,配置一个短原生触发入口,保持 Skill 正文只有一份。
- 先确认
agent-coding-guidelines已被当前客户端发现、启用且可读取,并核对原生 Skill 工具。下面示例适用于已确认提供use_skill、参数为command的版本;其他版本按实际接口适配,不能仅据 CLI 文档猜测 IDE 能力。 - 在安装请求授权的用户级或项目级作用域中,优先把下面的正文合并到已有始终应用的 Rule。若没有合适规则,通过当前客户端原生机制创建;保留其合法元数据。用户规则位置由目标界面或现有有效配置确认,项目规则使用
.codebuddy/rules/<name>/RULE.mdc。写入前备份并比较,不覆盖整份自定义规则。
---
description: 开发任务自动加载 agent-coding-guidelines
alwaysApply: true
enabled: true
---
软件开发与代码相关任务开始相关工作前,若当前上下文尚未加载 agent-coding-guidelines 正文,必须先调用 use_skill,command 为 agent-coding-guidelines;已加载时不重复调用。普通聊天与非技术写作不触发。
参考文件按任务需要读取。加载失败时如实说明,按宿主现有规则继续,不声称已加载,也不重复无效调用。
- 仅保留一个触发入口,不复制四原则或
references/正文;现有 Plan、验证分级及权限机制继续生效。短触发 Rule 与 Skill 是入口和正文的关系,不是两份等价规范。选择完整规则型部署的宿主无需再配置这个 Skill 触发入口。 - 按IDE Rules 文档新建会话使规则生效。用未点名技能的开发任务检查实际
use_skill调用和后续行为,不能把模型自报“已使用”当成调用证据。路由提示仍依赖模型执行,不保证每次调用或更低费用;验收状态和缺项应如实报告。
不要为了触发 Skill 添加 MCP、Hook、子代理或重复常驻正文。具体用例见验证说明。
- Cursor Rules 区分项目
.cursor/rules/*.mdc、UI 用户规则、文件 glob 和智能体请求;Skills 确认本机用户~/.agents/skills/自动发现、正文按相关性选择;Commands 是/手动调用入口,不适合作为本技能的默认加载方式。Plan Mode 已提供复杂任务规划,小改动可直接执行。 - OpenAI Docs:AGENTS.md 负责目录层级指令;Skills 确认用户级
~/.agents/skills/、名字/描述的初始发现与正文按需读取。用户/项目设置用 config.toml,Sandbox 与审批 属于宿主权限层,技能不得覆盖。 - CodeBuddy IDE Rules 将
alwaysApply原文常驻与按描述请求区分;CodeBuddy Skills 有自己的用户/项目入口。Cline Skills 使用~/.cline/skills/,并有独立启用开关。不能假设它们都读取 Cursor/Codex 的公共用户目录。 - VS Code 文件指令 使用
.github/instructions/*.instructions.md的applyTo;它与 Cursor.mdc不是同一语法。本仓库只输出适配内容,不默认写入任一项目。
已有 Node.js 的维护者可使用以下只读辅助命令。安装 AI 也可直接读取 JSON 并复制或转换正文,Node.js 不是必装依赖:
node scripts/compatibility.mjs --tool codebuddy
node scripts/compatibility.mjs --list
node scripts/export.mjs --format skill
node scripts/export.mjs --format instructions只输出结果,不扫描应用、不改配置、不联网。instructions 不生成宿主元数据:Comate 的 .mdr 应先在界面生成,再替换正文,不能用纯 Markdown 覆盖整个文件。更新源技能后重新转换,不维护第二份规范正文。
CodeGeeX、MarsCode、WorkBuddy、Cody、Tabnine IDE,以及 ChatGPT、Claude 网页、DeepSeek、豆包、腾讯元宝、Kimi 网页、Bolt、Lovable、v0 等,按当前版本核实原生 Skills、项目知识、自定义指令、Agent 系统提示或规则入口,使用同一正文的相应形式。本表没有确认这些产品的磁盘路径,不能据此创建猜测目录。
新工具沿用接入流程,不以白名单限制兼容范围:确认产品/端型/版本 → 核实官方定制机制或真实宿主发现接口 → 选择 Skill/导入/规则 → 安装一份 → 验收。文档不足时从宿主界面或诊断证据确认并记录来源,未确认的路径不得自动写入。
只有会话提示入口时,提供转换正文供编码会话加载并明确会话级作用域。无持久定制机制的产品无法由仓库补出全局自动安装功能,不能承诺永久生效或隐瞒导入、登录、原生权限步骤。
检查用户、项目及兼容目录里的同名/同义技能、原 Karpathy、旧路由和常驻指令。一个宿主读取同一正文一次;多个宿主明确支持的公共目录可以共享。公共配置不是所有工具都读的统一系统目录,不通过改名保留等价副本。
权限、项目及目录指令遵循宿主原生优先级,不发明跨工具覆盖顺序。Qoder CLI 和 Cline 的上述文档为同名用户优先,Lingma 该代文档为项目优先,Trae 原生项目技能优先于项目共享目录。正文尊重项目指令的要求不会改变原生解析器。
覆盖或移除前,备份原文件、权限、软链接目标及涉及的配置字段到发现目录之外,记录原路径与哈希。回滚先比较后续用户修改,只还原本次影响的文件/字段;新增且未再修改的文件才可移除。安装不能覆盖权限、MCP、hooks、插件、业务规则,也不能恢复用户已卸载的应用。
文件正确 → 宿主发现或规则附加 → 隐式选择 → 行为 → 实际 token/费用,分别记录。转换测试只能证明正文完整、查询区分产品且不写配置,不能证明 88 个客户端全部运行通过。详见 验证说明。