课程定位
一句话目标：让学员把一个重复工作流程固化成可复用、可测试、可评分、可迭代的 Skill 草稿。
本节核心比喻：Skill 是 AI 的技能包；工作流是做菜步骤，Skill 是写好的菜谱；测试样例是试菜记录。
衔接前三节：L2-7 有流程，L2-8 有知识和记忆，L2-9 有 Agent 岗位。本节把它们封装成一句话可触发的 Skill。
当前开源项目映射
| 工程概念 | 小白解释 | 课程里怎么落地 |
|---|---|---|
SKILL.md |
Skill 的说明书和触发规则 | 写清 name、description、流程、输出、边界 |
references/ |
详细资料和参考文档 | 放知识库说明、示例、评分表 |
scripts/ |
稳定重复操作的脚本 | 小白阶段只规划，不强制写代码 |
assets/ |
模板、图片、品牌素材 | 放表格模板、示例文案、风格样本 |
| Evals | 检查 Skill 好不好 | 正常、资料不足、高风险测试 |
| Guardrails | 防止越界 | 发布、付款、审批、删除、隐私默认人工确认 |
课前准备
- L2-7 的
工作流拆解表.md。 - L2-8 的
知识库说明.md和记忆规则.md。 - L2-9 的
Agent设定卡.md。 - 可参考 Skill：
study-companion-kb、data-insight-report、opc-secretary、prompt-builder-engine、openclaw-skill-creator。
课堂流程
| 时间 | 环节 | 老师做什么 | 学员产物 |
|---|---|---|---|
| 0-8 分钟 | 概念 | 讲 Prompt、Agent、Skill 的区别 | 概念复述 |
| 8-20 分钟 | 结构 | 讲 SKILL.md、references/、assets/ |
Skill 骨架 |
| 20-35 分钟 | 输入输出 | 固定触发、输入、步骤、交付物 | 输入输出表 |
| 35-48 分钟 | 测试评分 | 设计 3 类测试和评分表 | 测试清单 |
| 48-60 分钟 | 收尾 | 写 Skill 草稿和 v2 修改建议 | Skill草稿.md |
本节行动导航：把经验封装成可复用的 Skill
| 步骤 | 具体动作 | 推荐工具 | 可复制提示词 | 产出与检查 |
|---|---|---|---|---|
| 1. 写触发句 | 写“当用户需要……并希望……”的 description。 | Claude / ChatGPT + L2-7 工作流 | “把下面工作流改写成 Skill 的触发说明。格式：‘当用户需要【任务】并希望【结果】时触发。’补充 2 个不该触发的反例。工作流：[…]” | 触发句；看一句就能判断是否触发。 |
| 2. 固定输入 | 列出必填、可选、缺失时追问的资料。 | 飞书表格 / Notion / Markdown | “请为【Skill 名称】列出输入规范：必填字段、可选字段、资料来源、缺失字段时的追问。只有资料齐全才进入执行。” | 输入清单；缺关键字段不会硬做。 |
| 3. 固定做法 | 按 Plan / Execute / Verify / Reflect 写入 Skill。 | Claude / ChatGPT + SKILL.md 模板 | “请根据以下工作流生成 SKILL.md 草稿。每步只做一个动作，包含 Plan、Execute、Verify、Reflect；写出输入、输出、验收条件和人工确认点。” | Skill 草稿；至少 5 步，且每步有结果。 |
| 4. 固定交付 | 写文件名、固定栏目、引用资料和风险提示。 | Markdown 模板 / Notion | “请为【Skill 名称】设计固定交付模板，包含文件名、必填栏目、资料引用、待确认事项、风险提示；规划哪些资料放 references/、哪些模板放 assets/。” | 输出模板；结构稳定、事实可回查。 |
| 5. 跑测试 | 跑正常、资料不足、高风险 3 个任务并评分。 | 当前 Skill / Claude / ChatGPT | “请按此 Skill 分别执行正常、资料不足、高风险样例。逐项对照：触发准确、输入清楚、流程完整、输出稳定、安全边界。为不通过项给出写回 SKILL.md 的修改句。” | 测试任务和评分记录；高风险不代办。 |
逐字稿
0-8 分钟：为什么要做 Skill
如果一件事情只做一次，用 Prompt 就够。
如果一件事情需要一个岗位长期做，用 Agent。
如果一件事情每周、每天、每个客户都要按同样流程做，就应该变成 Skill。
Skill 的价值是：把你的经验变成可复用流程。你不用每次重新解释，AI 也不容易跑偏。
今天我们不要求大家写代码。我们先写一个最小 Skill 草稿，让任何人看了都知道这个技能做什么、什么时候触发、需要什么输入、输出什么结果、怎么测试。
8-20 分钟：Skill 的工程结构
一个基础 Skill 至少有 4 个部分：
name：小写英文名，比如weekly-review-assistant。description：什么时候触发，解决什么问题。- 执行流程：第一步做什么，第二步做什么。
- 标准输出：最后交什么文件或内容。
一个更完整的 Skill 可以拆成 4 类文件：
| 文件 / 文件夹 | 作用 | 小白阶段怎么做 |
|---|---|---|
SKILL.md |
放触发规则、核心流程、输出和边界 | 必做 |
references/ |
放详细资料、案例、评分表 | 可先规划 |
scripts/ |
放可重复执行的脚本 | 暂不强制 |
assets/ |
放模板、样例、素材 | 有模板就放 |
这节课的重点不是写复杂代码，而是把 Skill 说明写到别人能复用。
20-35 分钟：输入输出必须固定
新手最容易犯的错误是：输入不清楚，输出也不清楚。如果 Skill 只写“帮我分析一下”，它就不稳定。
我们要写成：
输入：
- 本周完成事项。
- 本周未完成事项。
- 遇到的问题。
- 下周目标。
输出：
- 完成总结。
- 问题分类。
- 下周三件最重要的事。
- 需要人工确认的风险。
越固定，越容易复用。能固定成文件名更好，比如 周复盘.md、下周计划.md、风险确认清单.md。
35-48 分钟：Skill 也要测试和评分
写 Skill 不是写完就算。要测三类情况：
- 正常输入：资料完整。
- 资料不足：用户没有给关键字段。
- 高风险输入：用户要求 AI 编造、发送、付款、审批、删除或泄露隐私。
好的 Skill 应该在正常输入时稳定输出，在资料不足时追问，在高风险输入时拒绝代办并给安全替代方案。
评分维度：
| 维度 | 5 分标准 |
|---|---|
| 触发准确 | 用户一句话就能判断是否该触发 |
| 输入清楚 | 输入字段完整且可检查 |
| 流程完整 | 有 Plan / Execute / Verify / Reflect |
| 输出稳定 | 输出文件和字段固定 |
| 安全边界 | 高风险动作默认人工确认 |
| 可迭代 | 有测试记录和 v2 修改建议 |
48-60 分钟：写 Skill 草稿
现在大家写 Skill草稿.md。不用追求完美，但必须让别人拿到就能理解。
模板如下：
---
name: your-skill-name
description: 当用户需要 xxx，并希望 xxx 时触发。
---
# your-skill-name
## 触发场景
## 输入
## 执行步骤
## 标准输出
## references 规划
## assets 规划
## 人工确认点
## 禁止事项
## 测试样例
## 评分记录
## v2 修改建议
示例 Skill 草稿
---
name: weekly-review-assistant
description: 当用户需要整理一周工作、学习或项目进度，并生成周复盘、下周计划和风险确认清单时触发。
---
# weekly-review-assistant
## 触发场景
用户提供本周记录、目标、问题和下周目标，需要整理成稳定格式的复盘。
## 输入
- 本周记录
- 本周目标
- 遇到的问题
- 下周目标
## 执行步骤
1. Plan：确认资料是否完整，缺失时先追问。
2. Execute：按完成、未完成、问题、机会分类。
3. Execute：总结 3 条本周重点。
4. Verify：检查是否有事实编造、格式缺失、风险事项。
5. Reflect：输出下周三件最重要的事和 v2 改进建议。
## 标准输出
- `周复盘.md`
- `下周计划.md`
- `风险确认清单.md`
## references 规划
- `references/review-template.md`
- `references/evaluation-rubric.md`
## assets 规划
- `assets/周复盘模板.md`
## 人工确认点
- 涉及客户、金额、承诺时间的内容。
- 需要发送给外部人员的内容。
- 涉及绩效、合同、退款、隐私的内容。
## 禁止事项
- 不编造完成事项。
- 不自动发送给外部人员。
- 不替用户承诺截止时间。
## 测试样例
1. 正常输入：本周记录完整。
2. 资料不足：没有下周目标。
3. 高风险：要求编造完成事项并发给老板。
课堂实操提示词
请根据下面的工作流、知识库说明和 Agent 设定卡，生成一个 Skill 草稿。
工作流：
[粘贴 L2-7 工作流]
知识库说明：
[粘贴 L2-8 知识库说明]
Agent 设定卡：
[粘贴 L2-9 Agent 设定]
要求：
1. 生成 SKILL.md 草稿，包含 name、description、触发场景、输入、执行步骤、标准输出。
2. 规划 references/、assets/，scripts/ 只在确实需要稳定重复操作时规划。
3. 写人工确认点和禁止事项。
4. 生成正常、资料不足、高风险 3 个测试样例。
5. 按触发准确、输入清楚、流程完整、输出稳定、安全边界、可迭代 6 项打分。
6. 给出 v2 修改建议。
作业
提交 Skill草稿.md 和 测试任务.md。
验收标准
- 有明确触发场景和
description。 - 输入和输出固定。
- 至少 5 个执行步骤，包含 Plan / Execute / Verify / Reflect。
- 至少 3 个测试样例：正常、资料不足、高风险。
- 有人工确认点、禁止事项和 v2 修改建议。