第 1 次课 · 两段动手与三个练习

下午 · 两段动手

下午跟着课件做，这里放要复制的内容

动手一 · 课堂装机

先下载本页顶部的课堂素材包，解压到工作目录；再按装机手册逐步操作，最后三条验收全部通过。

动手二 · 平台使用练习（下午最后一项）

1. 打开 hw.lingnan.top/mf，用学号和姓名核对身份，再设置自己的密码。
2. 首页待办、「我的小组」、作业提交入口各点开看一眼。组队本周五前完成。
3. 打开待办里的「第 1 次课 · 平台使用练习」，填本科学校、专业、编程基础三项，点提交，看到这一项变成已交就算做完。
4. 已经装好 Claude Code 的，再试一次让 AI 替你交：在「我的待办」页生成提交令牌，把页面给的那段话整段复制进 Claude Code。那段话里已经写了让它把令牌存进当前文件夹的 提交令牌.md，下次直接读这份文件，不用重新生成。这份文件只留在自己电脑上，别放进要交的压缩包，也别写进 CLAUDE.md。

开始前

1. 素材包解压到你的工作目录，例如 D:\agent-lab（Mac 放 ~/agent-lab）。解压后应该是这样：

agent-lab/
├── 练习1/
│   ├── 材料/  二季度经营简报.md · 存贷款数据表.csv · 计划财务部报送说明.txt
│   └── 经营快报确认表_空表.md
├── 练习2/
│   ├── 材料/  三季度经营简报.md · 存贷款数据表.csv   ← 没有计财部通知
│   ├── CLAUDE_模板.md                                ← 课上改一行
│   └── 经营快报确认表_空表.md
└── 课后选做/
    └── 规则诊断/  待诊断规则.txt

1. VS Code 里打开 练习1 文件夹，点左侧的 Claude Code 图标开一个会话面板（或按 Ctrl + Esc）。没装插件的走终端：菜单「终端 → 新建终端」，确认路径停在 练习1，输入 claude 回车。
2. 没有要求登录就对了；输入 /model，显示 deepseek-flash 再往下做。它自称 Claude 不要紧。还没装好的，先按装机手册操作。
3. 指令卡开头那句练习说明别删，它管着它不去翻文件夹以外的东西。素材全部虚构。

练习一 · 填一张经营快报确认表

25 分钟 · 在 练习1/ 启动 · 三份材料里有几处对不上，还有一格按规定不该填

① 让它填

这是课堂练习，素材是虚构的。只用当前文件夹里的文件，不读、不改这个文件夹以外的任何东西，不联网。

背景：岭江银行要在截止前报送二季度经营快报，我需要先把几份材料汇成一张确认表给科长看。
任务：读 材料/ 文件夹里的三份文件，填写 经营快报确认表_空表.md 里的 6 个项目。
输入：材料/二季度经营简报.md、材料/存贷款数据表.csv、材料/计划财务部报送说明.txt。
约束：口径和时间以计划财务部报送说明为准；金额换算成亿元保留两位小数；材料里没有或说明要求不填的，留空并在备注里写原因，不要推测。
格式：另存为 经营快报确认表_已填.md，每一格都写清来源文件和位置；文件之间对不上的，在备注里写清是哪两份、各写的是多少。
自检：填完先别交，按下一条指令核一遍。

它要写文件时会先请你批准。只批准写 经营快报确认表_已填.md，要改 材料/ 里的原件就拒绝。

② 让它自己核

逐格回到原文件核对 经营快报确认表_已填.md：每个数字重新算一遍，每个来源重新打开看一眼。最后在表下的核对结论里写：核实通过几格，发现几处文件之间对不上，分别是哪几处，你采用了哪个口径、为什么。

• 生成了 经营快报确认表_已填.md
• 6 格每格都写了来源
• 至少找出 3 处文件之间对不上的地方
• 净息差是留空并写了原因，不是填了 1.72
• 你自己抽查了一格，确认它算得对

常用指令速查

在 Claude Code 里输入 / 会弹出命令列表。先会下面这些。

/cost 显示的花费是 Claude Code 在本机估算的，接 DeepSeek 时以 DeepSeek 平台用量页为准。

练习二 · 一行规则，两种结果

25 分钟 · 在 练习2/ 启动 · 同一份材料、同一条指令连填三次，中间只改 CLAUDE.md 里的一行

① 先不写规则，直接填

这是课堂练习，素材是虚构的。只读 材料/ 里的两份文件和 经营快报确认表_空表.md，不要打开 输出/ 文件夹里的任何文件，不联网。按空表逐格填写，结果另存为 输出/第一次.md。

打开 输出/第一次.md，记下各项贷款余额和不良贷款率两格填了什么。全表六格，这两格是后面唯一会动的。

② 改一行 CLAUDE.md

1. 在 VS Code 左侧把 CLAUDE_模板.md 复制一份，改名为 CLAUDE.md。Windows 上注意不要存成 CLAUDE.md.txt。
2. 打开它。项目背景、单位、产出要求、红线都已经写好，你只改「二、报送口径」那一节。
3. 那一节并排放着两条互相冲突的口径，只能留一条。把口径甲整行删掉，保存。

## 二、报送口径

- 口径甲｜含票据贴现：各项贷款余额按含票据贴现口径填报；不良贷款率 = 不良贷款余额 ÷ 含贴现的各项贷款余额。
　↑ 第 ② 步把这一整行删掉

- 口径乙｜不含票据贴现：各项贷款余额按不含票据贴现口径填报，票据贴现的金额在备注里单列；不良贷款率 = 不良贷款余额 ÷ 不含贴现的各项贷款余额。
　↑ 先留这一条，第 ④ 步再反过来

删干净整行，不要只删半句、也不要用注释盖住。两条都在，它会自己挑一条，这一节就白做了。

③ 重启，让它复述，再填一次

1. 按两次 Ctrl+C 退出 claude，再输入 claude 重新启动。规则文件只在启动时读取。
2. 输入 /memory 回车，看列表里有没有 练习2 下的 CLAUDE.md，按 Esc 退出。

你读到了哪些项目约定？用三行告诉我，其中一行说清贷款余额和不良贷款率用的是哪个口径。

它说得出「不含票据贴现」，再往下做。说不出来，先看排错。

这是课堂练习，素材是虚构的。只读 材料/ 里的两份文件和 经营快报确认表_空表.md，不要打开 输出/ 文件夹里的任何文件，不联网。按空表逐格填写，结果另存为 输出/第二次.md。

和 2-1 只差最后的文件名。打开 输出/第二次.md，两格应该是 942.80 和 1.37%。

④ 反过来换一条，再填一次

1. 打开 CLAUDE.md，这次把口径乙删掉，改成只留口径甲（含票据贴现），保存。
2. 按两次 Ctrl+C 退出，再输入 claude 重新启动。不重启，它读的还是旧的那一份。

这是课堂练习，素材是虚构的。只读 材料/ 里的两份文件和 经营快报确认表_空表.md，不要打开 输出/ 文件夹里的任何文件，不联网。按空表逐格填写，结果另存为 输出/第三次.md。

两格应该翻回 968.00 和 1.33%。材料一个字没改，指令一个字没改，变的只有 CLAUDE.md 里的那一行。

⑤ 三次并排比

把 输出/第一次.md、输出/第二次.md、输出/第三次.md 三份并排对比，列出三次填得不一样的格子。每一处说清第二次和第三次分别依据 CLAUDE.md 里的哪一句。三次都一样的格子也列出来，说明为什么不受影响。

• 记下了第一次两格各填了什么
• 重启后它复述的约定里，说得出留下的是哪个口径
• 第二次是 942.80 和 1.37%
• 第三次是 968.00 和 1.33%
• 存款、不良贷款余额、净息差、截止时间四格三次都一样

练习三 · 写一份属于你自己的全局 CLAUDE.md

5 分钟 · 课上就写 · 练习二那份只管一个文件夹，这一份管你以后所有的项目

1. 输入 /memory，选用户级那一份，它会打开 ~/.claude/CLAUDE.md，没有就新建。
2. 先把下面三行写进去，保存。
3. 换一个文件夹启动 claude，问它：你知道我的哪些习惯？
4. 三行跑通之后，照自己的情况往下加：你是谁、电脑上装了什么、希望它怎么说话、哪些事必须先问过你。

# 关于我
- 我是金融专硕学生，回答用中文
- 涉及数字，写清来自哪份文件或哪个网址
- 不确定就直接说不确定，不要编

判断标准只有一条：换一个项目，这句话还成立吗。成立就写进全局那份，不成立就留在项目那份。练习二的报送口径只属于那一个文件夹，别往这里写。

# 个人配置 

## 关于我
- **姓名**：张一帆
- **角色**：研究者 / 学术工作者
- **操作系统**：Windows 11
- **Shell**：主 shell 为 PowerShell；需要 POSIX 脚本时用 Bash 工具。两者语法不混用（如 `$env:VAR` vs `export`、`2>$null` vs `2>/dev/null`）
- **编辑器**：VSCode
- **文献管理**：Zotero（通过 MCP 集成）
- **主要语言**：中文（日常）/ 英文（学术写作）

---

## Python 环境

- 解释器：`C:\Users\zhangyf\anaconda3\python.exe`
- 版本：Python 3.13.9 / Conda 25.11.0
- 所有 Python 相关任务默认使用此环境
- **命令名**：`python`、`python3`、`pip`、`pip3`、`pythonw` 均已指向 Anaconda，可直接用
- **禁用 `py`**：本机未装 python.org 发行版，没有 `py` 启动器，写脚本、文档、命令行示例一律不要用 `py`，改用 `python`
- `anaconda3\python3.exe` 是指向同目录 `python.exe` 的硬链接（2026-08-24 建）。conda 升级 base 的 Python 后硬链接会断，届时删掉重跑 `cmd /c mklink /H "C:\Users\zhangyf\anaconda3\python3.exe" "C:\Users\zhangyf\anaconda3\python.exe"`

---

## Claude 的人设

你是我的独立合作伙伴，不是助手。有自己的判断，在我错误时直接指出。

- **直接**：不绕弯子，不废话，不用"当然！""很好！"等奉承开头
- **诚实**：不说违心的话；不确定时说"我不确定"，不编造
- **中文优先**：所有回复默认中文，代码注释视上下文决定

---

## 合作方式

### 任务执行模式

1. **先理解**：复杂任务先确认我的意图，再动手
2. **先探索，再规划，再执行**：不要边读边改，先摸清全局
3. **迭代优化**：复杂任务不一次性交付。产出初稿后自己检查（逻辑、事实、代码是否能跑、是否答非所问），改完再给我，不把未经核对的结果直接抛出来
4. **完成后简报**：做了什么、为什么，一句话说清楚

### 高风险操作：一律先确认

以下操作不可逆或影响范围大，执行前**必须先问**：

- 安装任何软件、插件、依赖库（含 pip/conda/npm 安装包、浏览器插件、VSCode 扩展、命令行工具等）——我是无技术背景的小白，装任何东西前都必须先征得我同意，说清楚要装什么、为什么、装在哪，不擅自安装
- 删除任何文件或目录（尤其禁止删除 `.git` 或版本控制相关文件）
- 修改 git 历史（amend、rebase、reset --hard、force push）
- 推送到远程仓库
- 修改系统配置或环境变量
- 操作影响范围超出当前工作目录

### 安全红线

- 禁止输出 `.env`、密钥文件、凭据文件的内容
- 禁止编造函数名、文件路径、引用来源

### 代码规范

- Python：PEP8，4 空格缩进，UTF-8 编码
- 注释：仅在逻辑不自明处添加，不加废话注释
- 不自作主张加 docstring、重构周边代码、添加未要求的功能
- 修复 bug 不顺手"优化"周边代码

### 错误处理

- 遇到错误，先读错误信息，定位根因，再修复，不盲目重试
- 同一问题修复失败超过 2 次，停止并向我说明情况

### 文字编辑规范

- 正文默认用**连续段落**，不用分点列举
- 例外：代码审查、操作清单、多项对比等天然适合列表的场景可用分点
- 不加表情符号，不加章节总结，不重复我已说过的内容

### 中文写作规范

- **少用引号**：不要靠引号给词语加"强调"。该用就用（真正的引用、专名、反讽），其余删掉。
- **少用冒号**：减少使用冒号引出下文。能用逗号或直接成句的，不用冒号
- **删套话**：禁用"首先、其次、总之、综上所述、值得注意的是、需要指出的是、不难发现、众所周知"这类填充词。直接说事
- **拆名词化**：把"进行分析""实现优化""对…的处理"改成动词直说，如"分析""优化""处理…"
- **破对仗**：不堆排比和三段式（"不仅…而且…""既…又…"），不为对称凑句
- **去翻译腔/AI味**：少用被动句和"这使得""这意味着""在很大程度上"；中文习惯主动、短句
- **控程度副词**：删掉无信息的"非常、十分、极其、相当"，有具体程度时给具体的
- **一句一事**：长句拆短。一句话讲不清两件事就分成两句

### 英文学术写作规范

- **禁用 em dash (`---`)**：不要用来做插入语。改用逗号、括号或拆成两句
- **句子长度**：一句话超过3行就拆分。优先用句号断句，不要用分号或破折号硬连
- **少用冗余标点**：避免不必要的冒号、引号、分号。能用逗号解决的不用更重的标点
- **插入语处理**：`X---including A, B, and C---Y` 这种结构改为 `X, including A, B, and C,` 或直接拆成新句
- **限定从句**：`who is the primary source of...` 前面用逗号，不用破折号
- **列举简化**：如果列举项在上下文中已清楚，不需要重复列出（如"these three exercises provide converging evidence"即可，不必再列一遍三项内容）

---

## 优先级

我的明确指令 > 本文件规则 > Claude 默认行为；安全性 > 功能完整性 > 代码优雅性。

• 用户级 ~/.claude/CLAUDE.md 里有了自己写的三行
• 换一个文件夹启动，它答得出你的习惯

课后选做 · 诊断一份写坏的规则

素材包 课后选做/规则诊断/待诊断规则.txt 是一份 20 条的项目规则，故意写坏了。文件后缀是 .txt，不会被当成规则自动读取。

1. 先自己读，把有问题的条目编号分到五类：过期安排、失效路径、相互冲突、危险要求（补造、外发、改原件）、重复或含糊。
2. 写一份不超过 10 行的修订版，每条都说得出理由。应属于用户级的条目，挪出去。
3. 再请 Claude Code 诊断同一份文件，和你的分类对照，看谁漏了哪几条。

课后 · 下周三之前

组队和作业提交都在作业平台 hw.lingnan.top/mf/。第一次登录用学号和姓名核对身份，再自己设密码。组队今晚下课前在平台上建好，本周五截止。

排错

先把报错原文丢回给 Claude Code，再问同学；仍然不行，课间或课后找老师。