在线总手册下载材料包常见问题练习1练习2练习3

练习二:一做一审,审一轮、改一轮

准备

材料包 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. 它不改简报,只写意见文件;只审一轮。做完只回复文件路径和发现了几条问题。
你先不要改简报,等审阅意见写好后停下来,告诉我意见文件在哪、有几条。

做对了会看到

  1. 派出一个子代理,试跑时的屏幕:

    ⏺ Agent(审阅综合简报)
      ⎿  Backgrounded agent (↓ to manage · ctrl+o to expand)
    
  2. 一分钟左右后 Agent "审阅综合简报" finished,主代理停下来,告诉你意见文件的路径和条数,并说明简报没有改动。试跑时是 6 条;每次跑出的条数可能不同。

  3. 打开 协作记录/审阅意见.md:每条有位置(引用简报原句)、问题、依据(原表哪一期、数值多少)、建议改法。试跑时的一条:

    1. 位置:“CPI 同比 2026 年 8 月为 0.5%”。问题:8 月值错,0.5 是 7 月值。
       依据:物价表 CPI同比 08=0.8、07=0.5。建议:改 0.8%,补“比 7 月 0.5% 回升”。
    
  4. 简报成品/综合简报.md 没有变(VS Code 里文件没有被改动的标记,内容和第 1 步看到的一样)。

第 3 步:作者逐条改

做什么:粘贴下面这段话,回车。

打开 协作记录/审阅意见.md,逐条处理:同意的就改 简报成品/综合简报.md,不同意的说明理由。改完在 审阅意见.md 末尾逐条写“已改”或“不改及理由”。只处理这一轮,不再派人审。最后告诉我改了哪几处。

做对了会看到:屏幕上出现 Update(简报成品/综合简报.md),红绿两色显示删掉和加上的行;审阅意见.md 末尾多了一节,逐条写“已改”或“不改”及理由;它最后列出改了哪几处。试跑时它对其中两条“同意问题、但改了建议的改法”,并写明了理由,这是允许的:作者要对每条意见表态,不是照抄建议。

第 4 步:人核一处

做什么:对照你第 1 步心里记的可疑处,看审阅意见找到了几处;再挑一处改动,回 数据/ 原表核对改后的数字。

做对了会看到:你怀疑的地方,审阅意见里都有,或者你能说出它为什么没提;改后的数字在原表里找得到对应行。审阅者有时会多提一两条措辞上的意见,作者可以改,也可以写明理由不改。

✅ 练习二自查

想一想:为什么让另一个子代理来审,而不是让写简报的那个代理“自己检查一遍”?如果要审第二轮,第二轮该查什么?


开始之前

在终端里用 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:每个子代理都要重新读一遍任务说明和材料,派得越多、审得越多轮,用得越多。下面几个做法可以少花:

  1. 子代理用便宜一档的模型。主代理要统筹,用好一点的模型;子代理做的是读表、写小结、照清单核对,便宜的模型一般够用。用 CC Switch 或 settings.json 配 DeepSeek 的,CLAUDE_CODE_SUBAGENT_MODEL 一项填 Flash 档(见下面的常识框),子代理就用这一档。
  2. 限定输出长度。给子代理写清“每份不超过 300 字”“做完只回复一句:文件路径和状态”。子代理交回的话越短,主代理的对话越干净,后面每一轮要带着走的内容也越少。
  3. 定好轮数上限。审阅写“只审一轮”或“最多两轮”。不写的话,它可能审了改、改了再审,一直转下去。
  4. 一个练习一个会话。做完一个练习,退出 Claude Code(两次 Ctrl + C)再在下一个项目文件夹里启动。上一个练习的对话不会被带进下一个练习,每轮请求要带的内容就少。
  5. 自己先看一眼材料。打开数据表、简报、单据扫一遍,比让它“先把所有文件读一遍讲给我听”省得多。
  6. 随时看用了多少。在 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),这里补两点:

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
claude

Windows 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 只放在自己电脑上,不发给别人,不写进任何文件和截图。