T06b Vibe Coding 上手课(下):分清三层说明,检查并调用上游 skill
Exercise 3–4 走一遍 vibe coding 的后半段:分清任务提示词、AGENTS.md、SKILL.md 各管什么,学会去哪里找 skill,检查并整包安装上游作图 skill,再调用它画同一张六面板图。
一句话版
T06a 讲的是怎样把一次任务说清楚。本页讲哪些话不必每次都说。项目里一直成立的规矩写进 AGENTS.md。一类任务都要走的流程交给 skill。这一次的数据、版式和交付格式,仍然只能写在提示词里。
先认识这几个词
读之前最好先看过讲义里上下文和记忆的那一节,见 L09a-3。
| 词 | 全称 / 读法 | 一句人话 |
|---|---|---|
| 任务提示词 | task prompt | 这一次交给 agent 的任务说明 |
| AGENTS.md | 项目规则文件 | 放在项目文件夹里,写这个项目一直成立的规矩 |
| skill | 技能包 | 一类任务的可复用流程,核心是一份 SKILL.md |
| SKILL.md | skill 的说明文件 | 开头写 name 和 description,正文写步骤 |
| 上游 | upstream | skill 的原始仓库,你装的是它的一份拷贝 |
| 依赖 | dependency | 一个 skill 要用到的另一个 skill 或文件 |
| 矢量导出 | PDF / SVG | 放大不会糊的图片格式,和 PNG 相对 |
题目地图
| 顺序 | 题目 | 时长 | 考什么 | 主要失分点 |
|---|---|---|---|---|
| 3 | Exercise 3:检查并安装上游 skill | 2 分钟,课前装好 | skill 的结构、整包安装、依赖 | 只复制 SKILL.md,说不出依赖为什么断 |
| 4 | Exercise 4:调用真实 skill 再对比 | 3 分钟 | skill 和提示词的分工 | 以为用了 skill 就不用写提示词,漏了 SVG |
两道题接着 T06a 的六面板图往下做。用的还是那两份 CSV,验收标准也一样。区别在于这次把一部分要求交给 skill。
概念卡
1. 提示词、AGENTS.md、SKILL.md 各管什么
人话定义:三份文字都是写给 agent 看的,管的范围不同。任务提示词只管这一次:目标是什么、怎样算做完。AGENTS.md 放在项目文件夹里,写这个项目一直成立的规矩。SKILL.md 存一类任务的通用流程。
例子:「把这两份 CSV 画成六个面板」只对这一次成立,写进提示词。「用 .venv 里的 Python 3.11,不改输入文件」对整个作图练习都成立,写进 AGENTS.md。「检查、聚合、画图、渲染、核对」是任何作图任务都要走的流程,交给 skill。
课件给的 AGENTS.md 示例标题是 Plotting lab rules,下面分四节:
| 小节 | 原文 |
|---|---|
| Runtime | Use .venv/bin/python (Python 3.11). Use pandas and matplotlib. |
| Data | Use the two supplied CSVs only. Source: COMP5511 synthetic data. Keep inputs unchanged. |
| Style and scope | Use consistent colors and vector PDF/SVG. Do not add test files or file hashes. |
| Verification | Run the script; check one mean/SD and exports. |
课件在旁边补了三句。第一句说 agent 会在不同任务之间重复使用这些项目规则。第二句说范围要分清,这份只管作图练习。第三句说就算不写测试,仍要跑代码、核数字、看图。
常见误解
以为写了 AGENTS.md 就一定会被读到 → 课件注明,它能不能被自动发现、子文件夹会不会继承,取决于你用的客户端。稳妥的做法是开工前先让 agent 读一遍规则。
2. skill 是什么,去哪里找
人话定义:skill 存的是一类反复出现的任务的做法。name 和 description 帮 agent 判断什么时候该用它。正文是步骤,还可以附带脚本、参考资料和模板。具体用哪个文件、要达到什么目标、怎样算成功,仍然要你给。
例子:课件列了三个找 skill 的地方。
- 官方示例:OpenAI Skills 和 Anthropic Skills 两个 GitHub 仓库。
- 社区发现:skills.sh。课件提醒要顺着链接去看源仓库,不只看网站上的介绍。
- 用 skill 找 skill:find-skills 按领域和任务推荐,提供 find 和 add 两个命令,并参考安装量、来源信誉和 GitHub stars。
在 WorkBuddy 里,Skills 页右上角点 Add Skill,有三个入口。Find Skill 搜索已有流程,Upload Skill 导入本地包,Create Skill 描述一个流程来新建。课上的练习走 Add Skill 再 Upload Skill。
常见误解
以为安装量高就可以放心装 → 安装量只是推荐时参考的一项。skill 里可以带脚本,装之前要去源仓库看它会做什么,来源信誉也要一起看。
3. 课件演示的三个 skill
人话定义:课件用三个 skill 说明「先说清再动手」可以交给流程来管。grill-me 用来想清楚需求。pptx 用来做幻灯片。CCFA-Skills 用来画科研图。
例子:
| skill | 做什么 | 课件里的示例请求 |
|---|---|---|
| grill-me | 一轮轮提问,把模糊的想法变成清楚的计划;先定下前面的决定,再问依赖它的问题 | 用 grill-me 帮忙设计一个论文搜索应用,写代码前先把计划定清楚 |
| pptx | 创建、读取、编辑 PowerPoint;复用模板,保留数据和引用,检查渲染后的版面 | 把一份实验简介做成八页可编辑的教学幻灯片,保留模板和实测数值 |
| CCFA-Skills | 把给定的科研内容画成图,调整版式、统一风格 | 用 ccf-visual-composer 把两份 CSV 画成六个面板,均值 ±1 SD,导出 PDF 和 SVG |
grill-me 示例里,agent 先问模型和 top-k、前后端框架、用哪种数据库。这几项定下来之后,后面的设计才有依据。
常见误解
以为 skill 会替你决定数据和格式 → 三个示例请求里,数据、页数、面板数和导出格式都是用户自己写的。skill 管怎么做,做什么仍由请求给。
逐题拆解
Exercise 3:检查并安装上游 skill
这道题做三件事。第一,在 CCFA-Skills 仓库里打开 ccf-visual-composer/SKILL.md。找到 name、description、workflow 和资源链接。第二,按你用的客户端装好它,查安装路径,确认 agent 能发现它。第三,解释为什么作图 skill 要连着 ccf-common 和 ccf-humanization 一起装。
课件只给 2 分钟,所以要求课前装好。命令行装法以 Codex 为例:
npx skills add mikubaka88/CCFA-Skills \
--global --agent codex --skill '*' --yes --copy
npx skills list --global --agent codex
装之前要有 Git 和受支持的 Node.js。上游说明里测试过的是 Node.js 22.20.0 及以上。也可以用提示词,让 agent 按仓库地址替你安装。
一步一步看
目标:把 Exercise 3 和 Exercise 4 连起来走一遍,看读、装、查依赖、调用、对证据各要确认什么。
上排三框是 Exercise 3,下排两框是 Exercise 4。
-
在上游仓库里打开 ccf-visual-composer/SKILL.md,找 name、description、workflow 和资源链接。
-
用命令行或提示词装整个仓库,再查安装路径,确认 agent 能发现它。
-
解释依赖:它先用 ccf-humanization、再用 ccf-common,只复制 SKILL.md 会断链。Exercise 3 到这里结束。
-
点名 ccf-visual-composer,给同样两份 CSV 和 Prompt B 的要求,输出存到 skill_output/。
-
打开 skill_output/,看六个面板和源码,再分清哪一步来自 skill、哪条要求是提示词给的。
方法与验收
装完跑一次 list 命令,能在列表里看到 ccf-visual-composer 才算装好。
提示
打开 SKILL.md 后找它里面的相对路径,看它们指向哪个文件夹。再想一想,只把这一个文件拷走,这些路径还能不能找到东西。
解答
以下按 2026-11-12 打开上游仓库时的内容。仓库还在更新,你看到的可能不同。
- name 是 ccf-visual-composer。
- description 大意是:根据给定内容绘制或重画科研图、可视化表格和方法图,保持数值和结构不变。
- workflow 是一串编号步骤。其中一步要用 resources 文件夹里的作图库选图型。
- 另有一张表,列出什么情况下去读 references 里的哪份说明。
- 文件夹里除了 SKILL.md,还有 agents、references、resources、scripts 四个子文件夹。
依赖:SKILL.md 写明先应用 ccf-humanization,再应用 ccf-common。它还用 ../ccf-common/references/ 这样的相对路径引用好几份规则文件。这些文件在同级的另一个文件夹里。只复制 SKILL.md,这些链接全部断掉,skill 读不到规则,也用不了自带的脚本和资源。
课件的安装命令因此用 –skill ‘*’ 装整个仓库,用 –copy 复制完整的源文件。
Exercise 4:调用真实 skill 再对比
用同样两份 CSV 调用 ccf-visual-composer,按 Prompt B 的要求画六面板图。打开结果,检查六个面板和可运行的源码。确认聚合方式、SD 的含义、缺失那一点的 n、编码一致和矢量导出。最后各找一条证据:一条是 skill 替你提供的可复用步骤,一条是提示词还得自己写的任务要求。
课件里调用时的提示词有三个意思。点名 ccf-visual-composer 画这两份 CSV。六面板版式、统计方法和验收标准照 Prompt B。源码和 PDF/SVG 存进 skill_output/,并检查渲染结果。
提示词里提到的那个文件材料包里没有。材料说明让你直接用课件里 Prompt B 的要求。
方法与验收
检查项和 Exercise 2 相同。
- 六个面板齐全,源码能重跑。
- 聚合跨 seed,图注写明 SD 是样本标准差。
- 缺失那一点标了 n。
- 颜色和标记一致,PDF 和 SVG 都在。
提示
课件讲这个 skill 用法的那一页,左栏列了六行「每次都要重复说的话」。拿它和你自己写的提示词对照,看哪几行可以不写了,哪几句还非写不可。
解答
skill 提供的可复用步骤,课件左栏列了六行,举一条即可:
- 先查 schema 和缺失值。
- 跨独立 seed 正确聚合。
- 编码和单位前后一致。
- 保留观测值和数据出处。
- 导出源码和矢量文件。
- 渲染后检查结果。
用了 skill,这几行就不必每次写。
提示词仍要给的任务要求,也举一条即可:
- 用哪两份 CSV,画成 2 × 3 六个面板。
- 输出存到 skill_output/。
- 要 PDF 和 SVG。这一条最容易漏:上游 SKILL.md 写的是默认交 PNG,要 SVG 必须明确提出。
- 缺失的 Toy-C / Large / seed 4 / epoch 100 要在图注里标出 n = 4。
skill 管的是任何作图任务都要走的流程。这一次的数据、版式和格式只能由提示词给。
课件里的坑
- [读图提醒] 本页覆盖课件 p.27–28 和 p.30–45。从 p.35 起右下角印的页码乱了,例如 p.35 印 32、p.42 印 45、p.45 印 48。本页引用的页码都按实际页序。
- [课件留白] 提示词文件名对不上:p.39 写 figure_prompt_B.txt,p.41 写 ccfa_plot_prompt.txt,材料包里两个都没有。材料说明写明直接用 p.24–25 的 Prompt B 要求。
- [读图提醒] p.37 写 “It improve layout”,应为 improves;p.35 示例对话里 agent 的三个问题都以句号结尾。
- [课件留白] p.28 的 AGENTS.md 示例是缩写版。材料包里的 AGENTS.example.md 多了几条:不装额外的包,不下载或编造数值,每格方法颜色和标记一致,不算文件哈希、不建缓存。做练习时用材料包那份。
- [课件留白] p.28 说这个作图练习不加测试文件,并注明这条只管本次作图练习,Tutorial 2 明确要求写测试。
- [课件留白] p.27 页底说明,AGENTS.md 能不能被自动发现、子文件夹会不会继承,取决于你用的客户端。
- [课件留白] p.43 的 hook 示例让 PostToolUse 跑 python plot.py,可这节课的材料包里没有 plot.py。p.44 的 subagent 示例审查的是 plot_complex.py,材料包里同样没有。这两页是延伸阅读,读懂机制即可。
- [补充] p.42 的标题 Bitter Lesson 借用了 Rich Sutton 2019 年同名文章的名字,讲的却是另一件事。Sutton 原文的论点是:回看 70 年 AI 研究,能利用算力的通用方法最终最有效。课件这一页讲的是「要做代码审查,清楚自己要什么、agent 做了什么」。考到时注意分清这两层意思。
课后 10 分钟:考点复习
这 10 分钟怎么用:前 3 分钟读必背 6 条,重点是第 1 条和第 4 条;中间 4 分钟做完整例题;最后 3 分钟做变式题,先自己写再展开对照。
必背
- 任务提示词写这一次的目标和验收,AGENTS.md 写项目一直成立的约定,SKILL.md 写一类任务可复用的流程
- 一个 skill 由 name、description 和步骤组成,可附带脚本、参考资料和模板;具体文件、目标和成功条件仍要你提供
- 找 skill 的来源:官方示例看 OpenAI Skills 和 Anthropic Skills 仓库,社区发现用 skills.sh 并顺着链接查源仓库
- 上游 skill 要整包安装,ccf-visual-composer 依赖 ccf-humanization 和 ccf-common,只复制 SKILL.md 会断链;skill 管通用步骤,数据、版式和导出格式仍由提示词给
- AGENTS.md 放在相关项目文件夹里,能否被自动发现和继承取决于客户端,开工前先让 agent 读一遍规则
- 延伸的三种扩展:hook 在代码改动后自动跑验证脚本,MCP 把 agent 连到外部工具,subagent 把独立的审查分给不同 agent 并行做
完整例题
题面:一位同学每次作图都把下面这段话整段贴给 agent。把它拆进任务提示词、AGENTS.md 和 skill 三层,并说明拆完后提示词还剩什么。
「用 .venv 里的 Python 3.11 和 pandas、matplotlib。只用给定的两份 CSV,不改输入文件。先查 schema 和缺失值,跨 seed 聚合,画完渲染检查。这次把两份 CSV 画成 2 × 3 六个面板,导出 PDF 和 SVG,存到 skill_output/。图注写明 Toy-C / Large / epoch 100 的 n = 4。」
解法:
- 逐句问范围:每句只问一个问题。它只对这一次成立,对整个项目成立,还是对所有作图任务成立?
- AGENTS.md:运行环境(.venv 的 Python 3.11、pandas、matplotlib)和数据规矩(只用两份 CSV、不改输入)。整个作图练习都成立。
- skill:查 schema 和缺失值、跨 seed 聚合、渲染检查。任何作图任务都要走,对应课件左栏那六行。
- 任务提示词:六面板版式、PDF 和 SVG、输出目录、n = 4 的图注。这些只对这一次成立。
- 拆完的提示词:点名 ccf-visual-composer,给两份 CSV、版式、格式、目录和那条缺失说明。
自查:PDF 和 SVG 那句不能交给 skill。上游默认交 PNG,不写就拿不到矢量图。n = 4 那句也不能进 AGENTS.md,换一份数据它就不成立了。
答题格式:按三层各列一栏,每栏写放进去的句子。每栏末尾写一句理由:只这一次、整个项目、还是所有同类任务。
变式题(先自己做)
改编自课件 p.27、p.31、p.38–41。
(a) 下面四句话,分别该写进任务提示词、AGENTS.md 还是 SKILL.md?① 这次把两份 CSV 画成六个面板;② 本项目一律用 .venv/bin/python,不改输入文件;③ 作图前先查 schema 和缺失值,画完渲染检查;④ 这次的图注要写明 Toy-C / Large / epoch 100 的 n = 4。
(b) 有同学嫌装整个仓库太慢,只把 ccf-visual-composer/SKILL.md 拷进自己的 skill 文件夹。调用时会出什么问题?课件的安装命令里哪两个参数是在防这件事?
(c) 用了 ccf-visual-composer,提示词里只写「画这两份 CSV 的六面板图」。交上来的是 PNG。问题出在哪里?提示词该补哪一句?
提示
(a) 每句问一个问题:它只对这一次成立、对整个项目成立,还是对所有同类任务成立?(b) 回到 Exercise 3 的解答,看 SKILL.md 里的路径指向哪里。(c) 回到 Exercise 4 的解答,找上游默认的导出格式。
判分点与答案(非官方评分标准)
判分点:① (a) 四句全部归对;② (b) 说出相对路径断链和缺规则;③ (b) 说出 –skill ‘*’ 和 –copy;④ (c) 说出上游默认 PNG,并写出补的那一句。
(a) ① 任务提示词,只对这一次成立。② AGENTS.md,整个项目一直成立。③ SKILL.md,任何作图任务都要走的流程。④ 任务提示词,缺的是这份数据里的特定一条,换一份数据就不一样。
(b) SKILL.md 要先应用 ccf-humanization 和 ccf-common,还用相对路径引用 ccf-common 里的规则文件。只拷一个文件,这些链接全部断掉。skill 读不到规则,自带的脚本和资源也没有。–skill ‘*’ 装整个仓库,–copy 复制完整的源文件。
(c) 上游 SKILL.md 默认交 PNG,skill 不会替你改成矢量图。提示词要补一句:导出 figure.pdf 和 figure.svg,连同源码存进 skill_output/。
闪卡自测
1. 任务提示词、AGENTS.md、SKILL.md 各提供什么?
任务提示词:这一次的目标和验收;AGENTS.md:项目或文件夹的约定,如运行环境、数据来源、风格和范围;SKILL.md:可复用的任务流程,如检查、聚合、画图、渲染、核对(p.27)。
2. 课件的 AGENTS.md 示例分哪四节?
Runtime、Data、Style and scope、Verification(p.28)。
3. 一个 skill 由哪几部分组成?用了它还要你提供什么?
name 和 description 帮 agent 判断何时用它,正文是步骤,可选附带脚本、参考资料和模板。具体文件、目标和成功条件仍要你给(p.31)。
4. 课件列了哪几个找 skill 的地方?
官方示例:OpenAI Skills、Anthropic Skills 仓库;社区发现:skills.sh,顺着链接查源仓库;还可以用 find-skills 这个 skill 去找 skill(p.32–33)。
5. WorkBuddy 的 Add Skill 有哪三个入口?
Find Skill 搜索已有流程,Upload Skill 导入本地包,Create Skill 描述一个流程来新建。课上练习用 Add Skill 再 Upload Skill(p.34)。
6. grill-me 和 pptx 各做什么?
grill-me:一轮轮提问,把模糊想法变成清楚计划,先定前面的决定再问依赖它的问题。pptx:创建、读取、编辑 PowerPoint,复用模板、保留数据和引用、检查渲染版面(p.35–36)。
7. 课件的安装命令里,--skill '*' 和 --copy 各起什么作用?
–skill ‘*’ 装整个仓库里的全部 skill,–copy 复制完整的源文件。两者一起保证依赖的兄弟文件夹也在(p.38)。
8. 为什么不能只复制 ccf-visual-composer 的 SKILL.md?
它要先应用 ccf-humanization 和 ccf-common,并用相对路径引用 ccf-common 里的规则文件。只拷一个文件,这些链接全断(p.40)。
9. Exercise 4 要各找哪两条证据?
一条是 skill 提供的可复用步骤,一条是提示词仍要自己给的任务要求(p.41)。
10. 课件延伸阅读提到哪三种扩展方式?
Hook:代码改动后自动运行验证脚本;MCP:把 agent 连到外部工具,比如官方文档;Subagent:把彼此独立的审查分给不同 agent 并行做(p.43–44)。
11. 课件 Bitter Lesson 那一页要你记住什么?
要做代码审查,清楚自己要什么、agent 做了什么。它借用了 Sutton 文章的名字,意思不同(p.42)。
12. 课程最后的回顾提了哪四个问题?
agent 实际读了哪些文件夹和文件;五要素里哪一项改变了结果;哪些步骤现在可以复用;有什么证据说明脚本能用(p.45)。
下一步
把课件最后那四个回顾问题当成检查清单。以后每次让 agent 写代码,都按这四个问题过一遍:它读了哪些文件,提示词里哪一项起了作用,哪些步骤值得存进 AGENTS.md 或 skill,你手里有什么证据说明结果对。下一讲 T07a 接着练 vibe coding。课件已经提醒那一讲要求写测试,本讲「不加测试文件」的规矩不要带过去。想回顾前半段的提示词五要素和手算 SD,回到 T06a;讲义部分见 L09a-3。
个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。