Appearance
Agent Skill
Skill 是给 AI Agent 使用的可维护操作规程。它把人的经验写成模型可读的规则，包括什么时候触发、先读什么、按什么步骤做、哪些行为禁止、怎样验证完成。
如果 MCP 是工具插座，Skill 就是工具旁边的操作手册。没有 Skill，Agent 可能知道有工具，却不知道在当前项目里该怎样用；有了 Skill，团队经验可以从聊天记录沉淀成可复用资产。
Skill 解决什么问题
Skill 主要解决三类问题：
- 一致性：同类任务每次都按同一流程执行，例如代码审查、文档改写、发布说明。
- 上下文效率：把长期规则放在文件中，任务触发时再加载，避免每次对话重复说明。
- 验收标准：把“怎样算完成”写清楚，让 Agent 不只产出内容，还能自查。
Skill 不是为了让提示词更长，而是为了让流程更稳定。
Skill 不是什么
| 不是 | 原因 |
|---|---|
| 不是 MCP | Skill 描述流程，MCP 连接工具 |
| 不是万能提示词 | Skill 应针对明确任务，不应包办所有场景 |
| 不是知识库全文 | 长资料应放 references 或文档中按需读取 |
| 不是 Agent 编排器 | 多轮状态、人机确认、权限执行仍由运行时负责 |
一个好 Skill 应该包含什么
| 部分 | 作用 | 示例 |
|---|---|---|
| 触发条件 | 告诉 Agent 什么时候使用 | “修改前端页面时使用” |
| 输入范围 | 说明需要哪些资料 | 设计稿、目标页面、现有组件 |
| 执行步骤 | 固化流程 | 先读组件，再改样式，再截图验证 |
| 禁止行为 | 防止高频错误 | 不直接重写无关文件 |
| 验收标准 | 判断是否完成 | 构建通过、截图无重叠、链接可用 |
| 降级路径 | 环境不满足时怎么办 | 无浏览器时说明未完成视觉验证 |
好的 Skill 更像工程规程，不像作文模板。它应尽量具体、可执行、可检查。
与 MCP、Agent 的协作方式
一个典型流程：
- 用户提出任务。
- Agent 判断任务匹配某个 Skill。
- Skill 提供流程和边界。
- Agent 根据 Skill 调用本地工具、MCP Server 或浏览器。
- 工具结果回到上下文。
- Agent 按 Skill 的验收标准自查并交付。
这里 Skill 不直接执行工具，但它决定工具应该怎样被使用。
适合沉淀成 Skill 的任务
适合：
- 重复发生，且每次流程相似。
- 有明确的质量标准。
- 容易因为遗漏步骤导致返工。
- 涉及团队约定，例如文档口吻、测试方式、发布流程。
不适合：
- 一次性探索。
- 规则还不稳定。
- 需要大量实时业务判断。
- 无法写出清晰完成标准。
在本站如何阅读
| 文档 | 说明 |
|---|---|
| Skill 推荐与选型 | 如何判断是否需要安装或自建 Skill |
| Claude Code 推荐实践 | 如何把 Skill 写成可执行规程，而不是提示词清单 |
总结
Skill 的价值是把人的重复经验沉淀为可维护规则。它不替代模型、工具或 Agent 编排，而是让 Agent 在具体任务中少猜、少漏、少跑偏。写 Skill 时重点是触发条件、步骤、禁止行为和验收标准。