Agent 技能
skills 文件、可组合能力。
30 分钟
Agent 技能
Skills（如 Cursor SKILL.md、Claude 项目技能）是把 领域知识、步骤、约束 打包成 Agent 可按需加载的 能力模块。与 MCP 的「远程工具」互补：Skills 偏 流程与规范，MCP 偏 执行与数据。
学习目标
- 理解 skill 文件的结构与触发方式
- 会设计可组合、可版本化的技能集
- 区分 skill、system prompt、MCP tool 的使用场景
Skill 是什么
典型 skill 含：
- 何时使用：任务类型描述（写讲义、跑迁移、做 RAG 评估）
- 步骤：检查清单式 workflow
- 约束：禁止项、必须引用的文档
- 示例：Few-shot 或命令模板
Agent 运行时 检索或路由 到相关 skill，再展开进上下文——避免每次对话塞 50 页手册。
与 MCP、Tools 的分工
| 机制 | 提供什么 | 例 |
|---|---|---|
| Skill | 怎么做、按什么标准 | 「写 CodeRoadMap draft 的结构」 |
| MCP / Tool | 读什么、改什么 | search_docs、git_status |
| System prompt | 全局角色与安全 | 拒答、语言、审批 |
写站内讲义：skill 引用 ai-workflow 的 responsible 流程；tool 读 outline.yaml；人做最终 merge——见 ai-engineering-essentials。
可组合能力
base-safety.skill → 所有 Agent 必载
content-author.skill → 写 content/课程 draft
rag-ops.skill → 分块、索引、评估 checklist
原则：
- 单一职责：一个 skill 一个主场景
- 版本 pin：
content-author@v2变更可追踪 - 勿重复 MCP：skill 里写「调用 search_docs」，不嵌入 ES 客户端细节
- 人审关口：skill 写「生成后必须 diff」，不能替代 agt-safety
反模式
| 反模式 | 问题 |
|---|---|
| 巨型 skill 包一切 | 占满上下文、难维护 |
| skill 内嵌密钥 | 泄露进 repo 与 Chat |
| 无 skill 仍堆 prompt | 与工具描述矛盾 |
练习
- 为「新建 ai-agents draft」写 skill 大纲：触发语、5 步、3 条禁止