开工前 · 先摆目录,再启动
新建一个空文件夹当今天的项目,照下面摆好。摆完再在这个文件夹里启动 Claude Code。终端里先 cd 进去再输 claude;VS Code 插件用文件 → 打开文件夹,选的就是这一层。启动后先跟它说一句话,它能回你,再往下走。
今天的项目/
├── .claude/
│ └── agents/
│ └── 审阅员.md ← 02_写好的子代理 里那份,原样拷进来
├── data/ ← 01_三家银行年报节选 整个拷进来,改名叫 data
├── output/ ← 空文件夹,结果都写在这里
└── 参考/
└── comparator.md ← 03_skill-creator的盲评员 里那份,原样拷进来
参考/ 是普通文件夹,资源管理器里直接建,把材料包 03_skill-creator的盲评员 里的 comparator.md 拷进去,LICENSE.txt 不用拷。练习二第二段的盲评员照它干活。
Claude Code 只盯着启动时已经存在的 .claude/agents/ 目录。目录在,往里加文件、改文件,几秒就认。会话开着的时候才新建这个目录,要退出重开才认,不然主会话派不到审阅员,会自己闷头核。
以点开头的文件夹在 Windows 资源管理器里不好建。VS Code 里先文件 → 打开文件夹选中项目,暂时别点 Claude 图标,在左侧资源管理器里新建文件夹,名字输入 .claude/agents,一次建两层,再把 审阅员.md 拖进去。也可以在 PowerShell 里进到项目文件夹,敲 mkdir .claude\agents。Mac 上敲 mkdir -p .claude/agents。
已经开着会话才建的终端里输入 /exit,再输入 claude;VS Code 插件点新会话。
材料说明 · 这一节要看仔细
每家给了一份 PDF 和一份同名 Markdown,用处不同。
| 文件 | 给谁看 | 用来做什么 |
|---|---|---|
…节选.pdf | 你自己 | 翻页码、核数字。验收时拿它对照 |
…节选.md | AI | 它实际读的是这一份。每个小节标题写着节选第 K 页,页码照它标 |
.md,别让它读 PDF 这套配置下的 Claude Code 读不了 PDF,会报一句 PDF is password-protected。这句话是误报,跟文件有没有加密无关,换一份 PDF 也一样。任务说明 · 组长要一页三家对比
你在一家券商的银行业研究组实习。组长下周一开会,要一页招商、兴业、中信三家 2025 年的经营对比,材料只用 data/ 里的三份年报节选。他要回答四个问题,合起来八项指标。
| 组长的问题 | 要哪几项 |
|---|---|
| 1 · 谁的盘子大 | 营业收入、归属于股东的净利润 |
| 2 · 谁赚钱效率高 | 净息差、加权平均净资产收益率 |
| 3 · 谁的底子稳 | 不良贷款率、拨备覆盖率、核心一级资本充足率 |
| 4 · 谁最靠利息吃饭 | 利息净收入占营业收入的比重,自己算,写出算式 |
每个数标节选页码和原文单位。原文叫法不同的,写出原文用词。材料里没有的写未披露,不拿相近的项目顶。表后写四句结论,一问一句。
同一个任务做三遍
三遍做的是同一件活,只换干法。每遍的结果写在 output/ 下不同的位置,互不覆盖,做完可以摆在一起比。
| 哪一遍 | 怎么干 | 写进哪里 | 回头看什么 |
|---|---|---|---|
| 一个人干 练习一第一段 | 明说不用子代理,主会话在一个会话里一家一家读 | output/一个人干/ | 用了多久,主会话占了多少上下文,哪几格可疑 |
| 分头干 练习一第二段 | 同样的活拆成三份,三个子代理同时读,主会话只汇总 | output/分头干/ | 跟第一遍比用时、上下文、结果 |
| 请审阅员 练习二第一段 | 材料包里写好的审阅员核分头干那张汇总表 | output/审阅意见.md | 它挑出什么,哪几条是便条没写清 |
三遍做完,练习二第二段再派一个盲评员,比一个人干和分头干两张汇总表,结果写进 output/盲评/。
成品长什么样
都做完,项目文件夹是这样。我的判断.md 是你自己写的,每段做完都往里记。
今天的项目/
├── .claude/
│ └── agents/
│ └── 审阅员.md ← 开工前放好,再启动 Claude Code
├── data/ ← 三份年报节选,PDF 加 .md
├── output/
│ ├── 一个人干/
│ │ └── 汇总表.md ← 练习一第一段,主会话自己读、自己写
│ ├── 分头干/
│ │ ├── 招商银行_提取.md ← 练习一第二段,一家一个子代理写
│ │ ├── 兴业银行_提取.md
│ │ ├── 中信银行_提取.md
│ │ └── 汇总表.md ← 主会话只读三份提取表,汇成这一份
│ ├── 审阅意见.md ← 练习二第一段,审阅员核 分头干/汇总表.md
│ ├── 盲评/
│ │ ├── A.md ← 练习二第二段,两张汇总表拷过来改名
│ │ ├── B.md
│ │ └── 结果.md ← 盲评员写
│ └── 我的判断.md ← 你自己写,每段做完往里记
└── 参考/
└── comparator.md ← 开工前从材料包拷进来,盲评员照它干活
汇总表长这样
下面用总资产一行示范格式。总资产不在八项里,只看格式。每格写数、原文单位、节选页码。
| 指标 | 招商银行 | 兴业银行 | 中信银行 |
|---|---|---|---|
| 总资产(示范) | 13,070,523 人民币百万元,节选第 2 页 | 11,094,256 人民币百万元,节选第 2 页 | 10,131,028 百万元人民币,节选第 2 页 |
| 营业收入 | … | … | … |
| 其余七项各一行 | … | … | … |
表下面写利息净收入占比的算式,三家各一行;再写四句结论,一问一句。提取表一家一份,八项各一行,每个数同样标单位和页码。
练习一 · 第一段 · 一个人干
这一步要做成什么
主会话不派子代理,在一个会话里把三份节选一份一份读完,抽八项,写成 output/一个人干/汇总表.md。里面有一张对比表、利息净收入占比的算式和四句结论。这一次不给提示词,把下表几样写成你自己的一段话。
提示词要说清什么
| 说清 | 怎么说 |
|---|---|
| 不用子代理 | 明说你自己在这个会话里一家一家读,不派子代理。只是不提的话,它会自己决定派不派,派了对照就做不成 |
| 读什么 | 只读 data/ 下三份 .md,不读 PDF |
| 抽什么 | 任务说明里那八项。每个数标节选页码和原文单位,叫法不同的写出原文用词,没有的写未披露 |
| 交什么 | 写到 output/一个人干/汇总表.md,一张对比表、利息净收入占比的算式、四句结论 |
| 边界 | 只读写文件,不跑命令 |
怎么发
- 先把权限模式切到自动接受编辑。终端里按 Shift+Tab 切到 accept edits;VS Code 插件点输入框下方的模式标签,选 Edit automatically。不切的话,它每写一个文件都停下来等你点允许。跑命令照样会停下来问,所以那段话里要说清不跑命令。
- 记下发出去的时间,再发出去。
- 做完看汇总表文件的修改时间,算出它用了多久。再在输入框里输入
/context,看主会话占了多少上下文。
合格标准
- 会话里没有派子代理,三份节选是主会话自己读的
output/一个人干/汇总表.md在,八项三家都有数,或者写了未披露- 挑两个数,翻到它标的那一页,对得上
- 用时和
/context显示的上下文占用,记进output/我的判断.md,第二段对照要用 - 你觉得可疑的格子,也记进
我的判断.md
练习一 · 第二段 · 分头干
第一段做完,先对着它的合格标准自查一遍,课上会请几位同学报用时和上下文占用。然后同样的活再做一遍,这次分头干。
这一步要做成什么
三家拆开,一家一个子代理,同时派出去。每个子代理只读自己那家,提取表写进 output/分头干/。主会话不读年报,只读三份提取表,汇成 output/分头干/汇总表.md。做完跟第一段比。
提示词要说清什么
| 说清 | 怎么说 |
|---|---|
| 怎么拆 | 拆成三份,一家一个子代理。三份互不依赖,同一轮里同时派出去 |
| 子代理读什么 | 只读自己那家的 .md,不读 PDF |
| 子代理抽什么 | 八项,规矩同第一段,标页码和原文单位,写出原文用词,没有的写未披露 |
| 子代理交什么 | 提取表写到 output/分头干/<银行名>_提取.md,比如 招商银行_提取.md。每个只回一句 |
| 主会话做什么 | 三份都回来后,汇成 output/分头干/汇总表.md,格式同第一段。主会话自己不读年报 |
| 边界 | 只读写文件,不跑命令 |
怎么发
- 开一个新会话。这样
/context看到的只是这一遍的占用。开法见右下角的退出重开。看一眼权限模式还是不是自动接受编辑。 - 记下发出去的时间,再发出去。
- 做完记下时间,输入
/context看上下文占用。
怎么拿到那张便条
直接问主会话,派给招行那个子代理的说明原文是什么,要它原样贴出,不要转述。那段话是它自己写的,它看得到。VS Code 插件里,子代理跑起来后输入框附近会出现子代理的计数,点开再点招行那个,也能看到它收到的说明。
合格标准
- 会话里看得到派了三个子代理,一家一个,最好在同一轮里同时发出去
output/分头干/下三份提取表和汇总表.md都在- 主会话自己没读过 data/ 下的年报,它读的只是三份提取表
- 拿到派给招行那个子代理的原话,对着要它做什么、它需要知道什么、结果长什么样、边界在哪判一遍,缺了哪样写进
output/我的判断.md - 跟第一段比用时和上下文占用,记进
我的判断.md - 两版汇总表不一样的格子,回原文判谁对,写进
我的判断.md
练习二 · 第一段 · 请审阅员
这一步要做成什么
请材料包里写好的审阅员核 output/分头干/汇总表.md。它逐个数字回原文找出处,意见写进 output/审阅意见.md,表一个字不改。意见回来,采纳哪条由你判断。
提示词要说清什么
| 说清 | 怎么说 |
|---|---|
| 找谁 | 让审阅员来核。它的名字是 reviewer。说一句请审阅员来核,主会话多半会派它。没派就点名 reviewer,终端里也可以输入 @ 从列表里选它 |
| 核什么 | output/分头干/汇总表.md,原文在 data/ |
| 意见写哪 | output/审阅意见.md |
| 意见回来之后 | 先给你看,别改表 |
| 别说什么 | 别带你自己的结论 |
合格标准
output/审阅意见.md在,每条都带节选页码;汇总表没被改过- 在
我的判断.md里至少判一条,采纳还是不采纳、为什么。对不上又说不清的,你自己在汇总表里标出来留着,不拉平 - 记下哪几条是那张便条没写清造成的
- 审阅员说一致的,挑一两条自己回原文核
练习二 · 第二段 · 盲评
盲评员是什么
参考/comparator.md 是 skill-creator 自带的一份角色说明,第 2 次课发的 skill-creator 里就有,在它的 agents/ 下。skill-creator 比一个技能的新旧两版时,把两版跑出的结果交给它。它看两份结果,不知道哪份是哪份,先按任务定一张评分表,给两份各打分,再判谁赢、写理由。说明是英文,它写的结果多半也是英文,格式照说明里那段 JSON。英文没关系,可以让主会话翻成中文给你看。
这一步要做成什么
主会话把 output/一个人干/汇总表.md 和 output/分头干/汇总表.md 拷成 output/盲评/A.md 和 B.md,谁当 A 随意。再派一个子代理照 参考/comparator.md 比这两份,不告诉它哪份是怎么来的,任务说明就用组长的四个问题。它判谁赢、写理由,结果写到 output/盲评/结果.md。这一次也不给提示词,下表几样写成一句话就能发。
提示词要说清什么
| 说清 | 怎么说 |
|---|---|
| 先拷 | 两张汇总表拷成 output/盲评/A.md、B.md,顺序随意。拷之前看一眼两张表里有没有写来历,比如注明取自提取表,有就在 A、B 里删掉。哪份是 A,主会话在对话里告诉你,别写进 output/盲评/ |
| 派谁 | 派一个新的子代理,先读 参考/comparator.md,照里面的步骤比。别派审阅员 |
| 给它什么 | A、B 两个文件的路径,加上组长的四个问题当任务说明,别的文件不提。comparator.md 里管任务说明叫 eval_prompt |
| 别说什么 | 不说哪份是一个人干的、哪份是分头干的,也不说你觉得哪份好 |
| 结果写哪 | output/盲评/结果.md |
合格标准
output/盲评/下A.md、B.md、结果.md都在- 问主会话要派给盲评员的原话,里面没说哪份是怎么来的
- 结果里判了谁赢,理由落到具体格子,比如哪家的哪一项
- 问清 A 是哪份,把它的判断跟你在
我的判断.md里写的对一下。判得不一样的格子,回原文看谁对,写进我的判断.md
排错
| 现象 | 多半是 | 怎么办 |
|---|---|---|
| 第一段它还是派了子代理 | 你没明说不用子代理,它自己决定派了 | 开新会话,明说不用子代理,你自己在这个会话里一家一家读,再发一次。来不及重跑,就在 我的判断.md 里注明这一遍派了子代理,对照时心里有数 |
| 它停在那里问你要不要允许 | 权限模式没切到自动接受编辑,或者它要跑命令 | 点允许让它继续;下一次发之前先切模式,并在那段话里说只读写文件、不跑命令 |
| 分头干时它没派子代理,自己读了 | 你那段话没说要拆、要同时派 | 明说拆成三份、一家一个子代理、同时派出去 |
| 三个子代理一个跑完才开下一个 | 没说三份彼此独立 | 点明三份互不依赖,在同一轮里同时发出去 |
| 分头干没比一个人干快 | 材料只有二十五页,派子代理本身有开销 | 正常。对照时看 /context 的上下文占用和两版结果对不对,用时只是其中一项 |
| 分头干时主会话窗口一下就被撑满 | 子代理把整篇提取倒回来了 | 在你那段话里写明结果写进文件、每个只回一句 |
| 主会话没派审阅员,自己核了 | .claude/agents/ 是会话开着才建的 | 退出重开。重开还不来,就点名 reviewer |
主会话说审阅意见存好了,output/ 里却没有 | 它没派审阅员,自己核了,还说存了 | 点名 reviewer 再派一次,做完去 output/ 看文件在不在 |
| 审阅完汇总表被改了 | 多半是主会话拿到意见顺手改的;也可能审阅员文件被改过 | 派审阅员时说清意见先给你看、别改表;审阅员换回材料包原样那份 |
| 派给盲评员的原话或它的结果里,出现了一个人干、分头干 | 主会话派活时说了来历,或者把哪份是一个人干的说漏了 | 盲评就不盲了,重新派一次。派活时只给 A、B 两个文件和组长的四个问题 |
报 PDF is password-protected | 这套配置下的 Claude Code 读不了 PDF,与加密无关 | 让它读同名 .md,页码照样在 |
| 子代理写了未披露,你觉得应该有 | 先别改它的说法 | 回原文那一页看表里到底有哪些行,再决定是真没有,还是换了一个名字 |
| 它一直找某个数,反复搜 | 材料里可能真的没有 | 提前说好,连续三次找不到就停下来报告没找到 |
课后 · 按日期排
| 时点 | 做什么 |
|---|---|
| 今天 18:00 前 | 个人作业一在平台提交,报告 PDF、展示页 zip、会话记录 zip |
| 10 月 13 日 23:59 前 | 小组进度汇报材料交平台,限 3 页,写当前进展、遇到的问题、后续计划 |
| 下一次课前 | 小组的网页要在本机能打开。装好 Playwright MCP,下次课要用它取公告。命令在下次课的实操页,注册时带 -s user |
agents/ 下除了今天用的盲评员,还有评分员、分析员的说明;本院 sysu-awesome-cc 的 agents/paper-reviewer.md 是一个审经济学论文的审稿角色,技能库里没留的到 github.com/ai-lingnan/sysu-awesome-cc 看。对照着看它们怎么写边界。