Skill 从 0 到 1:零基础喂饭式完整课程(第 1~2 天)
课程定位
本文件是四天完整课程的第 1~2 天,负责 Agent Skills 的核心设计、实现、验收与迭代。 Claude Code 专属的高级 frontmatter、Subagents、Hooks、MCP、Plugins、权限与分发,在第 3~4 天扩展篇。
完整课程入口:Anthropic Claude Code Skill 与扩展体系:四天完整课程 授课前必读:教案审核报告
基线版本:Claude Code 2.1.220(2026-07-24 构建)。字段与命令均已对本机二进制核实。
01.这门课怎么用
这不是一份"介绍 Skill 的 PPT 大纲",而是一套可以直接带班的实操课。学员从一个空文件夹开始,最终独立做出、测试并讲解一个可用的 Skill。
推荐两天制,共 12~13 小时。零基础学员压缩成半天,通常只能"听懂概念",无法真正掌握选题、触发、资源设计、测试和迭代。
全课程只使用一个贯穿案例:
把 PRD 的功能需求章节,转成结构完整、可追溯、能被脚本判定的测试用例集。
[案例细节略]
配套示范 Skill:examples/prd-to-testcases/
配套课堂材料:class-materials/
讲师须知:PRD 是客户资料
课堂使用的 PRD 摘录标注为「内部使用」。投影可以,发给学员留存需客户书面同意。 课后回收或删除。这一条本身也是课堂内容:Skill 会读取企业资料,资料边界是 Skill 设计的一部分。
02.结课时学员必须真正会什么
- 用自己的话解释 Prompt、Tool、Workflow、Agent 和 Skill 的区别。
- 判断一个任务是否值得做成 Skill。
- 把模糊想法收敛成明确的输入、输出、流程和验收标准。
- 创建符合规范的 Skill 目录与
SKILL.md。 - 写出能正确触发、又不会乱触发的
description。 - 判断内容应该放在
SKILL.md、references/、assets/还是scripts/。 - 用正向、负向、边界和安全测试发现问题。
- 把手工测试固化成 eval 用例,用 Δ 证明这只 Skill 有没有用。
"听懂"不算结业。"照着老师复制成功"也不算结业。学员必须独立完成一个新 Skill,并通过评分表。
03.课程总安排
第一天:从不会到做出第一个 Skill
| 单元 | 内容 | 时间 | 学员产出 |
|---|---|---|---|
| 0 | 开场与前测 | 20 分钟 | 一张课前认知卡 |
| 1 | Skill 到底是什么 | 40 分钟 | 五个概念的区分表 |
| 2 | 什么任务适合做 Skill | 45 分钟 | 一个合格选题 |
| 3 | Skill 如何被发现和加载 | 50 分钟 | 一张三层加载图 |
| 4 | 用设计画布定义 Skill | 60 分钟 | 完整设计画布 |
| 5 | 创建目录和 frontmatter | 70 分钟 | 能被识别的最小 Skill |
| 6 | 写出可执行工作流 | 75 分钟 | 可运行的 instruction-only Skill |
第二天:从"能跑"到"可靠、可复用、可证明"
| 单元 | 内容 | 时间 | 学员产出 |
|---|---|---|---|
| 7 | references、assets、scripts | 80 分钟 | 完整资源目录 |
| 8 | 验收脚本、真相源与门禁存活 | 80 分钟 | 一次 PASS + 每道门禁的反例 |
| 9 | 从人工探针到 eval | 100 分钟 | 一套 eval 用例 + Δ |
| 10 | 安全、权限与治理 | 45 分钟 | 风险边界清单 |
| 11 | 独立结业项目 | 120 分钟 | 一个全新的 Skill |
| 12 | 演示、评分与复盘 | 45 分钟 | 结业评分与改进计划 |
04.课前准备
讲师准备
- 把整个
skill-zero-to-one-course文件夹发给学员(PRD 摘录按保密要求处理)。 - 提前跑通两条命令,确认环境正常:
[案例细节略]
- 确认
claude plugin eval是否对讲师账号开放(见单元 9)。 - 提前演示一次示范 Skill,但不要把所有答案讲完。
- 确认课堂环境能创建文件夹、编辑纯文本、运行 Python 3。
学员准备
- 一台可以创建文件和文件夹的电脑。
- 一个文本编辑器,或能操作本地文件的 AI 工具。
- 不要求会编程。
- 带一个自己工作中每周或每月会重复出现的任务。
讲师必须反复强调的四句话
- "Skill 不是一段更长的提示词,而是一套可以重复执行的工作方法。"
- "先把 instruction-only Skill 做对,再考虑加脚本。"
- "没有测试过触发和边界,就不能说 Skill 已经完成。"
- "验收脚本绿了,只说明脚本没报错,不说明 Skill 是对的——除非这个脚本的判据来自 Skill 之外。"