这是《逍遥录》第4章《独孤九剑》的中篇。核心主题：SKILL.md 解剖学、设计哲学、ClawHub 市场、我们自己的 Skill、内置技能。上篇已覆盖认知，下篇将覆盖安装、创作、审查与实战模板。
4.6 Skills 的解剖学：一个 Skill 长什么样
让我们把 Skill 拆开来看，看看它的内部结构。 一个完整的 Skill，目录结构长这样：
my-skill/
├── SKILL.md ← 必须的！技能的灵魂
└── （可选资源）
├── scripts/ ← 可执行脚本（Python/Bash 等）
├── references/ ← 参考文档（API 文档、 schemas 等）
└── assets/ ← 输出用文件（模板、图标、字体等）
金句：SKILL.md 不是文档，是契约——AI 和你签的契约。它告诉 AI"这事我能干"，告诉你"这事AI会干"。没有这份契约，AI 就是一台没有操作手册的机器。 SKILL.md 是必须的，没有它就不叫 Skill。其他三个文件夹是可选的，按需添加。
4.6.1 SKILL.md 的结构：前后两半
SKILL.md 文件本身分为两部分：
---
name: my-skill
description: "这是干什么的，什么时候用"
---
↑ 以上是 YAML 前置元数据（Frontmatter）
# 技能标题
## 使用方法
具体的操作指南……
↑ 以下是 Markdown 正文
前置元数据是 AI 决定是否使用这个技能的依据。它只有 name 和 description 两个字段，但极其重要。
正文是 AI 决定使用技能后，照着操作的指南。
4.6.2 前置元数据（Frontmatter）详解
前置元数据是 Skill 的"身份证"。AI 靠它来判断"这个技能跟我当前要解决的问题有没有关系"。
name：技能名称。用小写字母、数字和连字符，比如 feishu-bitable、weather、clawhub。
description：技能描述。这是最关键的字段。它要回答两个问题：
- 这个技能是干什么的？
- 什么时候应该用它？
金句：description 写得好不好，直接决定了 Skill 能不能在正确的时间被触发。正面定义 + 负面排除，是最佳实践。 一个写得好的 description 示例： "飞书多维表格（Bitable）的创建、查询、编辑和管理工具。当用户需要创建或管理飞书多维表格 App、在多维表格中新增/查询/修改/删除记录、管理字段/视图/数据表、批量导入数据时使用。" 这个描述清楚地告诉了 AI：
- 这个技能管的是"飞书多维表格"（不是普通文档，不是电子表格）
- 适用的触发场景（创建、查询、编辑、管理、批量操作） 一个写得差的 description 示例：
"飞书表格工具" ——太模糊。AI 无法判断什么时候该用、什么时候不该用。
4.6.3 正文（Body）写什么
正文是 Skill 的"使用手册"。它通常包含：
- 技能的用途说明
- 具体的命令或操作步骤
- 参数说明和示例
- 注意事项和边界条件
- 与其他资源的链接（references/ 下的文件） 正文的黄金法则：简洁。 上下文窗口是公共资源。你的 Skill 占的字数越多，留给用户实际问题的空间就越少。
只写 AI 不知道的东西。如果 AI 凭常识就能推断出来的，不要写。
4.6.4 可选资源：scripts/、references/、assets/
scripts/：可执行脚本。当某个操作需要精确执行、反复使用、不适合每次让 AI 重新写代码时使用。 references/：参考文档。当技能涉及大量背景知识、API 文档、数据结构说明时使用。 assets/：输出用文件。当技能需要产出特定格式的文件、模板、图标时使用。 核心原则：SKILL.md 只放操作指南和导航，把细节放到 references/ 里。
4.7 设计哲学：简洁是最高级的智慧
Skills 系统有一个贯穿始终的设计哲学，可以用一句话概括：
默认假设：AI 已经很聪明了。只添加它不知道的东西。 这句话听起来简单，但实际上反直觉——很多人写 Skill 的时候，写得越详细越好。仿佛写得多 = 写得好。恰恰相反。 好的 Skill 像好的武功秘籍——言简意赅，点到为止。 高手看到"白虹贯日"四个字，就知道怎么出剑。不需要你写三千字解释手臂抬多高、手腕转几度、脚尖朝哪边。 AI 也是如此。它已经具备了强大的理解和推理能力。你只需要给它：
- 方向（这个技能干什么）
- 边界（什么时候用、什么时候不用）
- 关键细节（它凭常识猜不出来的那些） 剩下的，让它自己发挥。
金句：好的 Skill 像好的武功秘籍——言简意赅，点到为止。默认假设：AI 已经很聪明了。只添加它不知道的东西。
4.7.1 自由度匹配（Degrees of Freedom）
Skills 系统还有一个重要概念：自由度匹配。 不同的任务，需要不同级别的指导��度： 高自由度（文字指令）：适合多种方法都可行、需要 AI 根据上下文灵活判断的场景。
比如"帮我把这份文档整理成周报格式"——AI 知道周报大概长什么样，你只需要告诉它"整理成周报"。 中自由度（伪代码或带参数的脚本）：适合有偏好模式、允许一定变化、但需要统一框架的场景。 比如"用这个模板生成报告"——模板给出了框架，但具体内容可以变。 低自由度（具体脚本、少参数）：适合容易出错、需要一致性、必须按特定顺序执行的场景。 比如"运行这个 Python 脚本处理 PDF"——步骤不能乱，参数不能错。 金句：任务越脆弱，指导越具体。任务越灵活，指导越抽象。这就是自由度匹配的核心原则。 这就像教人武功：
- 教内功心法，给口诀就行（高自由度）
- 教套路招式，要演示动作（中自由度）
- 教独门暗器，得一步步教（低自由度）
4.8 ClawHub 技能市场：江湖上的热门兵器谱
理论说够了，让我们看看真实江湖里，大家都在用什么 Skill。 ClawHub 是目前最大的 OpenClaw 技能市场，上面已经有 5.2 万个工具、18万用户、1200 万次下载。就像一个武林集市，各路高手把自己练成的招式挂上去，别人觉得好用，一键就能装到自己身上。
金句：5.2 万个技能，18万用户，1200 万次下载——这不是数字，是一个活生生的武林。你需要的招式，大概率已经有人铸好了。 我们实际去 ClawHub 上搜了一圈，以下是按热度排名的热门技能分类：
4.8.1 办公协作类
这三个是我们日常用得最多的。装了 feishu 技能后，逍遥子可以直接帮建国查飞书文档、建任务、管日历，不需要建国手动操作。
4.8.2 浏览器与自动化类
browser 是 ClawHub 上评分最高的技能之一。它能控制浏览器完成网页操作——自动填表单、截图、抓取数据。
4.8.3 搜索与信息类
搜索和天气属于"基础设施型"技能——不装的时候你觉得无所谓，装了之后发现每天都离不开。
4.8.4 记忆与自我进化类
这三个代表了 Skills 的更高境界——不是让 AI 学会一个外部工具，而是让 AI 学会记住、学会主动、学会进化。
4.8.5 工作流与编程类
工作流类技能是上一章《凌波微步》的延伸——不仅让 AI 按节奏运转，还让 AI 能编排复杂的多步骤流程。
**
【图4-3 — ClawHub 江湖兵器谱】
**金句：办公协作是基本盘，浏览器自动化是杀手锏，搜索天气是基础设施，记忆/主动/进化是未来方向，工作流/编程是生产力杠杆。**我们团队的体验：小龙女的自媒体运营90%靠飞书/日历/任务，张小龙的GEO项目靠browser抓客户数据，艾隆的探骊平台靠taskflow编排全流程。不是AI变聪明了，是AI手里的兵器变多了。
4.9 我们自己的 Skill 实战：从"会聊天"到"能干活"
ClawHub 上的热门技能是别人的兵器。现在让我们看看我们自己剑冢里插着什么剑。 我们当前实际安装和使用的 Skills，可以分为三大类：
4.9.1 基础设施型（每天必用）
① searxng — 搜索技能 这是我们在 AGENTS.md 里明确标注"优先使用"的搜索工具。 它的 SKILL.md 前置元数据是这样的：
---
name: searxng
description: 隐私优先的元搜索，使用本地 SearXNG 实例。搜索网页、图片、新闻等，无需外部 API 依赖。
---
短短两句话，但信息量足够。AI 看到这段描述，当用户说"帮我搜一下 XXX"时，它就会想起这个技能。 正文部分则包含了具体的搜索命令：
uv run {baseDir}/scripts/searxng.py search "query"
uv run {baseDir}/scripts/searxng.py search "query" -n 20
uv run {baseDir}/scripts/searxng.py search "query" --category images
这就是 Skill 的力量：把复杂封装起来，让 AI 只需要知道"怎么用"。 ② weather — 天气技能 内置技能，不需要 API Key。
---
name: weather
description: "Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather..."
---
它的 description 写得很讲究——不仅说了"干什么"，还明确说了**"NOT for"**（不干什么）。这种"正面定义 + 负面排除"的写法，是 description 的最佳实践。
4.9.2 自我进化型（让 AI 更聪明）
③ proactive-agent — 主动型智能体 这个技能让 AI 从"你问一句它答一句"变成"主动发现问题、主动汇报、主动行动"。
没有这个技能：建国问"今天有什么安排？"→ AI 查日历 → 回答。有这个技能：AI 每天早上主动检查日历，发现 10 点有会议 → 提前 15 分钟提醒建国 → 同时准备好会议相关资料。 ④ self-improving-agent — 自我改进 这个技能让 AI 从错误中学习。它的核心机制是：记录教训 → 写入 learnings 文件 → 更新知识库 → 执行前回顾。 没有这个技能：AI 第一次犯了一个错，第二次还会犯同样的错。有这个技能：AI 第一次犯错后，把教训写进 learnings 文件，第二次自动避开同样的坑。 ⑤ skill-vetter — 安全审查 在装任何新 Skill 之前，先用这个技能审查一遍。它提供了一套完整的安全检查协议：来源检查、代码审查、权限评估、风险分级。 这就像武林中的"兵器鉴定师"——在你拿起一把陌生的剑之前，先请鉴定师看看有没有毒、有没有诅咒。
4.9.3 能力扩展型（让 AI 做更多事）
⑥ find-skills — 技能发现 当用户说"能不能帮我做 XXX"而 AI 不确定自己会不会时，它能帮 AI 搜索相关技能、验证质量、推荐最佳选项并安装。
这就像武林中的"兵器铺掌柜"——你不知道自己需要什么剑，告诉他你要对付什么对手，他帮你挑。 ⑦ agent-browser — 浏览器自动化 我们实际安装的浏览器自动化技能。它让 AI 能控制浏览器完成网页操作：打开网页、截图、填写表单、抓取数据。 没有这个技能：AI 只能告诉你"你去这个网站下载"。有这个技能：AI 直接打开浏览器、登录网站、下载文件、把结果发给你。
**
【图4-4 — 我们的七把剑】
**金句：七把剑，七个维度。没装 Skill 前，AI 只有一个能力：聊天。装了 Skill 后，AI 能搜索、查天气、主动提醒、从错误中学习、审查安全、发现新技能、操控浏览器。同一个大脑，从"说客"变成了"战士"。**团队项目映射：逍遥录靠 searxng 搜资料、feishu-create-doc 写稿、memory 记进度。AgentPass 靠 skill-vetter 审查安全、find-skills 发现新技能。探骊平台靠 taskflow 编排全流程。
4.10 内置技能：OpenClaw 自带的"内功心法"
除了我们自己安装的技能，OpenClaw 还内置了一批核心 Skill。它们不像搜索或天气那样"显性"，但它们是 Skills 系统本身的"元技能"——让 AI 能管理、创建和扩展其他技能。
4.10.1 clawhub — 技能市场客户端
这是通往 ClawHub 江湖的入口。装了它，AI 能搜索、安装、更新、发布自己的技能。
clawhub search "postgres backups"
clawhub install my-skill
clawhub update --all
clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.0.0
没有这个技能：AI 知道自己缺什么，但没办法自己补。有这个技能：建国说"帮我找个能管理飞书多维表格的技能"→ AI 自己去 ClawHub 搜、筛选、安装、验证。 这是 Skills 系统的"自举能力"——AI 能自己给自己装新招式，不需要人工介入。
4.10.2 skill-creator — 技能创建器
当你需要的招式在 ClawHub 上找不到时，就靠这个技能自己造。 它提供了完整的 Skill 创建流程：理解需求 → 规划资源 → 初始化骨架 → 编写正文 → 打包发布 → 迭代优化。
这就像武林中的"铸剑术"——市场上买不到合适的剑，就自己开炉铸造。
4.10.3 飞书扩展技能集（内置）
OpenClaw 的飞书扩展自带了一整套 Skill，这是我们日常用得最频繁的：
没有这些技能：建国说"帮我建个任务"→ AI 说"我不会操作飞书"。有这些技能：建国说"帮我建个任务，截止时间本周五"→ AI 直接调用 feishu-task 创建任务、设置截止时间、通知相关人员。
4.10.4 taskflow — 工作流编排（内置）
taskflow 是 OpenClaw 内置的工作流技能。它解决的是"多个步骤如何串联"的问题。 比如一个完整的周报流程：检查提交 → 收集周报 → 生成摘要 → 发送给建国。四个步骤涉及不同的 Skill，taskflow 负责把它们编排成一条可靠的流水线。
**金句：taskflow 是"招式之间的连接绳"——单个 Skill 是独立的招式，taskflow 让多个招式连成一套组合拳。**内置元技能让 AI 自举——clawhub 搜技能、creator 造技能、taskflow 串技能。
第4章 独孤九剑 完整结构：上篇：认知——引子、什么是Skills、真实对比、本质、渐进式披露中篇：技术——解剖学、���计��学、ClawHub市场、我们自己的Skill、内置技能下篇：实操——上篇小结、装剑、铸剑、验剑、实战模板、最小实战、五个坑、下篇小结下篇预告：装剑三步、铸剑六步法、验剑底线（安全审查协议）、三个实战模板、最小实战、五个坑。