技能 Skills
Agent Skills（智能体技能）= 一个装着 SKILL.md 的文件夹，用 Markdown 告诉 Agent「这件事该怎么做」。它把「你们公司的发版流程」「这个项目的测试命令」这类只存在于人脑和聊天记录里的经验，变成 Agent 能按需加载的说明书。
前置：智能体 Agent（知道 Agent 怎么循环）、opencode 或任意一个编码 Agent 的使用经验。 基线：Agent Skills 开放规范（agentskills.io）· Claude Code 2.1.x · opencode 1.19.3 · Hermes / OpenClaw 各自的技能目录见第 5 章
为什么值得看它
| 特点 | 说明 |
|---|---|
| 一份文件 | 一个 SKILL.md 就是全部，没有代码、没有依赖、没有构建步骤 |
| 按需加载 | 平时只有「名字 + 简介」占着上下文，真要用时才把正文读进来 |
| 跨工具复用 | 同一份技能，Claude Code、opencode、Hermes、OpenClaw 都能认 |
| 人可读可改 | 就是 Markdown，队友 review 你的技能像 review 文档一样自然 |
| 能被 Agent 引用 | 技能之间能互相引用，也能引用仓库里的脚本、模板 |
它是怎么干活的
你：帮我出一份周报
↓
Agent 启动时只看到一行行元数据（约 100 token）
weekly-report · 汇总本周 Git 提交与 Issue，生成周报
↓
模型判断「这条对得上」，自己去读 SKILL.md 正文
↓
正文里再按需引用 references/、scripts/ 里的细节
↓
照着步骤干活：跑 git log → 汇总 → 写 reports/YYYY-WW.md关键在第三步：正文不是一次全灌进上下文，而是像抽屉一样一层层拉开，用哪层开哪层。
两种技能
| 类型 | 是什么 | 典型例子 |
|---|---|---|
| 参考型 | 给 Agent 补知识：约定、风格指南、领域规则 | 「这个仓库的 API 一律用 RESTful 命名 + 统一错误格式」 |
| 任务型 | 给 Agent 一套固定步骤，像 SOP 一样 | 「发版：跑测试 → 构建 → 打 tag → 发 changelog」 |
任务型通常还要写成「只能我手动触发」，免得 Agent 每次都自作主张去发版。
学习目标
- 知道 Agent Skills 是什么、解决什么问题、跟 Prompt 有什么区别
- 会写合规的
SKILL.md：目录结构、frontmatter 六个字段、正文规范 - 掌握渐进式披露：描述怎么写才选得中、上下文怎么省
- 会用
scripts/、references/、assets/组织复杂技能 - 知道各家工具的技能目录在哪、优先级怎么排、怎么校验
- 知道第三方技能的安全红线
技术路线
| 章节 | 核心内容 |
|---|---|
| 1. 什么是 Agent Skills | 定位、与 Prompt / 工具 / MCP 的区别、渐进式披露预览 |
| 2. SKILL.md 的结构 | 目录布局、frontmatter 六个字段、正文怎么写 |
| 3. 渐进式披露 | 三层加载模型、description 写法、上下文预算 |
| 4. 编写实战 | scripts / references / assets 怎么拆、常见反模式 |
| 5. 安装与加载 | 各家工具的技能目录、优先级、校验与安全 |
| 6. 综合练习 | 写一套跨工具复用的技能包 |
这个栈不绑定任何一家产品：讲的是规范层。Hermes 智能体 第 4 章讲它自己的技能机制、OpenClaw 第 4 章讲它的技能与记忆，本栈站在更高一层，看规范怎么定的、各家怎么实现的。
从 1. 什么是 Agent Skills 开始吧！