---
title: "第 2 周上机手册：把一次对话变成可以继续的项目"
---

# 🧭 第 2 周上机手册：把一次对话变成可以继续的项目

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

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

## 开始之前

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

| 材料包目录 | 用途 | 用在哪一步 |
| --- | --- | --- |
| `01_经费核对/A批/` | 6 份申请（7 个文件） | 第二步 |
| `01_经费核对/规则与样例/` | 经费规则、核对表样例 | 第二步 |
| `01_经费核对/模板/` | 任务说明、项目规则、检查记录、决策日志 | 第二步起 |
| `01_经费核对/B批/` | 第二批 2 份申请 | 第十二步，**之前不要放进项目** |
| `01_经费核对/备用/` | 环境没跑通时用的教学示例 | 第八步 |
| `02_社团纪要/` | 迁移练习：筹备会记录 → 纪要与待办 | 迁移（第十三步之后） |
| `03_短练习/` | 文件归位、课程汇报任务、规则诊断 | 独立练习 |

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

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

---

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

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

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

```bash
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. **用的是教学副本。** 只处理材料包里的模拟材料，不放任何个人资料。

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

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

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

> 启动时如果报错说不认识 `manual`，见[《常见问题》](/materials/2026-autumn/w02/faq)第 1 条。

---

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

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

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

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

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

| 放到 `w02/经费核对/` 下的 | 放什么 |
| --- | --- |
| `inputs/A批/` | `01_经费核对/A批/` 里的 7 个文件 |
| `references/` | `01_经费核对/规则与样例/` 里的 `活动经费规则_教学模拟.md`、`核对表样例.md` |
| `notes/` | `01_经费核对/模板/` 里的 `任务说明_A批.md`、`检查记录.md`、`决策日志.md` |

四个位置各管什么：

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

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

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

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

让它核对一遍：

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

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

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

**短练习 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`。它按课件第五部分的六要素写成，从上往下交代六件事：

| 要素 | 回答什么 | A 批里写的是 |
| --- | --- | --- |
| 角色 | 以什么身份、按什么标准做 | 严谨的活动经费核对助手，只按给定规则判断 |
| 背景 | 为什么做、给谁看、依据什么 | 迎新沙龙报销，交活动负责人检查；经费规则与样例 |
| 任务 | 具体做什么 | 逐份核对 A 批全部申请，整理成核对表 |
| 约束 | 范围多大，不能碰什么，缺信息怎么办 | 原件不改、不补造、只处理 A 批、不审批支付 |
| 格式 | 写到哪个文件，包含哪些列 | `outputs/核对表_v1.md`，八列加表后说明 |
| 自检 | 做完它自己先查什么 | 条目齐全、依据可查、金额复算、缺失与重复有标记 |

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

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

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

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

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

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

| 信息 | 放在哪里 | 理由 |
| --- | --- | --- |
| 原始材料不改动 |  |  |
| 本次处理 A 批 |  |  |
| B 批还没有跑 |  |  |
| 成果文件在哪里、怎样打开 |  |  |

判断标准：长期适用的约定写进 `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` 退出，再重新启动：

```bash
claude --permission-mode manual
```

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

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

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

#### ✅ 自查：第三至五步

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

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

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

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

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

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

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

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

```txt
计划可以，开始执行。
```

#### ✅ 自查：第六步

一份合格的计划应当：

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

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

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

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

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

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

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

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

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

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

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

**哪条经验放哪里：**

| 经验类型 | 放在哪里 | 例子 |
| --- | --- | --- |
| 只针对这次数据的修正 | 检查记录 | “A0X 的差额应为 ____ 元” |
| 下次还会用到的检查要求 | `CLAUDE.md` | “金额类核对先按明细复算合计，写出算式” |
| 固定的表头或格式 | 样例或模板 | 核对表增加“规则条款”列 |

从你刚写的修改意见里挑**一条**下次还会用到的，写进 `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`，写上项目入口（可以让它创建，你来批准）：

```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`，在里面启动。

| 练习 | 材料 | 要求 |
| --- | --- | --- |
| 社团筹备会 → 纪要与待办 | `02_社团纪要/` | 分清已决定、待议和待办；原记录没说清的负责人、日期、金额不能猜 |
| 课程汇报任务 | `03_短练习/02_课程汇报/` | 把“帮我做好 PPT”改成可以检查的任务说明 |
| 实习岗位 → 要求对照表 | 自带一份**公开的**岗位描述 | 分清岗位写明的要求和你的推断；没写出的技能、薪资不当成事实 |
| 课程通知 → 截止事项表 | 自带一份**公开的**课程通知 | 每个截止事项注明来源位置 |

---

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

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

```txt
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. **验收回到原始材料。** 能执行的修改意见要写清位置、问题、依据、要求和复查方式。