跳到主要内容

Skills与能力平台

本目录写 Agent 的任务级能力封装：Skill、Tool、MCP Server、Sub-agent 分别解决什么问题，什么时候升级，如何版本化和评测。

它不是再讲一遍 MCP JSON-RPC。协议细节仍以 ../04-工具调用体系/MCP在Agent中的位置.md 为准。这里回答的是：工具越来越多之后，如何避免把全部 schema 塞进 system prompt，以及如何把「怎么做这类任务」从一次性提示词变成可治理资产。

核对日期：2026-08-26。Claude Agent Skills、Cursor Skills 的 frontmatter 会变，实现时以官方文档为准。规范必填字段目前是 name 与 description。

1. 阅读顺序​

顺序文件解决的问题
1能力分层与选型.mdTool / MCP / Skill / Sub-agent 边界与选型
2SKILL.md工程规范.md触发描述、渐进披露、目录结构
3Skill与MCP集成.md用 Skill 编排 MCP 工具，而不是把 Server 当万能插件
4能力目录与治理.md版本、权限、退役、marketplace
5Skill触发与评测.md何时加载、误触发、评测集

2. 和相邻目录的边界​

主题主文件本目录只写
工具 schema、权限、MCP 协议../04-工具调用体系/README.mdSkill 如何引用工具，不重复协议帧
多 Agent、handoff../08-多Agent系统/README.mdSkill vs Sub-agent，不把多 Agent 当默认
Voyager 技能库（代码技能）../14-经典论文与方法/Voyager.md术语区分：论文里的 Skill 是可执行代码片段
交互层../18-Agent前端与交互/README.md能力加载本身不是 UI
GUI 操作../20-Computer-Use与浏览器Agent/README.mdSkill 可写「何时开浏览器」，不授予任意域权限

横向能力体系 02 Skills 体系与 Plugin 架构 是通识长文。本目录按 Agent 主库体例写选型契约。

3. 能力栈位置​

默认顺序：先有清晰工具契约，再写 Skill；Skill 稳定后再考虑 Sub-agent。不要先上 marketplace。

4. 最低交付面​

能力最低要求
清单每个 Skill 有 name、description、所有者、版本
触发description 写清 WHAT 和 WHEN，并有反例
披露未触发时只把元数据放进上下文
权限Skill 不能扩大工具权限；写操作仍走策略引擎
评测至少 10 条「该触发 / 不该触发」样本
审计trace 记录加载了哪个 Skill、哪个版本

5. 权威资料​