22 · Agent Skills 教程：安装、触发与创建

Agent Skills 的目录结构、SKILL.md、安装位置、自动触发与手动调用，说明如何把重复流程沉淀为可复用能力。

Skills 是「把重复的流程，打包成一个可复用的能力」。你遇到过那种「每次都要按固定步骤做一遍」的事，就可以沉淀成一个 Skill。

「目录结构」是一个 Skill 的物理形态：它通常是一个文件夹，里面有一个描述文件（常叫 SKILL.md）和可能用到的脚本、资源。

「SKILL.md」是这个 Skill 的「说明书」，告诉 Codex 这个技能是干嘛的、什么时候该用、怎么用。写得好不好，直接决定 Codex 能不能在正确时机触发它。

「安装位置」决定了它的作用范围：装到全局，所有项目都能用；装到某个项目，就只在那个项目里生效。

「触发」分两种：自动触发和手动调用。自动触发靠的是 SKILL.md 里写的「触发条件」——当任务匹配这些条件时，Codex 自动加载它。手动调用则是你显式地让它用某个技能。

「创建」一个 Skill，本质是把你的经验「写下来、结构化」。你总结出「这类事该怎么做」，写成一个 Skill，以后你和别人都能复用。

Skills 的价值，在于「把一次性劳动变成可复用的资产」。你踩过的坑、跑通的流程、总结的方法，都可以固化成 Skill，越攒越多，越用越省力。

这一篇和前面的「子代理」「MCP」是三个并列的扩展维度：子代理是「拆人」，MCP 是「接工具」，Skills 是「沉淀流程」。三者配合，Codex 才能从「工具」变成「你的工作体系」。

常见误区：很多新手会把这一篇讲的「基本规则」当成「教条」——什么都严格遵守。其实这些规则的核心是「降低风险、提高效率」，理解了动机，规则就自然内化了，不用死记硬背。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。