Skip to content

约 3 分钟阅读

Agent Skill ​

Skill 是给 AI Agent 使用的可维护操作规程。它把人的经验写成模型可读的规则,包括什么时候触发、先读什么、按什么步骤做、哪些行为禁止、怎样验证完成。

如果 MCP 是工具插座,Skill 就是工具旁边的操作手册。没有 Skill,Agent 可能知道有工具,却不知道在当前项目里该怎样用;有了 Skill,团队经验可以从聊天记录沉淀成可复用资产。

Skill 与 Agent、工具的关系

Skill 解决什么问题 ​

Skill 主要解决三类问题:

  • 一致性:同类任务每次都按同一流程执行,例如代码审查、文档改写、发布说明。
  • 上下文效率:把长期规则放在文件中,任务触发时再加载,避免每次对话重复说明。
  • 验收标准:把“怎样算完成”写清楚,让 Agent 不只产出内容,还能自查。

例如文档修订 Skill 把“改完检查一下”变成:先读取专题入口和侧边栏,判断是否需要机制图,修改后构建,再逐页检查手机和图片放大。它提供可执行约定,但仍可能被误触发或执行遗漏,需要用真实任务验证。

Skill 不是什么 ​

不是原因
不是 MCPSkill 描述流程,MCP 连接工具
不是万能提示词Skill 应针对明确任务,不应包办所有场景
不是知识库全文长资料应放 references 或文档中按需读取
不是 Agent 编排器多轮状态、人机确认、权限执行仍由运行时负责
不是安全沙箱Markdown中的禁令不阻止进程越权,执行端仍要限制工具和资源

一个好 Skill 应该包含什么 ​

部分作用示例
触发条件告诉 Agent 什么时候使用“修改前端页面时使用”
输入范围说明需要哪些资料设计稿、目标页面、现有组件
执行步骤固化流程先读组件,再改样式,再截图验证
禁止行为防止高频错误不直接重写无关文件
验收标准判断是否完成构建通过、截图无重叠、链接可用
降级路径环境不满足时怎么办无浏览器时说明未完成视觉验证

好的 Skill 更像工程规程,不像作文模板。它应尽量具体、可执行、可检查。

与 MCP、Agent 的协作方式 ​

一个典型流程:

  1. 用户提出任务。
  2. Agent 判断任务匹配某个 Skill。
  3. Skill 提供流程和边界。
  4. Agent 根据 Skill 调用本地工具、MCP Server 或浏览器。
  5. 工具结果回到上下文。
  6. Agent 按 Skill 的验收标准自查并交付。

这里指令正文引导 Agent 使用工具;有些 Skill 还附带脚本,脚本只有被调用时才执行,并继承运行环境的权限。它不能自行提升系统权限,也不保证工具可用。

通常先把名称和描述交给 Agent 做选择,触发后再加载正文,长参考资料按任务读取。不同宿主的发现目录、字段和上下文保留策略并不完全相同。写了 SKILL.md 不代表任意客户端都会自动识别,迁移时要核对宿主支持。

适合沉淀成 Skill 的任务 ​

适合:

  • 重复发生,且每次流程相似。
  • 有明确的质量标准。
  • 容易因为遗漏步骤导致返工。
  • 涉及团队约定,例如文档口吻、测试方式、发布流程。

不适合:

  • 一次性探索。
  • 规则还不稳定。
  • 需要大量实时业务判断。
  • 无法写出清晰完成标准。

在本站如何阅读 ​

文档说明
Skill 推荐与选型如何判断是否需要安装或自建 Skill
Claude Code 推荐实践如何把 Skill 写成可执行规程,而不是提示词清单

验证一条规则是否有用 ​

选一条“新增接口字段”的任务跑对照:原流程是否遗漏旧客户端兼容,新增规则后是否检查序列化、默认值和旧测试。再用“只修改文档错别字”测试它是否过度触发数据库检查。既要看完成质量,也看额外耗时和误触发。

记录宿主版本、Skill版本、输入任务和失败证据。规则更新后重跑代表任务;上次有效不代表路径、命令升级后仍然有效。具体文件结构见 Claude Code Skill 实践。

别急,先让缓存热一下。