26 · Agent Skills 教程:结构、触发与边界
Agent Skills 的目录结构、SKILL.md 写法、自动触发与手动调用方式,解释它和命令、子代理、Hook、MCP 的职责差异。
Skills 是「把重复的流程,打包成可复用的能力」。你遇到过那种「每次都要按固定步骤做一遍」的事,就可以沉淀成 Skill。
「目录结构」是一个 Skill 的物理形态:通常是一个文件夹,里面有描述文件(常叫 SKILL.md)和可能用到的脚本、资源。
「SKILL.md 写法」是这个 Skill 的「说明书」,告诉 Claude 这技能是干嘛的、什么时候用、怎么用。写得好不好,直接决定 Claude 能不能在正确时机触发它。
「自动触发」靠的是 SKILL.md 里写的触发条件——当任务匹配这些条件时,Claude 自动加载。
「手动调用」则是你显式地让它用某个技能。
「职责差异」是这篇的关键:Skills 和命令、子代理、Hook、MCP 到底怎么分?一句话——命令是「一句话触发一个动作」,子代理是「拆出一个角色」,Hook 是「在固定节点自动跑脚本」,MCP 是「接外部工具」,而 Skills 是「沉淀一段完整流程」。各有各的用武之地。
Skills 的价值,在于「把一次性劳动变成可复用的资产」。你踩过的坑、跑通的流程、总结的方法,都可以固化成 Skill,越攒越多,越用越省力。
这一篇和后面的「Skills 实战」「skill-creator」是递进关系:先懂结构,再学怎么用,最后学怎么造。
一个自查清单:当你读完这一篇时,可以问自己三个问题——它解决的是什么具体问题?我当前的工作/学习里有没有这个场景?下一步我该学哪一篇?把这三个问题答清楚,你就知道自己有没有真正吃透。
动手试一下:你可以花 5 分钟做一个最小验证——找一个真实的代码任务,让 Codex 跑一遍,看它的行为是不是和这一篇描述的一致。理论与实践对照,才知道「懂」和「会用」是两件事。
延伸阅读:学完这一篇,你可以看本组里的下一篇,把相邻的概念连起来读;也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的,多跳几篇会理解更深。
判断决策树:用三个问题判断该不该用——① 这件事值不值得用 Codex 做?② 用的话该用哪个入口?③ 风险高不高需不需要审批?三个问题的答案一出来,怎么做就清楚了。