08 · 四类高频工作流

📚 系列导航：上一篇 07 Prompting 四心法 教你「话怎么说」——把模糊需求拆成精确指令。这一篇落到具体场景：日常 80% 的活儿就那四类，每一类给你一套能直接抄的指令模板。

---

01 先认住：四种活儿，四把工具

活儿	动代码吗	Claude 主要在干啥	你最该盯的
探索代码库	不动（只读）	读文件、给你讲	它讲得对不对
修 Bug	动	定位根因 + 改	根因找对没、回归测试有没有
重构	动（但行为不变）	等价改写	改完行为有没有变
写测试	加文件	生成测试 + 覆盖边界	边界情况覆盖全没

TIP

探索是零风险的（只读不写），放心大胆问；修 Bug 和重构是动刀的，得先让它讲清楚再动手。

---

02 探索陌生代码库：从大到小三层问

标准节奏：从大架构到具体文件再到执行链路。

第1层：给我一个这个代码库的整体概览，说说它的主要架构模式
第2层：负责 [用户认证] 的代码在哪些文件里？这几个文件是怎么协同工作的？
第3层：追踪一下 [登录流程] 从前端一直到数据库是怎么走的

TIP

前两层一定在 Plan Mode 里问（Shift+Tab 切到 plan），它只读不写，不会一激动就开始改文件。

探索模板：

我刚接手这个项目，帮我快速上手。分三步：
1. 给我整体架构概览，说清主要模块和它们的职责
2. 负责 [你关心的功能] 的代码在哪些文件里
3. 追踪 [某条核心流程] 的完整执行路径
用新手能懂的方式讲，先别改任何代码。

---

03 修 Bug：贴报错→找根因→改→加回归测试

四步走，缺一不可：

1. 贴报错 + 复现步骤：完整报错信息、堆栈，外加「我做了什么才触发」
2. 让它定位根因：先别让它改，让它说清楚「为什么会错」
3. 给修复：根因对了，再让它动手改
4. 加回归测试：补一个能复现这个 bug 的测试，保证以后不再犯

WARNING

解决根本原因，不要抑制错误。 不写这句，它可能加个 try/except 把报错消掉，病根还在。

修 Bug 模板：

我遇到一个 bug。
报错信息：[完整粘贴报错和堆栈]
复现步骤：[我做了什么才触发]
请你：
1. 先定位根本原因，解释为什么会出错，先别改代码
2. 给我修复方案，解决根因，不要只是把报错盖住
3. 改完补一个能复现这个 bug 的回归测试，跑一遍确认通过

---

04 重构：先讲现状→定目标→小步改→改前改后都测

重构的命根子：行为不能变。

四步安全打法：

1. 先让它解释现状：搞清楚这段代码现在到底在干啥
2. 说清重构目标：拆函数、去重复、换现代写法——说具体
3. 小步改：以小的、可测试的增量进行，别一次性推翻重写
4. 改前改后测试都过：重构前先跑一遍测试存基准，改完再跑，两次结果必须一致

WARNING

没测试覆盖的代码，别让 Claude 直接重构。 如果这段代码现在没测试，重构第一步是先补测试——用测试把「现在的行为」拍下来当快照，重构后对着验。

重构模板：

我想重构 [文件/函数名]。
重构目标：[具体说，如「拆成更小的函数」「消除重复」]
要求：
1. 先解释这段代码现在的行为，包括容易忽略的边界情况
2. 如果它还没有测试，先补上覆盖现有行为的测试
3. 小步重构，保持对外行为完全不变
4. 重构前后都跑一遍测试，确认结果一致

---

05 写测试：重点是逼它覆盖边界情况

NOTE

你不特别交代，它默认只测「正常情况」。真正值钱的是边界情况——空值、零、负数、类型错误。

❌ 模糊问法	✅ 精确问法
「给这个函数写测试」	给 divide 函数写测试，重点覆盖除数为 0、负数、非数字输入
它只测正常路径	它把真正会炸的地方都测到

写测试模板：

给 @[文件路径] 里的 [函数名] 写测试。
要求：
1. 沿用项目现有的测试框架和断言风格
2. 重点覆盖边界情况：[列出你能想到的]
3. 也帮我想想还有哪些我没列到的边界情况，一并测上
4. 写完跑一遍，有失败的修到通过

---

06 动手：修一个真 Bug 走一遍完整流程

mkdir bug-demo && cd bug-demo
echo 'def average(numbers): return sum(numbers) / len(numbers)' > calc.py
claude

我遇到一个 bug。
报错信息：调用 average([]) 时报 ZeroDivisionError: division by zero
复现步骤：给 calc.py 里的 average 函数传一个空列表就必现
请你：
1. 先定位根本原因，解释为什么会出错，先别改代码
2. 给我修复方案，解决根因
3. 改完补一个能复现这个 bug 的回归测试，跑一遍确认通过

预期：Claude 先定位空列表除零的根因，改代码加判空处理，再写测试文件跑绿。

---

07 小结

活儿	模板核心	最该盯的
探索代码库	整体架构→具体模块→核心链路	前两层在 Plan Mode
修 Bug	贴报错→找根因→改→加回归测试	解决根因别盖症状
重构	讲现状→定目标→小步改→改前改后都测	没测试先补测试
写测试	写测试，重点覆盖边界情况	显式逼它测边界

NOTE

下一篇：09 多模态：贴图改 UI：前面全是打字，有些事文字说不清——报错截图、设计稿、架构图，直接丢进去它就懂了。