咱们开发者手里的家伙事儿是越来越多了。但说实话，这事儿也挺让人头秃的。你想想，今天用Claude Code写个后端，明天用OpenAI的Codex CLI修个Bug，后天可Neng又得切到Gemini CLI去跑个脚本。这就像是你家里有三个不同品牌的智Neng音箱，每个dou得用特定的跟它说话，稍微不对味儿，它就给你来个“我听不懂”。

特别是当我们谈论如何给这些AI“立规矩”和“教技Neng”的时候，那场面简直是一团糟。有的叫Rules，有的叫Skills，有的文件名是CLAUDE.md，有的又是AGENTS.md。要是项目一多，你根本分不清哪个规则在哪个项目里生效，哪个技Neng又是给哪个智Neng体用的。所以今天咱们不整那些虚头巴脑的概念，直接来点干货。我花了不少时间，把目前市面上Zui主流的三大终端编程智Neng体——Claude Code、OpenAI Codex CLI以及Gemini CLI的规则和技Neng制定方式，好好梳理了一遍。这不仅是给我自己备忘，也希望Neng帮大家理清这团乱麻。

混乱背后的逻辑：Rules vs Skills

在深入具体工具之前，咱们得先达成一个共识：到底什么是Rules，什么又是Skills？这俩词儿虽然经常混在一起说但本质上完全是两码事。

你Ke以把Rules想象成是项目的“宪法”或者“家规”。它是静态的，是写在墙上的。比如“在这个项目里所有的变量命名必须用驼峰式”，“所有的API返回必须包含code字段”。这些是上下文，是约束，是告诉AI：“在这个屋檐下干活，就得按这个规矩来。”在Claude Code里这通常对应着CLAUDE.md；而在Codex CLI里它叫AGENTS.md。

而Skills呢，则geng像是给AI配备的“工具箱”或者“插件”。它是动态的，是可执行的。比如“帮我跑一下测试用例”，“把这个JSON格式化一下”，或者“去GitHub上拉取Zui新的PR列表”。Skills是一套封装好的流程，包含了指令、脚本甚至参考文档。你Ke以通过特定的命令来随时调用它。现在这三家巨头dou在逐渐向一个叫Agent Skills的开放标准靠拢，这绝对是件好事，意味着咱们以后写一次技Neng，可Neng就Neng到处跑了。

Claude Code：优雅的先行者

Anthropic推出的Claude Code，在开发者体验这块确实Zuo得挺细腻。它对规则和技Neng的支持非常完善，而且文档写得也相对人性化。

CLAUDE.md：项目的宪法

在Claude Code的世界里规则文件被命名为`CLAUDE.md`。这个文件非常关键，它就像是你在项目根目录下留给AI的一张便条，告诉它这个项目的背景、约定以及一些必须遵守的约束。

它的加载顺序hen有讲究，是从全局到局部的。系统会先加载全局的配置，然后向上搜索项目祖先目录，Zui后再扫描当前的子目录。这种层层递进的方式，保证了具体的规则Neng够覆盖通用的规则，非常符合逻辑。

SKILL.md：可插拔的Neng力胶囊

说到技Neng，Claude Code是Agent Skills开放标准的坚定支持者。一个标准的技Neng包，结构其实非常清晰：

my-skill/
├── SKILL.md           # 必需：指令和元数据
├── scripts/           # 可选：可执行脚本
├── references/        # 可选：参考文档
└── assets/            # 可选：资源文件

这里面的核心当然是`SKILL.md`。它不仅仅是一段文本，它还包含了一段YAML格式的Frontmatter。这段元数据就像是技Neng的“身份证”，告诉Claude这个技Neng叫什么、干嘛用的、需要什么权限。

举个例子，你Ke以这样定义一个技Neng：

---
name: api-auditor
description: "API端点审计专家。当用户要求检查、测试或审计URL时使用。"
user-invocable: true
allowed-tools: Read, Grep
model: sonnet
---
这里是具体的技Neng指令内容...

这里有个特别酷的功Neng叫Hooks。你Ke以在元数据里配置`pre-invoke`脚本，这样在调用技Neng之前，系统会自动先跑个脚本Zuo些准备工作，比如检查环境或者下载依赖。这种自动化程度，真的Neng省不少心。

OpenAI Codex CLI：严谨的工程师

OpenAI的Codex CLI走的是另一条路子，它给人的感觉geng像是一个严谨的工程师，配置上虽然稍微繁琐一点，但胜在灵活和可控。

AGENTS.md：标准化的代理指令

Codex CLI里的规则文件叫`AGENTS.md`。这个名字听起来就hen有“代理”的感觉。它的作用和Claude的`CLAUDE.md`类似，dou是用来指导编码代理的。不过Codex在配置文件的管理上引入了Starlark语法，这让配置变得极其强大，当然学习门槛也稍微高了一点点。

你Ke以在`~/.codex/config.toml`里Zuohen多精细化的控制，比如设置`project_doc_max_bytes`来限制读取文档的字节数，或者设置`project_doc_fallback_filenames`来指定备选的文档名。

技Neng配置与Starlark

Codex CLI同样支持Agent Skills标准，它的技Neng目录结构和Claude基本一致。但是它在`SKILL.md`的元数据字段上，有一些自己的小心思。

比如它支持`argument-hint`字段，这Neng帮助用户在输入命令时获得自动补全的提示。还有`disable-model-invocation`字段，Ru果设为true，那么这个技Neng就只Neng由用户手动调用，模型自己不会瞎触发。这对于一些敏感操作来说是个hen好的安全机制。

Codex CLI还允许你通过配置文件来禁用某些技Neng，或者通过Starlark脚本来定义geng复杂的加载逻辑。比如你Ke以写个规则，只有当文件名匹配特定模式时才允许某个技Neng生效。

prefix_rule(
    pattern = ],
    decision = "allow",  # allow / prompt / forbidden
    justification = "允许查kan GitHub PR"
)

Gemini CLI：后起之秀的实验场

谷歌的Gemini CLI虽然入局稍晚，但势头hen猛。目前它对Skills的支持还标记为“实验性功Neng”，但这并不妨碍我们尝鲜。

GEMINI.md：谷歌的上下文入口

毫不意外Gemini的规则文件叫`GEMINI.md`。它的作用也是为Gemini模型提供指令上下文。虽然目前它的功Neng可Neng不如前两位那么丰富，但作为谷歌生态的一环，它在处理谷歌自家技术栈时可Neng会有一些独到的加成。

终端驱动的技Neng管理

Gemini CLI的一大特色是它非常依赖终端命令来管理技Neng。你需要手动在设置里开启“Agent Skills”功Neng，或者直接修改`~/.gemini/settings.json`文件。

安装和管理技Neng的命令非常直观：

gemini skills install    # 安装技Neng
gemini skills uninstall         # 卸载技Neng
gemini skills enable  --scope user|workspace
gemini skills disable 

这种命令行的交互方式，对于习惯了键盘操作的老手来说效率极高。不过因为还是实验性功Neng，有时候在兼容性上可Neng会遇到一些小插曲，这点大家要有心理准备。

Agent Skills：大一统的开放标准

说了这么多各自的特性，其实Zui让我兴奋的是这三家dou在努力拥抱Agent Skills这个开放标准。这简直就像是编程界的“普通话”，让大家douNeng听懂。

这个标准的核心，就是那个`SKILL.md`文件。它定义了一套通用的元数据规范，比如`name`、`description`、`license`等等。有了这个标准，你写的一个技Neng，理论上Ke以在Claude Code、Codex CLI和Gemini CLI之间无缝迁移。

SKILL.md 的通用解剖

让我们再仔细kankan这个“万Neng”的文件格式。不管你用哪个工具，`SKILL.md`的基本骨架dou长这样：

---
name: skill-name                    # 必需：小写字母、数字、连字符
description: 技Neng描述和使用场景     # 必需：简短精炼
license: Apache-2.0                 # 可选：许可证
compatibility: Requires git, docker # 可选：环境要求
allowed-tools: Bash Read     # 可选：预授权工具
metadata:                           # 可选：自定义元数据
  author: example-org
  version: "1.0.0"
---
这里是真正的技Neng指令内容...

这里有个概念叫渐进式披露。简单来说就是AI不会一股脑地把所有技Nengdou加载到上下文里那样太费Token了。它会根据你的需求，动态地、分层次地加载相关的技Neng。这种机制对于优化上下文窗口的使用非常关键。

横向对比：一张表kan懂三大智Neng体

为了防止大家kan得眼花缭乱，我特意整理了一个对比表。有了这张表，以后再配置环境，就像查字典一样简单了。

Rules 文件对比

智Neng体	规则文件名	用户级路径	项目级路径
Claude Code	CLAUDE.md	~/.claude/CLAUDE.md	/CLAUDE.md
Codex CLI	AGENTS.md	~/.codex/AGENTS.md	/AGENTS.md
Gemini CLI	GEMINI.md	~/.gemini/GEMINI.md	/GEMINI.md

Skills 文件对比

智Neng体	技Neng文件名	用户级路径	项目级路径	支持状态
Claude Code	SKILL.md	~/.claude/skills//	.claude/skills//	正式支持
Codex CLI	SKILL.md	~/.codex/skills//	.codex/skills//	正式支持
Gemini CLI	SKILL.md	~/.gemini/skills//	.gemini/skills//	实验性

SKILL.md Frontmatter 字段支持度

字段	Agent Skills 标准	Claude Code	Codex CLI	Gemini CLI
name	必需	必需	必需	必需
description	必需	必需	必需	必需
license	可选	支持	-	-
allowed-tools	可选	支持	支持	-
hooks	-	支持	-	-
model	-	支持	-	-

构建你的数字同事

搞清楚这些Rules和Skills的区别与联系，不仅仅是为了少踩几个坑，geng是为了让我们Nenggeng高效地构建属于自己的“数字同事”。想象一下当你把团队的编码规范、测试流程、部署脚本dou封装成标准的Skills，然后通过Rules把它们注入到每一个项目中，那时候的AI就不再是一个简单的聊天机器人，而是一个真正懂业务、懂规范、Neng干活的资深搭档。

虽然现在各家还有点“”差异，但Agent Skills标准的出现，让我们kan到了大一统的希望。作为开发者，咱们得跟上这波浪潮，别等AIdou学会协作了咱们还在手动改配置文件呢。希望这篇汇总Neng成为你案头的一本实用手册，下次再遇到配置问题，拿出来翻一翻，也许就Neng豁然开朗。

---