练习二:一做一审,审一轮、改一轮
准备
材料包 02_一做一审/:
| 文件 | 内容 |
|---|---|
简报成品/综合简报.md |
一份已经写好的综合简报,待审 |
数据/ |
两份原始表,与练习一相同 |
检查清单.md |
审阅的五条标准 |
这份简报里有几处错。练习二看的是:一个只拿成品、原始数据和检查清单的审阅者,能不能把它们找出来;作者怎样按意见逐条改。
第 0 步:建项目,新开会话
做什么:把 02_一做一审 拷出来,改名 简报审阅,用 VS Code 打开,在终端里启动 claude(练习一的 Claude Code 先退出:两次 Ctrl + C)。信任文件夹的问法同练习一。
做对了会看到:欢迎框第三行的路径最后一段是 简报审阅,输入框是空的,没有练习一的对话。
第 1 步:自己读简报和检查清单
做什么:打开 简报成品/综合简报.md 和 检查清单.md 读一遍。你觉得哪里可疑,先记在自己心里,不告诉 Claude Code:审阅者要在不知道你看法的情况下独立查。
做对了会看到:简报四节:生产与景气、物价与货币、就业、综合观察。检查清单五条:数字对得上原表、期间与单位一致、没有编出来的指标、结论有依据、审阅只写意见。
第 2 步:派一个只读的审阅子代理
做什么:粘贴下面这段话,回车。
请派一个审阅子代理,只读审阅 简报成品/综合简报.md:
1. 只给它三样材料:简报成品/综合简报.md、数据/ 里的两份原始表、检查清单.md。不要把你对这份简报的看法告诉它。
2. 它按 检查清单.md 逐条查,把问题写进 协作记录/审阅意见.md,每条写位置、问题、依据、建议改法,全文不超过 600 字。
3. 它不改简报,只写意见文件;只审一轮。做完只回复文件路径和发现了几条问题。
你先不要改简报,等审阅意见写好后停下来,告诉我意见文件在哪、有几条。
做对了会看到
-
派出一个子代理,试跑时的屏幕:
⏺ Agent(审阅综合简报) ⎿ Backgrounded agent (↓ to manage · ctrl+o to expand) -
一分钟左右后
Agent "审阅综合简报" finished,主代理停下来,告诉你意见文件的路径和条数,并说明简报没有改动。试跑时是 6 条;每次跑出的条数可能不同。 -
打开
协作记录/审阅意见.md:每条有位置(引用简报原句)、问题、依据(原表哪一期、数值多少)、建议改法。试跑时的一条:1. 位置:“CPI 同比 2026 年 8 月为 0.5%”。问题:8 月值错,0.5 是 7 月值。 依据:物价表 CPI同比 08=0.8、07=0.5。建议:改 0.8%,补“比 7 月 0.5% 回升”。 -
简报成品/综合简报.md没有变(VS Code 里文件没有被改动的标记,内容和第 1 步看到的一样)。
第 3 步:作者逐条改
做什么:粘贴下面这段话,回车。
打开 协作记录/审阅意见.md,逐条处理:同意的就改 简报成品/综合简报.md,不同意的说明理由。改完在 审阅意见.md 末尾逐条写“已改”或“不改及理由”。只处理这一轮,不再派人审。最后告诉我改了哪几处。
做对了会看到:屏幕上出现 Update(简报成品/综合简报.md),红绿两色显示删掉和加上的行;审阅意见.md 末尾多了一节,逐条写“已改”或“不改”及理由;它最后列出改了哪几处。试跑时它对其中两条“同意问题、但改了建议的改法”,并写明了理由,这是允许的:作者要对每条意见表态,不是照抄建议。
第 4 步:人核一处
做什么:对照你第 1 步心里记的可疑处,看审阅意见找到了几处;再挑一处改动,回 数据/ 原表核对改后的数字。
做对了会看到:你怀疑的地方,审阅意见里都有,或者你能说出它为什么没提;改后的数字在原表里找得到对应行。审阅者有时会多提一两条措辞上的意见,作者可以改,也可以写明理由不改。
✅ 练习二自查
- 审阅是子代理做的(屏幕上有
Agent(…)),它拿到的是简报、两份原表和检查清单 审阅意见.md每条都有位置、问题、依据、建议- 审阅时简报没被改;改是作者(主代理)在第 3 步做的
审阅意见.md末尾逐条写了“已改”或“不改及理由”- 只审了一轮
- 你亲手核过一处改动
想一想:为什么让另一个子代理来审,而不是让写简报的那个代理“自己检查一遍”?如果要审第二轮,第二轮该查什么?
开始之前
在终端里用 Claude Code
和 W04 一样,本手册的操作都在终端里运行 claude:VS Code 菜单“终端 → 新建终端”,在下方终端里输入 claude 回车。VS Code 图形面板里显示的内容和本手册有些地方不一样,按终端写的为准。
什么是“派子代理”
你在对话里对 Claude Code 说“派两个子代理……”,它会把任务写成一段说明交给子代理。子代理在自己的上下文里读文件、写文件,做完只交回一句话;它读过的大段内容不回到你和主代理的这段对话里。主代理要用子代理的成果,就去打开子代理写出的文件。
提示词里直接写“子代理”就行,试跑时不用加英文也能派出来。派出去之后,屏幕上会出现这样几行:
⏺ 2 background agents launched (↓ to manage)
├ 写生产与景气交接文件
└ 写物价与货币交接文件
✻ Waiting for 2 background agents to finish
⏺ Agent "写生产与景气交接文件" finished · 10s
├、└ 后面是主代理给每个子代理起的名字,每次不一样。子代理在后台跑,主代理在等的时候可能先做点别的。行尾提示 ctrl+o to expand 的地方,按 Ctrl + O 可以展开看详细过程,再按一次收起。
💡 常识:权限模式与弹窗
屏幕最下面一行显示当前权限模式,试跑时是
⏵⏵ auto mode on:Claude Code 自己判断哪些操作风险低就直接做。你的电脑上可能是别的模式,它要写文件、运行命令时会弹出请你批准的选项,看清是在本项目文件夹里写文件,选Yes回车。按Shift + Tab可以切换模式。接国内模型时,启动或第一次派子代理时可能弹出一段英文说明(例如 auto mode 计费方式的通知、
isn't described by this version's model catalog的提示),不影响使用:前者按回车继续,后者是一行黄字,不用管。
省 token 的几个做法
多代理比一个代理费 token:每个子代理都要重新读一遍任务说明和材料,派得越多、审得越多轮,用得越多。下面几个做法可以少花:
- 子代理用便宜一档的模型。主代理要统筹,用好一点的模型;子代理做的是读表、写小结、照清单核对,便宜的模型一般够用。用 CC Switch 或
settings.json配 DeepSeek 的,CLAUDE_CODE_SUBAGENT_MODEL一项填 Flash 档(见下面的常识框),子代理就用这一档。 - 限定输出长度。给子代理写清“每份不超过 300 字”“做完只回复一句:文件路径和状态”。子代理交回的话越短,主代理的对话越干净,后面每一轮要带着走的内容也越少。
- 定好轮数上限。审阅写“只审一轮”或“最多两轮”。不写的话,它可能审了改、改了再审,一直转下去。
- 一个练习一个会话。做完一个练习,退出 Claude Code(两次
Ctrl + C)再在下一个项目文件夹里启动。上一个练习的对话不会被带进下一个练习,每轮请求要带的内容就少。 - 自己先看一眼材料。打开数据表、简报、单据扫一遍,比让它“先把所有文件读一遍讲给我听”省得多。
- 随时看用了多少。在 Claude Code 里输入
/cost回车,弹出的面板里Usage by model一行列出本次会话的输入(input)、输出(output)和缓存读取(cache read)token 数;按Esc关掉。接国内模型时,面板上的美元金额是按 Claude 的价格估的,不准,看 token 数,以模型平台控制台里的账单为准。
💡 常识:Claude Code 接国内模型
Claude Code 可以接 DeepSeek 等国内模型,按对方平台的价格计费。W01 的环境安装手册已经讲了用 CC Switch 接 DeepSeek 的做法(https://ai.lingnan.top/materials/2026-autumn/w01/installation),这里补两点:
- 主模型和子代理模型可以分开配。几个“模型”项(
ANTHROPIC_MODEL等)决定主代理用哪个模型;CLAUDE_CODE_SUBAGENT_MODEL决定子代理用哪个。DeepSeek 官方文档(2026-10-11 查)现在建议 Flash 档的模型名写deepseek-flash,旧名deepseek-v4-flash仍可用,按 Flash 价格计费。- 只想在一个终端窗口里临时换模型,可以不改配置文件,在启动
claude之前先运行几行环境变量(sk-你的密钥换成你自己的 API Key;关掉这个终端窗口就失效):Mac:
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN=sk-你的密钥 export ANTHROPIC_MODEL=deepseek-flash export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-flash export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash claudeWindows PowerShell:
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-你的密钥" $env:ANTHROPIC_MODEL="deepseek-flash" $env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-flash" $env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-flash" claude这样启动后,欢迎框第二行显示
deepseek-flash,上方会有一行黄字说这个模型名“isn't described by this version's model catalog”,并按 200k 上下文处理。本周三个练习用不到那么长的上下文,不影响;主模型名后面加[1m](如deepseek-flash[1m])可以用满 1M 上下文,写法同 W01 手册。注意:
~/.claude/settings.json的env里写了同名项的,以文件为准,临时变量不起作用(W01 手册有说明)。API Key 只放在自己电脑上,不发给别人,不写进任何文件和截图。