01
先定义任务合同，不急着写 Prompt
明确触发条件、适用边界、输入、产物和停止条件。
本节要点
- 用动词描述要完成的工作结果
- 写清不应该触发的场景
- 把人工确认点放进工作流
动手任务
选择一个每周重复的真实任务，写出一句“输入什么，留下什么产物”。
LEARN / 8 MODULES
从一个真实任务，做出第一个可验证 Skill。
不从 Prompt 技巧开始。先定义任务合同，再组织文件、权限和测试；完成后可以直接进入本地创建器生成标准 Skill 包。
02
认识 Skill 的文件结构
理解 SKILL.md、references、scripts、assets 和 agents 元数据各自负责什么。
本节要点
- SKILL.md 只保留核心流程
- 详细规则按需放进 references
- 模板和输出素材放进 assets
动手任务
打开周计划 Skill 包，对照文件树找到每类信息的唯一归属。
03
写出能正确触发的描述
description 同时回答“做什么”和“什么时候使用”。
本节要点
- 加入用户会说出的具体任务
- 覆盖相近表达和文件类型
- 不要把触发条件藏在正文
动手任务
写 3 句应该触发、2 句不应该触发的用户请求。
04
把输入与输出变成可检查合同
没有明确产物的 Skill 很容易退化成一次聊天。
本节要点
- 区分必填、选填和缺失时停止
- 固定文件名或结构化字段
- 为每个产物写验收条件
动手任务
为你的 Skill 写 2 个必填输入和至少 2 个可检查产物。
05
拆工作流与人工确认门
把模型判断、确定性脚本和人工决定分开。
本节要点
- 脆弱步骤使用低自由度规则
- 写入、删除、发送前暂停确认
- 失败时保留中间产物和原因
动手任务
把流程拆成 3–7 步，并标出至少 1 个人工确认点。
06
只申请完成任务所需的权限
权限不是安装说明末尾的小字，而是任务合同的一部分。
本节要点
- 优先只读，再逐项开放写入
- 网络、脚本和外部发送单独说明
- 写明授权目录与禁止范围
动手任务
列出文件、网络、脚本和外部发送四类权限，删除所有非必要项。
07
组织 Prompt、references 与 assets
把稳定流程留在 Skill，把长资料和模板渐进加载。
本节要点
- 避免在多个文件重复同一规则
- 给 references 明确读取时机
- 脚本用于重复且需要确定性的步骤
动手任务
把一段长 Prompt 拆成核心步骤、参考规则和输出模板。
08
用正常、异常和负向测试决定能否发布
好的 Skill 不是只跑通一次，而是知道什么时候应该停。
本节要点
- 至少准备正常、缺失输入、超出权限三类测试
- 保存失败与已知限制
- 版本变化后重复运行固定夹具
动手任务
为自己的 Skill 写 3 个测试，并明确每个测试的通过条件。