如何让Skill同时跑在Cursor、Codex和Claude Code 里？

很多开发者在使用AI编程工具时都会遇到一个问题，自己精心配置的Skill只能在单一工具里生效，换到Cursor、Codex或者Claude Code里就要重新调整，非常浪费时间。其实这三个平台虽然产品形态不同，但对Skill的底层支持逻辑有共通之处，只要掌握可移植Skill的设计方法，就能让同一份配置在多个工具里稳定运行。

1、工具会变，经验别被工具锁住

AI编程工具更新迭代很快，今天可能主力用Cursor，明天团队切换到Claude Code，后天又需要对接Codex做自动化任务。如果Skill完全绑定某一个工具的规则，每次换工具都要重新写配置，本质上是在重复做低价值的工作。我们要做的是把Skill的核心逻辑和工具特有的适配层分开，核心逻辑保持稳定，只针对每个工具做少量适配，这样不管工具怎么变，你的经验都能复用。

2、三个平台其实在靠近同一种东西

先理清楚三个平台对Skill的支持逻辑：

• Cursor的Skill本质是给编辑器内的AI上下文补充规则、代码片段和约束条件，优先读取项目根目录的配置
• Codex的Skill围绕.agents目录展开，支持定义工具调用权限、任务流程和上下文模板
• Claude Code的Skill更偏向工具授权和任务边界定义，强调安全可控的AI操作范围

三者的共通点是都需要明确：Skill的适用场景、允许AI做的操作、禁止AI做的操作、需要补充的上下文信息，只要把这些内容抽象出来，就能做跨平台适配。

3、一份可移植 Skill 应该长什么样

可移植的Skill要分成三层：核心定义层、平台适配层、上下文补充层。

核心定义层建议用纯文本写清楚，比如一个处理STM32外设驱动的Skill，核心定义可以是：

Skill名称：STM32外设驱动移植
适用场景：同型号外设在不同STM32开发板之间移植驱动代码
允许操作：读取现有驱动代码、对比板级硬件差异、生成适配后的驱动代码
禁止操作：修改硬件无关的驱动核心逻辑、删除原有注释
输入要求：提供原驱动代码、目标板硬件手册对应章节
输出要求：生成适配后的驱动文件，标注修改点

4、Cursor 里不要只靠一条长规则

Cursor支持在项目根目录放.cursorrules文件，很多开发者会把所有Skill内容都堆进去，导致规则过长，AI反而抓不住重点。正确的做法是把核心定义层的内容放在.cursorrules里，平台适配层的内容单独放，比如针对STM32驱动移植的Cursor配置：

# .cursorrules 内容
你正在处理STM32外设驱动移植任务，遵循以下规则：
1. 仅修改和板级硬件相关的配置部分，不改动驱动核心逻辑
2. 生成代码时保留原有注释，新增修改点用// 移植修改：开头标注
3. 如果缺少目标板硬件信息，先询问用户再生成代码
4. 参考项目docs目录下的STM32F103到STM32F407移植示例

如果有多个Skill，可以在.cursorrules里用分块标注，避免规则混乱。

5、Codex 里把 .agents 当作一等入口

Codex优先读取项目根目录下的.agents目录，每个Skill对应一个子目录，目录里放配置和上下文。比如刚才的STM32驱动移植Skill，在Codex里的结构是：

.agents/
  stm32_driver_porting/
    config.json  # 平台适配配置
    context.md   # 上下文补充内容
    skill_def.txt # 核心定义层内容

其中config.json的适配内容可以参考：

{
  "skill_name": "stm32_driver_porting",
  "allowed_tools": ["read_file", "write_file", "list_dir"],
  "task_prompt": "根据skill_def.txt的规则完成STM32外设驱动移植，参考context.md里的示例",
  "output_path": "drivers/porting/"
}

6、Claude Code 里工具授权要谨慎

Claude Code对AI的工具调用权限管控更严格，配置Skill时要明确授权范围，避免AI越权操作。适配Claude Code时，核心定义层的内容要放在项目配置的Skill描述里，同时明确禁止的操作对应的工具权限不开放。比如针对STM32驱动移植的Claude Code配置：

# 在Claude Code项目配置里添加
Skill: STM32外设驱动移植
授权工具：文件读取、文件写入（仅限drivers目录）
禁止工具：删除文件、执行shell命令
规则：遵循核心定义层的约束，生成代码后先展示修改点，确认后再写入文件

7、一个可以长期维护的中文模板

给你一个通用的可移植Skill中文模板，写好后只需要根据三个平台的要求做少量适配：

# Skill核心定义（跨平台复用）
## 基础信息
名称：
适用场景：
版本：

## 功能约束
允许操作：
1. 
2. 
禁止操作：
1. 
2. 

## 输入输出规范
输入要求：
输出要求：

## 参考示例
路径：

# 平台适配（每个平台单独填）
## Cursor适配
.cursorrules补充内容：

## Codex适配
.agents目录结构：
config.json关键配置：

## Claude Code适配
授权配置：
规则补充：

8、最后真正要留下来的不是工具配置

折腾Skill跨平台适配，本质不是为了适配工具，而是把你做某个任务的最佳实践沉淀下来。工具会换，但是你总结的“同外设STM32板级移植要注意时钟配置、引脚定义、中断优先级三个点”这类经验，放在哪个工具里都是有用的。把核心经验抽象成可移植的Skill，比反复折腾某个工具的隐藏配置有价值得多。

下次再遇到新工具，你只需要把核心定义层的内容拿出来，花十分钟写个平台适配层，就能快速用上之前的经验，不用再从零开始摸索。

CursorCodexClaude_CodeSkillAI编程修改时间：2026-05-31 04:05:24