上机材料：把一次对话变成可以继续的项目

在第一周建好的 agent-lab 里新建项目文件夹 w02/经费核对/。做完之后，这个项目里会有：一份项目规则 CLAUDE.md、一份任务说明、一张核对表的初版和修订版、一份检查记录和决策日志，以及用新对话处理第二批材料的结果。

案例：青禾经济学社的活动经费核对。 社团办完一场迎新沙龙，收到一批报销申请。你的任务是依据给定规则，把申请整理成一张逐项核对表，交给活动负责人检查。社团、人物、金额和规则都是虚构的教学模拟材料。本任务只做核对，不审批，也不支付。

开始之前

• 第一周的环境能用：在 agent-lab 里运行 claude 能对话。没跑通的同学，先用 材料包/01_经费核对/备用/ 里的教学示例练习核验（见第八步），环境修好后再实际运行。
• 下载材料包，解压到桌面或下载文件夹。不要解压到 agent-lab 里面，后面按步骤把需要的文件放进去。
• 材料包保留一份不动。万一项目里的文件被改坏，可以从这里重新复制。
• 每一步或每组步骤后面有“✅ 自查”，写做对了应该看到什么，不含核对结论的答案。

一个任务一个文件夹。 agent-lab 是放这门课各周项目的总文件夹，每周在里面建一个周文件夹（w02/、w03/……）。要多轮协作的任务，在周文件夹里单独建一个项目文件夹，它的材料、成果和规则都放在里面；主任务是 w02/经费核对/。一两条指令就能做完的短练习不用分区，把题目文件夹整个复制到 w02/短练习/ 下即可。

在哪个文件夹启动 claude，它就把哪个文件夹当作项目：启动时读那里的 CLAUDE.md，默认在那里找文件、写文件。所以做项目时在项目文件夹里启动，不在 agent-lab 根目录启动。

---

第一部分：先看清它在用什么权限、连着谁

第一步：用手动审批模式启动，再读一次 README

打开终端，进入第一周的工作文件夹，用手动审批模式启动：

cd agent-lab
claude --permission-mode manual

启动后检查三件事：

1. 权限模式。 确认界面显示 Manual／手动审批（部分版本显示 manual mode on）。终端可用 Shift+Tab 切换常见模式；VS Code 可从模式菜单选择 Manual。看清实际标签，不以“其他提示消失”代替确认。出现 bypass permissions，见《常见问题》第 2 条。
2. 数据发给谁。 输入 /status，看当前的模型和接口地址。接口地址看不到的，打开 CC Switch，看当前启用的是哪家供应商。选入模型请求的材料会发往实际接入的模型服务；经过中转时也要考虑中转方。可先问“愿意把这些内容交给对应网页版吗”，再分别确认网页与 API 条款，决定使用、脱敏或更换方式。
3. 用的是教学副本。 只处理材料包里的模拟材料，不放任何个人资料。

然后让它读第一周的文件：

读取 README.md，用一句话告诉我里面写了什么。只读，不要修改。

对照你自己打开的 README.md，看它说得对不对。在工作文件夹里读文件，通常不会弹出批准，这是正常的；写文件、运行命令时它才会问你。

启动时如果报错说不认识 manual，见《常见问题》第 1 条。

---

第二部分：准备任务与项目

第二步：建项目文件夹和四个分区，把材料放进去

让 Claude Code 创建文件夹。它会请你批准，看清路径再选允许：

在当前文件夹里创建 w02/经费核对/，再在经费核对里面创建这些空文件夹：inputs/A批、references、outputs、notes。
只创建文件夹，不要创建或修改其他文件。

然后自己用访达（Mac）或文件资源管理器（Windows）复制文件：

四个位置各管什么：

• inputs/：原始材料，放进来之后不再改动
• references/：规则、样例和背景资料
• outputs/：成果
• notes/：任务说明、检查记录、决策日志

放好后，输入 /exit 退出，进入项目文件夹重新启动：

cd w02/经费核对
pwd
claude --permission-mode manual

中文文件夹名不好输入的，敲到 cd w02/ 后按 Tab 键补全。pwd 显示的路径应以 w02/经费核对 结尾（Windows 显示为 w02\经费核对）。用 VS Code 的，也可以“文件 → 打开文件夹”选中 经费核对，在新窗口的终端里启动。以后做这个项目，都在 经费核对 里启动。

让它核对一遍：

列出当前文件夹下所有文件夹和文件，按文件夹分组。只读，不要改动任何文件。

对照上表，看文件数和位置是否一致。

提醒： 工作目录是它开始工作的地方，不会自动限制它能碰到哪些文件。能碰到哪些，要看权限和系统设置。

短练习 1： 打开 03_短练习/01_文件归位/题目.md，给一个混乱的统计学小组文件夹填“原位置 → 建议位置 → 待确认问题”映射表。不运行代码，不移动文件。

✅ 自查：第一、二步

• 界面显示 Manual／手动审批（部分版本显示 manual mode on），没有 accept edits、plan mode、auto mode、bypass permissions 之类的提示。
• 你能说出这批材料会发给哪家模型服务。
• 在 w02/经费核对 里启动；inputs/A批/ 里有 7 个文件，对应 6 份申请；references/ 里有 2 个文件；notes/ 里有 3 个模板。
• 它列出的目录和你亲眼看到的一致。

第三步：把“帮我看看”写成任务说明

打开 notes/任务说明_A批.md。它按课件第五部分的六要素写成，从上往下交代六件事：

缺哪条要素，结果就可能在哪里跑偏；返工时也先查缺了哪条。

在文件里圈出（加粗或写批注）四处：输入路径、输出路径、缺失信息的处理方式、检查条件。然后对照 references/核对表样例.md 看：“依据”一列要写到什么程度？样例里的数字能不能抄进本次结果？

把你觉得不清楚的地方改掉，保存。

再练一句：把“帮我看看，专业一点”改写成一条能检查的要求，例如“每条结论写出规则条款号和原文位置”。

第四步：哪些写进任务，哪些写进项目

下面几条信息分别放在哪里？在 README.md、CLAUDE.md、任务说明、决策日志中选一个，并说出理由。

判断标准：长期适用的约定写进 CLAUDE.md；只管这一次的写进任务说明；介绍项目、告诉别人从哪里打开的写进 README.md；进度和你作的判断记进决策日志。

短练习： 某毕业论文项目有五项要求，分别放在项目规则还是本轮任务？

1. 原始数据不得修改
2. 所有回归表保留三位小数
3. 今天只修改文献综述
4. 本轮先不要运行代码
5. 表格统一写入 outputs/tables/

第五步：写一份短的 CLAUDE.md

把 01_经费核对/模板/CLAUDE_模板.md 复制到项目文件夹 w02/经费核对/（和 inputs、notes 等文件夹放在一起），改名为 CLAUDE.md。不要放在 agent-lab 根目录：在子文件夹里启动时，上级文件夹的 CLAUDE.md 也会被读取，放在根目录就会作用到每一周的项目。

逐条读一遍：每一条你都能解释为什么要写吗？不需要的删掉，缺的补上。先写最少的几条，不追求一次写全。最后一节“从检查中积累的要求”先空着，第十步再填。

保存后输入 /exit 退出，再重新启动：

claude --permission-mode manual

Claude Code 在启动时读取项目根目录的 CLAUDE.md。问它一句：

你读到了哪些项目约定？用三行告诉我。

规则和权限是两回事。 CLAUDE.md 写的是你希望它怎样工作，它通常会遵守，但这不是强制限制。“原件不改”能不能做到，还要看你在它请求修改时点不点“拒绝”。

✅ 自查：第三至五步

• 任务说明六要素齐全（角色、背景、任务、约束、格式、自检），输入、输出路径与你的文件夹一致。
• CLAUDE.md 在 w02/经费核对/ 里，文件名大小写正确，不是 CLAUDE.md.txt。
• 重新启动后问它“读到了哪些项目约定”，它的回答能和你写的内容对上。

第六步：发任务，先看计划再放行

打开 notes/任务说明_A批.md，复制代码块里的全部文字，粘贴给 Claude Code。

任务说明最后一句要求它先交计划，这是心法 3“复杂任务先出计划”。想更稳一些，可以在任务说明前面加一句（心法 2）：

动手之前，请用 5 句话复述我的需求，并列出你的 3 条核心假设。我确认后你再做。

它应该先回复一份计划，而不是直接生成结果。逐条检查：

• 它说找到的文件数，和你放进 inputs/A批/ 的一样吗？
• 规则和样例的路径对吗？
• 结果打算写到 outputs/核对表_v1.md 吗？
• 它有没有打算修改 inputs/、删除或合并哪条记录？
• 它发现的缺口写出来了吗？
• 它在计划里问了问题吗？问了就先逐条回答，这些回答也是你的判断，记进决策日志。

有问题就直接指出，让它改计划。计划没问题、问题也答完了，再回复：

计划可以，开始执行。

✅ 自查：第六步

一份合格的计划应当：

• 列出找到的全部文件，并说明 7 个文件怎样对应 6 份申请
• 写明依据的规则文件和输出位置
• 写出初步看到的缺口或疑点
• 没有打算修改 inputs/，也没有打算删除或合并任何记录
• 停下来等你确认

它跳过计划直接开始写文件，你在批准界面仍可以拒绝，让它先交计划。

---

第三部分：完成一轮协作

第七步：跑出初版

可以先让它只处理 A01 一份，看它读了哪些文件、写到哪里、怎样回查来源，再跑整批。

执行过程中它会请求批准：

• 写文件：看清路径是 outputs/核对表_v1.md 再允许。路径在 inputs/ 里的，一律拒绝。
• 运行命令：它可能想运行一段 Python 脚本来复算金额。看不懂这条命令做什么，就选拒绝，让它先解释；拒绝后它会改为逐条手工计算，你照样按第八步检查。
• 只选第一个 Yes（只允许这一次）或 No。带 don't ask again、auto mode、allow all 字样的选项都不要选，一次一批。

完成后，自己打开 outputs/核对表_v1.md。在 VS Code 里按 Cmd+Shift+V（Mac）或 Ctrl+Shift+V（Windows）可以看渲染后的表格。

第八步：拿原始材料检查结果

打开 notes/检查记录.md，按第一节的六项逐项检查，把结果填进去：

1. 条目齐全：数一数 A 批有几份申请，表格有几行。注意有的申请由两个文件组成。
2. 依据可查：至少抽 2 条，打开原始文件和规则条款，看结论对不对得上。
3. 金额复算：用计算器自己算每份申请的明细合计，与申报总额比较。
4. 重复与缺口：票据编号有没有相同的？缺什么信息写清楚了吗？
5. 来源位置：按表中写的位置，能不能找到原文？
6. 文件位置：结果在 outputs/，你没有批准过改动 inputs/ 的操作。

AI 的自查可以帮你找线索，但验收要回到原始材料。它说“已核对无误”，不能代替你亲自看。

环境没跑通的同学： 把 01_经费核对/备用/教学示例_初版核对表.md 当作 AI 交来的初版，照上面六项检查它，写出检查记录和修改意见。它是老师编写的示例，不是模型的实际输出。

✅ 自查：第七、八步

一张合格的核对表应当：

• 6 份申请各占一行，没有漏，也没有把一份申请拆成两行
• 每行的结论属于三类之一：符合给定规则、需补充材料、存在差异
• “依据”列写出规则条款；涉及金额的，写出计算过程
• “来源位置”能让你找回原文
• 表后说明三类结论各有几份，以及需要负责人处理的事项
• 规则没说到的情形，标成待确认，而不是替它补上一个判断
• 表后有它按“自检”要求写的自查结果；自查说“无误”，不等于你的检查已经通过

初版有错很正常，找出来、改掉，就是这一轮练习的目的。

第九步：写能执行的修改意见，生成修订版

“再仔细一点”没法执行。每条意见写清五件事：位置 → 问题 → 原始依据 → 修改要求 → 复查方式。先写进检查记录第二节，再发给它：

请修改核对表，另存为 outputs/核对表_v2.md，不要覆盖 v1：
1. 位置：____ 行的“____”列。问题：____。原始依据：____（文件与位置）。
   修改要求：____。复查方式：____。
改完告诉我改了哪些行。

初版如果没发现错误，不要编一个错误。提一项明确的新要求，同样走一轮修订，例如“在‘核对结论’后单列一列‘规则条款’，只写条款号”“表后单列一节，写已检查、未发现问题的项目”。

拿到 v2 后，按检查记录第三节逐条确认是否改到。

可选：先让它自己挑毛病（心法 6）。 写修改意见之前，可以先问它：

这张核对表有什么不足？请挑出 3 个最严重的问题：逻辑漏洞、依据不足、格式缺陷。先不要改文件。

它挑出的问题只是线索，每一条都要按第八步回到原始材料确认，确认后再写进修改意见。

第十步：把经验写回规则，记下你的判断

哪条经验放哪里：

从你刚写的修改意见里挑一条下次还会用到的，写进 CLAUDE.md 最后一节，注明来源（如“来自 W02 A 批检查”）。

然后打开 notes/决策日志.md，至少写两条：你接受、修改或拒绝了 AI 的什么建议，依据是什么。核验后决定接受，也算一条判断。

进阶练习： 03_短练习/03_规则诊断/，诊断一份堆积了 260 行、已经失效的项目规则。

✅ 自查：第九、十步

• 核对表_v1.md 仍在，核对表_v2.md 是另存的新文件。
• 每条修改意见都能在 v2 里找到对应的改动。
• CLAUDE.md 最后一节多了一条要求，写了来自哪次检查。
• 决策日志至少两条，每条都有“依据”。

第十一步：开一轮新对话，看它能不能接上

输入 /exit 退出，在 经费核对 里重新启动 claude --permission-mode manual。本次新建对话没有主动带入刚才的聊天记录，需要重新读取项目入口、规则和进度；恢复旧会话、自动记忆或压缩的行为取决于应用。

打开 01_经费核对/模板/任务说明_B批.md，先发“第一句”，让它说出从 CLAUDE.md 读到的约定，以及 A 批的结果和日志在哪里。对照你的文件检查它的回答。

第十二步：换一批材料，再检查一次

1. 在项目里新建 inputs/B批/ 文件夹，把 材料包/01_经费核对/B批/ 的 2 个文件复制进去。
2. 把 任务说明_B批.md 复制到 notes/，发出“第二句”。看计划、放行、打开结果 outputs/核对表_B批.md。
3. 按检查记录第四节检查：金额和标准自己算一遍；你在第十步写回的要求，这次有没有被用上？

B 批一次通过，说明这一次表现不错，不代表以后可以不检查。

✅ 自查：第十一、十二步

• 新对话里，它能说出 CLAUDE.md 中的约定，并通过查看目录找到 A 批的结果和日志。第十三步在 README 写项目入口，就是为了下次不用再靠它搜。
• 核对表_B批.md 的格式与 v2 一致，2 份申请都有结论和计算过程。
• 你在第十步写回的要求，在 B 批结果里能看到被用上了。

第十三步：把项目交给下次的自己

在项目里新建 README.md，写上项目入口（可以让它创建，你来批准）：

# 经费核对：项目入口

- 项目规则：CLAUDE.md
- 任务说明：notes/任务说明_A批.md、notes/任务说明_B批.md
- 成果：outputs/核对表_v1.md（初版）、核对表_v2.md（修订版）、核对表_B批.md
- 检查与判断：notes/检查记录.md、notes/决策日志.md
- 备份：____（写你的备份方式和恢复入口；还没有就写“暂无”）
- 下一步：____

再自己在 agent-lab/README.md 末尾加一行 W02 经费核对：w02/经费核对/。每个项目都在这里登记一行，总文件夹就有了目录。

同伴互查： 请旁边的同学只看你项目里的 README.md，找到 B02 的核对结论和它的来源位置。一分钟内找到，说明交接写清楚了。

没跑完的同学，在“下一步”里写明卡在哪一步。

✅ 自查：第十三步

• 同学只看你的 README.md，一分钟内能找到 B02 的结论和来源。

迁移：换个任务，需要准备哪些东西

从下面选一个，用六要素写一份任务说明。换到新任务时新开一轮会话（心法 4），不要接着 A／B 批的对话写。要跑完整流程的，在 w02/ 下另建一个项目文件夹，例如 w02/社团纪要/，照第二步分好 inputs、outputs、notes，在里面启动。

---

做完后检查：项目里应有的文件

做完后，你的 agent-lab 里应该有：

agent-lab/
├── README.md                  第一周建的；登记各项目的位置
└── w02/
    └── 经费核对/              项目文件夹，在这里启动 claude
        ├── README.md          项目入口
        ├── CLAUDE.md          项目规则，含一条从检查中积累的要求
        ├── inputs/A批/        7 个文件，未改动
        ├── inputs/B批/        2 个文件，未改动
        ├── references/        经费规则、核对表样例
        ├── outputs/           核对表_v1.md、核对表_v2.md、核对表_B批.md
        └── notes/             任务说明_A批.md、任务说明_B批.md、检查记录.md、决策日志.md

这些文件保留，不要删。

要记住的四件事

1. 先看清权限和数据去向，再让它动手。 初学阶段用手动审批；材料会发给你配置的模型服务。
2. 任务说明按六要素写：角色、背景、任务、约束、格式、自检；复杂任务先让它交计划，确认后再执行。
3. 长期约定写进 CLAUDE.md，本次要求写进任务说明，你的判断记进决策日志。
4. 验收回到原始材料。 能执行的修改意见要写清位置、问题、依据、要求和复查方式。