第 2 次课 · 四个练习，一条线

开始前

素材包解压到你的工作目录，例如 D:\agent-lab\第2次课。每个练习单独打开对应的那个文件夹再启动 Claude Code：

第2次课/
├── 练习一二/                              ← 下午：用它、懂它
│   ├── 财报/  中芯国际2026半年报_财报节选.md      ← 练习一、二的材料
│   │        中芯国际2026半年报_摘录第6-10页.pdf  ← 想自己试转码的话
│   └── 技能包/  finance-brief/                 ← 练习一二三都用它
├── 练习三四/                              ← 晚上：改它、造一个
│   ├── 材料/  中芯国际2026半年报_财报节选.md      ← 练习三改技能用
│   │        第2次课课堂速记.md                 ← 练习四造技能用
│   │        行业快讯_2026-09-22.md            ← 练习四的反面测试
│   └── 技能包/  finance-brief/ · skill-creator/
├── 技能库/                                ← 课后自己翻，不是今天要用的
│   ├── anthropics-financial-services/       ← 官方金融垂类，Apache-2.0
│   └── 岭南学院-sysu-awesome-cc/              ← 17 个技能加 2 个 agent
└── 指令卡.md

这一天的四个练习，用的是同一个技能

四个练习是一条线。前三个都在 finance-brief 这一个技能上做文章，第四个照着它的样子，从零造一个你自己的：

用 → 懂 → 改 → 造。前两个是学会使唤别人写的技能，后两个是自己动手写。练习一在下午前半段做，那时候还没拆解技能长什么样——先看见差别，再回头看它是怎么做到的。

练习一 · 同一句话，装技能前后各跑一遍

15 分钟 · 在 练习一二/ 启动

材料是真的：中芯国际（688981）2026 年半年度报告，上交所披露的原件 167 页，财报/中芯国际2026半年报_财报节选.md 是从里面挑出来的 13 页（主要财务指标加三张报表）。

① 先不装技能，只说一句

VS Code 打开 练习一二 文件夹，点插件图标启动，直接说：

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。帮我把 财报/中芯国际2026半年报_财报节选.md 里的主要指标整理成一张表，保存到当前文件夹，文件名 指标表.md。

它交出来之后，先别往下做，盯着这三件事看：

• 单位　它写的是「38,635,115」还是「386.35 亿元」？换算过程写了没有？
• 页码　每一格有没有写清这个数是从第几页来的？
• 产能利用率　这一项它填了吗——这份 13 页的节选里根本没有这个数

看完把刚存下的 指标表.md 改名成 指标表_装技能前.md。下一轮说的是同一句话，存出来的文件名也一样，不改名这一份就被盖掉了，两份并排看不成。

② 装上技能，说一模一样的话

把 技能包/finance-brief 整个文件夹拷进 .claude/skills/，退出重开，确认 /skills 里有 finance-brief，然后说和刚才一字不差的那句话：

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。帮我把 财报/中芯国际2026半年报_财报节选.md 里的主要指标整理成一张表，保存到当前文件夹，文件名 指标表.md。

• 界面上出现了调用 finance-brief 的那一行
• 十项都在，每项有本期和上年同期两个数
• 单位统一成亿元，备注里写了换算过程
• 每一格都写了来源页码
• 产能利用率那一行留空，备注写「材料中未提及」
• 文件夹里两份 md 都在：指标表_装技能前.md 和 指标表.md
• 两次的输出摆在一起，差别一眼能看出来

练习二 · 只改一句描述，看它还想不想得起来

15 分钟 · 仍在 练习一二/，还是刚才那个技能

上一个练习里它自己想起来用技能了。凭什么？凭 SKILL.md 开头那段 description。这一轮把那段改坏，看会怎样。

① 先备份，再改坏

先备份：在 VS Code 左侧文件树里，右键 .claude/skills/finance-brief/SKILL.md → 复制，再粘贴，得到一份 SKILL copy.md。这是待会儿改回去用的，别删。

然后打开 SKILL.md，把开头那三行里的 description: 整行换成下面这句，只改这一行，存盘：

description: 处理文档。

② 退出重开，说同一句话

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。帮我把 财报/中芯国际2026半年报_财报节选.md 里的主要指标整理成一张表，保存到当前文件夹，文件名 指标表.md。

大概率它不会调用技能了。接着追问一句：

你刚才用 finance-brief 这个技能了吗？如果没有，说说为什么没想到用它。

③ 点名，它就来了

用 finance-brief 这个技能，重做一遍刚才那件事。

这一次它应该照着十项、五条规矩来了。技能一直在那儿，只是它想不起来。

④ 改回去，再试一次

把 SKILL.md 删掉，把 SKILL copy.md 改名回 SKILL.md，退出重开，再说一次练习一那句话。它应该又自己想起来了。

• 描述改坏之后，不点名时它没有调用技能
• 追问时它能说出原因（描述太笼统，看不出这件活归它管）
• 点名之后它调用了，交出来的东西和练习一第二次一样
• 改回原描述、重开之后，不点名它又能自己想起来

练习三 · 用 skill-creator 给它加一个功能

20 分钟 · 在 练习三四/ 启动 · 改的还是下午那个技能

同一个 finance-brief，这一轮不再用它，而是改它。改的办法不是自己动手写，是让 skill-creator 帮你改。

① 装两个技能

技能包/ 里有两个：finance-brief（下午那个，这里放了一份独立的）和 skill-creator（官方的造技能工具）。两个文件夹都拷进 .claude/skills/，退出重开，/skills 里两个都要看得见。

② 说清楚要加什么

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。

用 skill-creator 帮我改进 .claude/skills/finance-brief 这个技能。

它现在做什么：从财报节选里提十项指标，单位换成亿元，每格标来源页码，材料里没有的留空，最后做三个比率的交叉核对。

我要加的功能：每一项除了本期和上年同期两个数，再加一列「同比」。
1. 金额类（营业收入、营业成本、净利润、归母净利润、研发费用、经营活动现金流净额）算百分比变化，保留一位小数，带正负号，例如 +19.4%。
2. 比率类（毛利率、净利率、加权平均净资产收益率、产能利用率）算百分点变化，例如「增加 1.3 个百分点」。金额类和比率类不能混着算。
3. 上年同期没有数的，同比那一格写「不可比」。

改完我期待看到三件事：
1. SKILL.md 里多了一节讲同比怎么算，金额类和比率类分开写清楚。
2. 「表格长这样」那一节的示例表多了「同比」这一列。
3. description 不用改，什么时候用它没有变。

动手之前，先把你打算怎么改说给我听，我确认了你再落盘。

它应该先给方案，等你说「可以」再改文件。它要是直接上手改，说明这一步没走到，回它一句「先说方案」。

③ 改完就验

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。帮我把 材料/中芯国际2026半年报_财报节选.md 里的主要指标整理成一张表，保存到当前文件夹，文件名 指标表.md。

• 它先给了改动方案，你确认之后才动文件
• SKILL.md 里多了讲同比算法的一节，金额类与比率类分开
• 重新跑出来的表多了「同比」这一列
• 营业收入那一行同比是 +19.4% 左右（386.35 对 323.48）
• 毛利率那一行写的是「增加 1.3 个百分点」这类说法，不是百分比
• 产能利用率那一行，本期上年都没有，同比写「不可比」

练习四 · 用 skill-creator 从零造一个

25 分钟 · 仍在 练习三四/ · 这一个技能是你自己的

前三轮都在摆弄别人写好的技能。这一轮从空白开始，材料就是今天这节课。材料/第2次课课堂速记.md 是一份现场流水记录，八千多字，口语、重复、没记全的地方都留着。你要做的技能，是把这种速记压成 200 字的要点。

① 让它先访谈你

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。

用 skill-creator 帮我从零做一个技能。

要做的活：把一次课的课堂速记压成要点总结，发给没能来上课的同事。
我现在怎么做：通读一遍，挑出有具体名词和数字的那几处，按课程环节分组，扔掉客套话和重复的部分。
交出来什么：正文 200 字以内；后面跟三条「该带回工位的事」；每条要点标明出自速记的哪一节。
最容易出错的地方：写成「深入浅出、收获满满」这种没有信息的空话；超了字数不肯删；
把课上提到的错误示范当成正确结论抄进去。

请先访谈我，把上面四件事问清楚、把我没说到的地方问出来，再起草 SKILL.md。

起草时按下午讲的六件事写：背景、任务、输入、约束、格式、自检。
description 一定要写清三件事：这个技能做什么、我会怎么开口（把我真会说的话写进去）、
什么时候不要用它——它只管课程和讲座这类材料，不是什么文档都拿来做纪要。
名字用 class-brief。

写完先把全文贴给我看，我确认了再落盘到 .claude/skills/class-brief/。

它应该先问你问题，不是直接开写。被问到的时候照实答，你自己单位怎么做就怎么说。200 字这条硬上限一定要让它写进 SKILL.md，这是整个技能最容易被它忽略的一条。

② 装上，测它来不来

退出重开，/skills 里应该有 class-brief。先不点名说一句你平时会说的话：

这是一次课堂练习，只使用当前文件夹里的材料，不要联网。帮我把 材料/第2次课课堂速记.md 整理一下，同事今天没来，我要发给他。

再试一句不该触发的。同一个文件夹里还有一份行业快讯，那不是课程资料：

帮我把 材料/行业快讯_2026-09-22.md 整理成一页纪要。

这一句是练习二的考点又回来了。两句话都在说整理成纪要，差别只在材料是什么。description 里要是只写了「整理纪要」，它两次都会来；写清了只管课程材料，它第二次才不会来。它要是来了，别急着改技能，先回去读一遍自己写的 description，多半问题就在那儿。

• 它先访谈了你，至少问出一两个你没主动说的点
• SKILL.md 里六件事齐全，description 写明了「做什么、我会怎么说、什么时候不用」
• 不点名说整理速记时，它调用了 class-brief
• 说整理行业快讯时，它没有调用
• 正文数一下字数，200 以内。超了的话它自己有没有删
• 要点里有具体的名词和数字，不是「介绍了技能的原理与应用」这种
• 每条都标了出自速记的哪一节
• 速记里写了有同学跑出一个 88% 的产能利用率，材料里根本没有这个数。要点里要是把 88% 当成中芯国际的真实产能利用率写了，就是抄错了——这正是练习一那一刀

课后选做 · 两个技能库，装完还要补什么

素材包解压后那个 技能库/ 文件夹里，装着两份 2026-09-23 的快照。anthropics/financial-services 是 Anthropic 官方的金融垂类仓库，Apache-2.0 许可，LICENSE 随包带着；按业务线分成金融分析、股票研究、投行、私募、基金行政、运营六块，下午课上拿来看描述怎么写的那个 comps-analysis 就在 vertical-plugins/financial-analysis/skills/ 底下。ai-lingnan/sysu-awesome-cc 是岭南学院师生一起维护的，李学恒老师发起，17 个技能加 2 个 agent；跟你们最相关的是 macro-data（查 GDP、CPI、PMI、社融、利率，接八个免费源）、academic-paper-search（找论文、下论文）、md-to-docx（Markdown 转 Word，带中文排版）。这个库的 README 写明 MIT，但仓库根目录还没放 LICENSE 文件——README 上写的和仓库里放的不一定是一回事，这正是背调四问里「源」那一问的真实例子。

拷进去只是第一步

不是每个技能拷进 .claude/skills/ 就能跑。两类要你自己动手：

• 要装外部工具的　mineru-document-extractor 要先 npm install -g mineru-open-api；macro-data 要建一个 Python 3.11 环境装五个包。技能文件只是说明书，工具不在里面
• 要配自己凭据的　调云端接口的技能得填 token 或 API key，一般写进环境变量，或按技能说明放进配置文件。别把 key 写进 SKILL.md 再传给别人

装之前先把那份 SKILL.md 通读一遍，看清楚它要你准备什么。这一条比背调四问还实用。

今天演示的 MinerU，要不要配 token

PDF 转 md 用的就是岭南库里那个 mineru-document-extractor。不配 token 也能用——flash-extract 免 token，20 页、10 MB 以内直接出 Markdown，今天演示那份 5 页 PDF 就在范围里。要跑更大的文件、出 docx 或者批量转，才需要 token。

想现场试配 token 的：作业平台 hw.lingnan.top/mf/ 第 2 次课的材料包里有一份 mineru-token.md，是张老师自己的 token，照里面三步配上就能用。课后会撤掉，你们自己去 mineru.net/apiManage/token 申请一个，免费额度够用。

课后 · 按日期排

下次课 9 月 30 日（周三）14:20，讲 MCP 与论文复现。作业提交都在作业平台 hw.lingnan.top/mf/。