Appearance
07 · Prompting 四心法
📚 系列导航：上一篇 05 界面操作与快捷键 教你把手指放对地方。这一篇换个层面：手知道往哪按了，嘴还得知道怎么说——同样一个需求，话说得好不好，Claude 干出来的活儿天差地别。
01 心法一：具体 > 模糊
核心原则：指令越精确，返工越少。 很多人为了「省几个字」写模糊指令，最后在来回拉扯中花掉十倍时间补上。
把话说具体，塞清三个维度：
- 圈定范围：哪个文件、哪个函数、哪个场景下的问题。别让它满项目大海捞针。
- 声明约束：「别引新库」「保持向后兼容」「别动 migration 文件」。你不说，它就按自己的默认偏好来。
- 给出参照：与其描述「我想要什么风格的代码」，不如直接甩一个现成的例子——「照
HotDogWidget.php那个模式写」，实测效率最高的一招。
| 场景 | ❌ 模糊指令 | ✅ 具体指令 |
|---|---|---|
| 修 Bug | 修登录错误 | 用户超时后登录失败。查 src/auth/ token 刷新，先写失败测试复现，再修 |
| 写测试 | 给 foo.py 加测试 | 覆盖用户已登出的边界情况，不用 mock |
| 加功能 | 加个日历组件 | 参考 HotDogWidget.php 模式，月份选择+跨年翻页，别引新库 |
TIP
唯一例外：找灵感阶段可以故意模糊。当你自己还没想清楚方向时，一句「你觉得这个文件有什么可以改进的？」往往能炸出盲区。规律：要结果就往死里具体，找灵感才留白。
02 心法二：给上下文，别让它瞎猜
能贴的绝不用嘴说——Claude 读原始材料永远比读你对材料的二手转述准。
| 你想给的料 | ❌ 用嘴描述 | ✅ 直接喂 |
|---|---|---|
| 某个文件的内容 | 「项目里有个处理认证的文件」 | @src/auth/session.ts |
| 一段报错 | 「它报了个 undefined 的错」 | 把完整 traceback 原样贴进去 |
| 一个 UI 问题 | 「按钮位置不对」 | 直接粘截图 |
| 一份接口规范 | 「按我们的 API 规范来」 | @docs/api-spec.md |
两个最高频的动作：
- 用
@引用文件：在输入框打@，弹出文件路径补全，选中后文件完整内容被直接塞进对话。 - 报错直接整段贴：堆栈里文件名、行号、调用链全有，Claude 顺着就能精准定位。
03 心法三：给可验证的验收标准
这条最容易被忽略，但威力最大。
NOTE
关键认知：不给标准，Claude 凭「感觉差不多了」就收工，你成为验证循环——每个错误都在等你发现。给一个能跑出「通过/失败」的检查，循环就自己闭合。
| 任务 | ❌ 没验收标准 | ✅ 给了可验证标准 |
|---|---|---|
| 写函数 | 「实现一个校验邮箱的函数」 | 写 validateEmail，示例用例：user@example.com 为真、invalid 为假。写完跑测试 |
| 改 UI | 「让这个仪表盘好看点」 | [贴设计稿] 照这个实现，截图比对，列出差异并修掉 |
| 修构建 | 「构建挂了」 | 修并验证构建通过。解决根本原因，别把错误压下去 |
WARNING
最后一句「解决根本原因，别把错误压下去」——不写这句，它可能加个 try/except 或 @ts-ignore 把报错消掉，病根还在。
进阶玩法 /goal：把验收标准钉成整个会话的目标——每跑完一轮，小模型复查一遍，没达成就自动开下一轮。/goal test/auth 里所有测试通过，并且 lint 干净。
04 心法四：复杂任务先列计划
NOTE
让 Claude 直接跳到编程可能会产生解决错误问题的代码。先探索、再规划、最后编程——把「想清楚」和「动手干」拆开。
两个办法：
- 嘴上说清「先别改」：
我想给设置页加深色模式。先告诉我要动哪些文件、思路是什么，先别改任何代码。 - 切到 Plan Mode：
Shift+Tab循环到 plan，或消息前加/plan。
TIP
判断标准：如果你能用一句话描述这次改完长啥样，直接干；卡壳了，说明够复杂，先让它列计划。
05 动手：同一个需求两种说法对比
bash
mkdir prompt-demo && cd prompt-demo
echo 'def average(nums): return sum(nums) / len(nums)' > stats.py
claude❌ 烂提问：@stats.py 帮我改改这个函数 → 预期：它猜方向，大概率不是修除零
✅ 好提问：@stats.py 里的 average 函数有个 bug：空列表时除以零崩溃。期望空列表返回 0。修复并补测试：average([]) 返回 0、average([2,4]) 返回 3。写完跑测试确认通过。 → 预期：定位→修→写测试→跑绿
06 小结
| 心法 | 一句话 | 落地写法 |
|---|---|---|
| 具体>模糊 | 范围+约束+参照 | 「改 average，别引新库，照 xxx 模式」 |
| 给上下文 | 能贴的绝不说 | @文件、整段报错、粘截图 |
| 给验收标准 | 让它自己能验 | 测试用例+跑一遍；狠的上 /goal |
| 先列计划 | 大活儿先看图纸 | 「先别改」或 Shift+Tab 进 Plan Mode |
NOTE
下一篇：08 四类高频工作流：把本篇心法落到「探索代码库、修 Bug、重构、写测试」四类具体活儿上，每类给一套标准模板。