打开技能文件：把“是什么”变成看得见

把随书技能目录打开，它只有三个文件：

recruiter-requirement-align/
  SKILL.md                    方法入口
  references/field-rules.md   字段和判断规则
  assets/需求基线模板.md        交付结构

SKILL.md 开头的两项元数据，帮助支持该格式的宿主了解名称和用途。正文才是具体方法。随书版本的开头如下：

---
name: recruiter-requirement-align
description: 将猎头岗位需求、会议补充和客户确认整理为可追溯的需求基线、冲突清单和澄清问题。用于 JD 澄清、岗位画像对齐、多个版本合并及新岗位复用；不做候选人排名、薪酬估算或自动联系。
---

技能正文没有写“你是最厉害的猎头”。它规定了更可检查的动作：先列实际读取的文件，区分四种信息状态，按模板输出，给原文依据，不能用后出现的一句话自动覆盖冲突。

字段规则单独放，是为了让主说明保持简洁；模板单独放，是为了方便你调整交付列。每个辅助文件都从入口明确引用，否则文件虽在包里，执行时也可能没有被读取。

做一次不调用模型的检查

打开三个文件，逐个回答：入口有没有说明适用任务？引用的文件是否存在？模板是否包含你要交给下一环节的信息？有没有写死某个真实客户的条件、手机号或密码？没有脚本并不妨碍它成为完整的方法型 Skill。

开放格式、某个软件的导入要求、市场上架要求是三回事。本书技能按开放格式组织，不宣称已通过市场审核。需要发布市场时再看对应平台要求，不要为第一次练习先增加与当前任务无关的元数据。

为什么入口描述要写“何时用”

如果名称叫“超级猎头助手”，用途只写“帮助招聘”，读者和宿主都很难判断它应在需求澄清、公司研究还是推荐报告时使用。更清楚的描述是：“在 JD、会议补充与客户确认需要合并时，生成带来源的需求基线和澄清问题。”它交代了输入场景、要做的事和要交的结果。

名称应与目录一致，使用规范允许的小写字母、数字和连字符，例如 recruiter-requirement-align。新手先保留 name 和 description 两个必要字段即可。下面的“输入、规则、验收”等小标题是业务设计建议，并非格式标准强制规定的字段。格式规范

主文件先写清方法，规则太多再放进 references；有固定交付样式再加 assets。只有确实需要可重复的程序处理时才增加 scripts。多建目录不会自动增加能力，引用的资源还需要在任务中实际读到。

沿着真实文件，逐段看懂设计意图

打开随附的 SKILL.md，逐段对照。下表是对现有内容的解释，不是另造一份已经验证的技能。

宽表格可左右滑动查看

一个 Skill 怎样进入本次工作

按开放格式的设计，客户端可以先识别名称与用途，任务需要时读取入口，再按需读取引用资料。发现、加载、执行、验收是不同环节：安装列表里有它，不表示这次已经用过；读取过，也不表示规则全部执行正确。具体机制以客户端为准。Agent Skills 概览

本讲练习： 在文件中找到一条分类规则、一处模板引用、一条异常处理，分别说出怎样检查它是否生效。如果找不到，可以先记录缺项；不要仅因为文件名叫 SKILL.md 就认定方法完整。

接着把自己的经验写成规则。