# L2-10 把重复工作变成一句话：个性化 Skill 制作

## 课程定位

**一句话目标**：让学员把一个重复工作流程固化成可复用、可测试、可评分、可迭代的 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. 写触发句 | 让人和 AI 都知道何时该用 | 用“当用户需要……并希望……”写 description | 元宝、豆包、Kimi 或通义 + L2-7 工作流 | “把下面工作流改写成 Skill 的触发说明。格式：‘当用户需要【任务】并希望【结果】时触发。’补充 2 个不该触发的反例。工作流：[…]” | Skill 触发句 | 看一句话就能判断该不该触发 |
| 2. 固定输入 | 避免每次输入不同导致输出飘 | 列出必填资料、可选资料、缺失时的追问 | 飞书表格 / 腾讯文档 / WPS / Markdown | “请为【Skill 名称】列出输入规范：必填字段、可选字段、资料来源、缺失字段时的追问。只有资料齐全才进入执行；不要把猜测当输入。现有流程：[…]” | 输入清单 | 缺少关键字段时不会硬做 |
| 3. 固定做法 | 把 L2-7 流程写成可执行说明 | 按 Plan / Execute / Verify / Reflect 排顺序 | 元宝、豆包、Kimi 或通义 + `SKILL.md` 模板 | “请根据以下工作流生成 `SKILL.md` 草稿。每一步只做一个动作，包含 Plan、Execute、Verify、Reflect；写出每步输入、输出、验收条件和人工确认点。不要新增资料外规则。” | `SKILL.md` 草稿 | 至少 5 步，且每步有明确结果 |
| 4. 固定交付 | 让输出能复查、能交给下一步 | 写文件名、固定栏目、引用资料和风险提示 | 腾讯文档 / 飞书文档 / WPS / Markdown 模板 | “请为【Skill 名称】设计固定交付模板，包含文件名、必填栏目、资料引用、待确认事项、风险提示；并规划哪些资料放 references/、哪些模板放 assets/。” | 输出模板 | 每次结果结构基本一致，事实可回查 |
| 5. 跑测试 | 把 Skill 从好看的说明变成可用能力 | 跑正常、资料不足、高风险 3 个任务并评分 | Coze 或扣子智能体 / 元宝、豆包、Kimi 或通义 | “请按此 Skill 分别执行正常、资料不足、高风险样例。逐项对照：触发准确、输入清楚、流程完整、输出稳定、安全边界。对每个不通过项给出写回 `SKILL.md` 的具体修改句。” | `测试任务.md`、评分记录 | 高风险不代办；不通过项有明确改法 |

## 逐字稿

### 0-8 分钟：为什么要做 Skill

如果一件事情只做一次，用 Prompt 就够。  
如果一件事情需要一个岗位长期做，用 Agent。  
如果一件事情每周、每天、每个客户都要按同样流程做，就应该变成 Skill。

Skill 的价值是：把你的经验变成可复用流程。你不用每次重新解释，AI 也不容易跑偏。

今天我们不要求大家写代码。我们先写一个最小 Skill 草稿，让任何人看了都知道这个技能做什么、什么时候触发、需要什么输入、输出什么结果、怎么测试。

### 8-20 分钟：Skill 的工程结构

一个基础 Skill 至少有 4 个部分：

1. `name`：小写英文名，比如 `weekly-review-assistant`。
2. `description`：什么时候触发，解决什么问题。
3. 执行流程：第一步做什么，第二步做什么。
4. 标准输出：最后交什么文件或内容。

一个更完整的 Skill 可以拆成 4 类文件：

| 文件 / 文件夹 | 作用 | 小白阶段怎么做 |
| --- | --- | --- |
| `SKILL.md` | 放触发规则、核心流程、输出和边界 | 必做 |
| `references/` | 放详细资料、案例、评分表 | 可先规划 |
| `scripts/` | 放可重复执行的脚本 | 暂不强制 |
| `assets/` | 放模板、样例、素材 | 有模板就放 |

这节课的重点不是写复杂代码，而是把 Skill 说明写到别人能复用。

### 20-35 分钟：输入输出必须固定

新手最容易犯的错误是：输入不清楚，输出也不清楚。如果 Skill 只写“帮我分析一下”，它就不稳定。

我们要写成：

输入：

- 本周完成事项。
- 本周未完成事项。
- 遇到的问题。
- 下周目标。

输出：

- 完成总结。
- 问题分类。
- 下周三件最重要的事。
- 需要人工确认的风险。

越固定，越容易复用。能固定成文件名更好，比如 `周复盘.md`、`下周计划.md`、`风险确认清单.md`。

### 35-48 分钟：Skill 也要测试和评分

写 Skill 不是写完就算。要测三类情况：

1. 正常输入：资料完整。
2. 资料不足：用户没有给关键字段。
3. 高风险输入：用户要求 AI 编造、发送、付款、审批、删除或泄露隐私。

好的 Skill 应该在正常输入时稳定输出，在资料不足时追问，在高风险输入时拒绝代办并给安全替代方案。

评分维度：

| 维度 | 5 分标准 |
| --- | --- |
| 触发准确 | 用户一句话就能判断是否该触发 |
| 输入清楚 | 输入字段完整且可检查 |
| 流程完整 | 有 Plan / Execute / Verify / Reflect |
| 输出稳定 | 输出文件和字段固定 |
| 安全边界 | 高风险动作默认人工确认 |
| 可迭代 | 有测试记录和 v2 修改建议 |

### 48-60 分钟：写 Skill 草稿

现在大家写 `Skill草稿.md`。不用追求完美，但必须让别人拿到就能理解。

模板如下：

```markdown
---
name: your-skill-name
description: 当用户需要 xxx，并希望 xxx 时触发。
---

# your-skill-name

## 触发场景

## 输入

## 执行步骤

## 标准输出

## references 规划

## assets 规划

## 人工确认点

## 禁止事项

## 测试样例

## 评分记录

## v2 修改建议
```

## 示例 Skill 草稿

```markdown
---
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. 高风险：要求编造完成事项并发给老板。
```

## 课堂实操提示词

```text
请根据下面的工作流、知识库说明和 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 修改建议。