← COMP5511 全部讲次
T06b · 第 11 周

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 读一遍规则。

回讲义:L09a-3 上下文、记忆与自进化

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 里可以带脚本,装之前要去源仓库看它会做什么,来源信誉也要一起看。

回讲义:L09a-3 上下文、记忆与自进化

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 管怎么做,做什么仍由请求给。

回讲义:L09a-3 上下文、记忆与自进化

逐题拆解

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。

  1. 在上游仓库里打开 ccf-visual-composer/SKILL.md,找 name、description、workflow 和资源链接。

    检查上游 skill 第 1 步:上排第一个框「读上游 SKILL.md」用青绿标出,写着 name、description、workflow,其余四框为灰色

  2. 用命令行或提示词装整个仓库,再查安装路径,确认 agent 能发现它。

    检查上游 skill 第 2 步:上排第二个框「装好并确认」用青绿标出,写着装全套、查路径和可发现性,第一步的框已完成

  3. 解释依赖:它先用 ccf-humanization、再用 ccf-common,只复制 SKILL.md 会断链。Exercise 3 到这里结束。

    检查上游 skill 第 3 步:上排第三个框「解释一项依赖」用青绿标出,写着 ccf-humanization 指向 ccf-common,下排两框仍为灰色

  4. 点名 ccf-visual-composer,给同样两份 CSV 和 Prompt B 的要求,输出存到 skill_output/。

    调用 skill 第 4 步:下排「调用 ccf-visual-composer」框用青绿标出,写着同两份 CSV 加 Prompt B 的要求,从上排依赖框引来一条箭头

  5. 打开 skill_output/,看六个面板和源码,再分清哪一步来自 skill、哪条要求是提示词给的。

    调用 skill 第 5 步:下排「打开 skill_output」框用青绿标出,写着六个面板、源码、缺失的 n、矢量导出,底部说明要分清哪步来自 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 分钟做变式题,先自己写再展开对照。

必背

  1. 任务提示词写这一次的目标和验收,AGENTS.md 写项目一直成立的约定,SKILL.md 写一类任务可复用的流程
  2. 一个 skill 由 name、description 和步骤组成,可附带脚本、参考资料和模板;具体文件、目标和成功条件仍要你提供
  3. 找 skill 的来源:官方示例看 OpenAI Skills 和 Anthropic Skills 仓库,社区发现用 skills.sh 并顺着链接查源仓库
  4. 上游 skill 要整包安装,ccf-visual-composer 依赖 ccf-humanization 和 ccf-common,只复制 SKILL.md 会断链;skill 管通用步骤,数据、版式和导出格式仍由提示词给
  5. AGENTS.md 放在相关项目文件夹里,能否被自动发现和继承取决于客户端,开工前先让 agent 读一遍规则
  6. 延伸的三种扩展: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。」

解法:

  1. 逐句问范围:每句只问一个问题。它只对这一次成立,对整个项目成立,还是对所有作图任务成立?
  2. AGENTS.md:运行环境(.venv 的 Python 3.11、pandas、matplotlib)和数据规矩(只用两份 CSV、不改输入)。整个作图练习都成立。
  3. skill:查 schema 和缺失值、跨 seed 聚合、渲染检查。任何作图任务都要走,对应课件左栏那六行。
  4. 任务提示词:六面板版式、PDF 和 SVG、输出目录、n = 4 的图注。这些只对这一次成立。
  5. 拆完的提示词:点名 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。

下一讲 →
T07a T07a 做一个论文检索工具(上):余弦相似度和先定死的检索设置

个人整理的学习笔记,不是官方材料;数字与结论以课件和讲师为准。