文章目录前言一、Agent Skills 是什么1.一句话定义2.和"老员工脑子里的规矩"3.不是新能力，是沉淀机制二、Skill 与 Prompt、MCP、Function Calling 的关系1.同一条链路上的四种角色2.执行链路全景3.一句话区分三、SKILL.md 怎么写1.基本结构2.元数据：name 与 description3.正文：操作手册不是科普文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