【Agent实战】Agent Skills 深度解析：从原理到落地的完整指南
文章目录
- 前言
- 一、Agent Skills 是什么
- 1.一句话定义
- 2.和"老员工脑子里的规矩"
- 3.不是新能力，是沉淀机制
- 二、Skill 与 Prompt、MCP、Function Calling 的关系
- 1.同一条链路上的四种角色
- 2.执行链路全景
- 3.一句话区分
- 三、SKILL.md 怎么写
- 1.基本结构
- 2.元数据：name 与 description
- 3.正文：操作手册不是科普文
- 4.自由度怎么把控
- 四、延迟加载与渐进式披露
- 1.为什么不能全塞进去
- 2.三层架构
- 3.文件组织实战
- 五、工作流与反馈循环设计
- 1.用清单把步骤串起来
- 2.反馈循环
- 3.条件分支
- 六、Skill 路由策略
- 1.轻量路由方案
- 2.冷启动问题
- 3.架构拆分
- 七、写 Skill 最容易踩的 8 个坑
- 1.把 Skill 当项目 README 写
- 2.想把一个 Skill 写得太全
- 3.给 Agent 太多选择
- 4.术语别来回换
- 5.让 LLM 做确定性工作
- 6.没有验证清单
- 7.链式引用过深
- 8.第三方 Skill 不审就用
- 八、总结
- 结尾
前言
想让 Claude 按团队规范做 Code Review，你会怎么做？最直觉的做法——每次把规范贴进 Prompt。问题来了：换一个会话、换一个同事，又得手动贴一遍。后来有人提议放 AGENTS.md，确实好了一些，但新问题冒出来：内容太多会不会被模型忽略？哪些规范是全局的，哪些只对特定任务生效？
这些痛点，恰好落在了 Agent Skills 的解决范围里。
你是否也在纠结：Skill 究竟是什么，它和 Prompt、MCP、Function Calling 之间怎样协作？SKILL.md 从零开始怎么写，才能让 Agent 真正稳定执行？延迟加载和渐进式披露到底怎么落地？Skill 多了之后路由怎么做？
本文从原理到实操逐层拆解——不只知道"是什么"，更要搞懂"怎么写、怎么组织、怎么避坑"。
不管你是刚接触 Agent 的新手，还是在企业中落地 AI 的架构师，读完这篇，Skills 这块拼图就算彻底拼上了。
开拆！
一、Agent Skills 是什么
1.一句话定义
Skill 是一份可被 Agent 按需发现、按需加载的任务执行说明书。
Skill 把特定任务的经验、规则和执行步骤固化为文档，供 Agent 在恰当的时机才读取。接口返回格式如何统一、日志字段如何打标、慢 SQL 怎么排查、Code Review 时优先看架构还是先看异常——这些信息过去散落在各种 Wiki 和口头提醒中，Skill