S07 Skills：从最小示例学习技能编写

先写出一份可以使用的 Skill，再学习从真实经验中提炼方法，判断哪些内容值得保留。主线以 Agent Skills Home、Quickstart 和 Best practices for skill creators 为依据，按小单元逐步展开。

当前学习单元

每个写作单元先提出具体问题，再用实际材料和完整文件解释；涉及改写时对照修改前后，最后给出检查方式。示意的预期与实际运行记录分别标注。

接下来怎样细分学习单元

官网的一个小标题可以拆成几个学习问题。每个小节以能完成一次判断或一次修改为尺度，尽量沿用同一个例子，检查这次改动带来了什么变化。

已展开的 7.3 内容取舍 分成四步：

7.4 任务范围 接着沿用 7.2 的小节编写示例：

每次只改变当前要观察的部分。一个主题学完后，再进入下一个主题；后续章节号与正文随实际学习进展确定。

先校准每一步的控制程度

7.5 Calibrating Control 衔接任务范围与执行机制：7.4 确定这份 Skill 负责什么，7.5 进一步判断每一步应该给 Agent 多大自由度。对应官网的 Calibrating control。

原文强调按任务的脆弱程度调整指令的具体程度：允许多种正确做法时，说明目标和理由；操作依赖固定顺序或一致性时，把要求写具体。同一份 Skill 的不同部分也应分别判断。

这三个例子是将官网原则应用到本站任务的教学说明。7.5 展示官网例子的中文译文，并用完整的 write-learning-unit 教学稿串起三个判断。

校准控制程度之后，再选择实现方式：目标和理由帮助 Agent 判断，默认值减少无谓选择，脚本执行需要一致的操作，验证器检查可测量的结果。指令写得严格，仍需区分它是否由实际运行机制执行。

7.6 有效指导的模式

7.5 决定每一步需要多大自由度。7.6 按官网 Patterns for effective instructions 拆成六个独立页面，每页围绕一个问题展开解决方案。

这一组有六种模式。先指出执行中的问题，再选择能改善它的做法；原文也强调，每份 Skill 按需要采用其中的模式。

六种模式可以相互配合。例如，易错点提醒字段别名，模板规定输出结构，清单跟踪步骤，验证器检查结果；批量操作先验证计划，重复的检查逻辑再提取为脚本。这个配合关系是教学组织方式，不是所有任务都必须执行的固定顺序。

每个页面都包含问题、解决方案、完整最小示例和检查方式。验证循环与脚本页面记录了隔离练习中的实际运行结果；计划验证明确区分官网流程示意与尚未提供的工具实现。脚本部分结合 Using scripts in skills 学习输入、输出、错误信息和调用方式。

需要区分：易错点、模板和清单帮助 Agent 遵循约定；可执行验证器检查它覆盖的条件；脚本封装固定逻辑。仅写下“验证通过后继续”仍需要 Agent 遵循，要强制执行检查与放行，就需要宿主程序落实控制。

Evaluating skill output quality 用来比较整份 Skill 的效果；这里的模式帮助改进单次任务的处理过程，两者相互补充。

7.7 主文件与配套资料

7.7 References 从官网的 SKILL.md、reference.md、examples.md 多文件示例开始，区分正文、参考资料、模板与脚本，再用已有 review-diff 练习展示完整拆分。

这一单元依次解释文件放在哪里、相对链接怎样写、何时读取、哪些内容应留在主文件，以及怎样用实际读取记录检查结果。参考文件可以放在主文件旁边，也可以放进 references/；配套文件仍属于同一份 Skill。

Best practices 有多少个学习点

按原文小标题统计，有 15 个细分主题；另有独立的 Refine with real execution。合起来是 16 个学习点。真实执行后的改进会贯穿每个单元，不必等全部主题读完才开始。

下面按学习任务组织这些主题。表内的问题可以各自形成一个小节，不要求一次完成一整组。“实际执行后改进”从最小 Skill 开始贯穿学习过程。

机制参考

下列资料解释技能的发现、调用、上下文与 Agent Loop，使用此前的 review-diff 示例；可以在写作练习遇到运行机制问题时查阅。