Skill 是什么，
什么时候值得做

这节课要完成什么

1. 知道一个 Skill 里通常有哪些内容；
2. 分清 Skill、提示词、项目规则、模板和脚本；
3. 判断哪些重复任务适合做成 Skill；
4. 知道哪些情况应该继续试验，暂时不做 Skill；
5. 为第一个 Skill 写清输入、步骤、产出和检查方法。

Skill 就是一套可以重复使用的做事方法

每个 Skill 通常有一个入口文件 SKILL.md。它会告诉 Codex：什么任务需要使用这套方法、开始前要读什么、按照什么顺序操作、结果保存在哪里，以及最后怎样检查。Skill 还可以带上参考资料、脚本、模板和品牌素材。

my-skill/
├── SKILL.md          # 入口、使用条件、步骤和规则
├── references/       # 需要时再读取的资料
├── scripts/          # 可以重复运行的小工具
├── templates/        # 固定的交付格式
└── assets/           # 品牌、示例或必要素材

五种复用方式怎么选择

满足这些条件，才值得封装

1. 同类任务已经重复出现至少数次；
2. 流程主干稳定，输入差异可以被清楚描述；
3. 有明确产出格式与保存位置；
4. 质量可以通过清单、测试或人工标准验证；
5. 错误代价足以需要固定安全边界；
6. 参考资料和素材有明确真源；
7. 封装后能显著减少漏项与重复解释。

这些情况先继续用任务和文档

先写清使用说明，再创建目录

这份简短说明也可以叫作“Skill 合同”。它用来写清 Skill 在什么情况下启动、需要什么输入、会怎样处理、交付什么结果，以及哪些事情禁止做。

名称：yuntu-design-system
触发：设计、实现或审查云途品牌与软件界面
输入：任务类型、目标平台、真实业务内容、适用品牌资产
过程：识别模式 → 读取规则 → 选择组件 → 实现 → 视觉与功能验证
产出：页面 / 物料 / 审查报告 + 修改文件 + 证据
禁止：重画 Logo、使用旧铜色、复制历史软件 UI
验证：品牌资产、色值、组件、响应式、交互和业务事实清单

这份说明也会把尚未确定的部分暴露出来。例如软件按钮和交互还没定稿，就先让 Skill 引用持续更新的设计系统，不要把某一版页面截图写死。

入口短，细节按需读取

SKILL.md 应包含必须执行的主流程，把特定平台、物料类型和长参考放进 references。只有任务需要时才读取，避免每次触发都加载全部公司材料。

网站任务 → references/web.md
桌面软件 → references/desktop.md
品牌物料 → references/brand-assets.md
PPT → references/presentation.md
发布验收 → references/release-qa.md

Skill 也需要测试任务

1. 正向触发：一句符合描述的真实请求是否会使用 Skill；
2. 负向触发：无关任务是否不会误触发；
3. 缺少输入：能否指出真正会改变结果的信息；
4. 安全边界：是否拒绝重画 Logo 或连接生产；
5. 产出验证：是否真的生成要求文件并运行检查；
6. 更新能力：参考资料变化后能否只更新一处。

决定是否做 Skill 的诊断提示词

视频录制与复习提纲

1. 用真实任务比较五种复用方式；
2. 拆解一个 Skill 目录；
3. 用七个条件做封装判断；
4. 展示过早封装的风险；
5. 写出 yuntu-design-system Skill 合同；
6. 设计正向、负向和安全测试。