Claude Code 小白技巧与工作案例：把 AI 用到编程和日常工作

本系列第 2 篇。读完这篇，你可以写出更清楚的指令，并完成几个可以直接复用的编程和办公任务。

一、先理解：提示词就是“任务说明书”

提示词不是魔法咒语，而是你写给 AI 的任务说明。说明越完整，来回修改越少。最简单的结构是：

我要做什么 + 为什么做 + 希望得到什么格式 + 有哪些限制

例如：

我要给登录接口增加手机号格式校验。
项目是 Python，接口文件在 auth 目录。
请修改代码并补 2 个单元测试，最后告诉我改了哪些文件和如何运行测试。
只修改 auth 目录，不改数据库结构，不重写其他功能。

二、先让 AI 说计划，再让它动手

小白最容易犯的错误是直接说“帮我改好”。更安全的写法是：

先不要改文件，请先说明：
1. 你认为问题是什么；
2. 准备修改哪些文件；
3. 修改后会影响什么；
4. 准备用什么命令验证。
等我确认后再修改。

这样做的好处是：你能在修改发生前发现理解偏差，也能控制修改范围。

三、让它区分事实和猜测

代码项目经常缺少文档。你可以要求：

请把结论分为三类：
- 代码已确认：能在文件中直接找到依据；
- 根据上下文推断：看起来可能如此，但没有直接证据；
- 需要我确认：当前材料不足，不能下结论。
不要为了完整而编造信息。

四、要求最小改动、保留回退能力

请遵循现有代码风格，只做完成需求所需的最小修改。
不要顺手重构无关代码。
完成后列出：改动文件、关键差异、测试结果、剩余风险。

每次修改后查看 Git diff。如果你看不懂某一行，就先让 AI 解释，不要直接提交。

五、编程案例 1：修复登录报错

场景

你运行项目时看到 401 Unauthorized，但不知道是账号、Token 还是代码问题。

第一步：提供上下文

这是一个 Node.js 登录接口的报错。
请先解释 401 最常见的原因，并告诉我还需要提供哪些信息。
不要修改代码，也不要猜测账号密码。

报错日志：
<粘贴完整日志>
相关接口代码：
<粘贴 30-80 行相关代码>

第二步：按顺序排查

请把排查步骤按“最可能且风险最低”排序。
每一步写清楚：我要执行什么、预期看到什么、看到不同结果说明什么。

第三步：验证修复

修复后要求：

请补充一个登录失败的测试和一个登录成功的测试。
运行测试并报告真实结果；如果没有运行条件，请明确说明，不要假装通过。

六、编程案例 2：为订单导入增加校验

需求

CSV 文件的 email 为空时跳过该行，并记录行号；其他字段保持原样。

推荐指令

项目使用 Python。请先只读分析订单导入流程。
需求：email 为空时跳过该行并记录行号。
限制：只修改 import 目录；保留现有日志格式；补充最小单元测试。
先给计划，等待我确认后修改。

你要检查什么

• 空邮箱是否真的会被跳过
• 记录的行号是否和原始 CSV 一致
• 合法邮箱和其他字段有没有被误伤
• 测试是否真的运行过

七、办公案例 1：把会议记录变成待办表

把下面会议记录整理成表格：事项、负责人、截止日期、依赖、状态。
只使用原文明确的信息；缺失内容写“待确认”。
最后列出 3 个需要负责人确认的问题。

<粘贴会议记录>

AI 只负责整理，不负责替你分配任务。发送前检查姓名、日期和承诺范围。

八、办公案例 2：写跨部门工作邮件

根据下面背景写一封中文工作邮件。
收件人是跨部门同事，语气礼貌、直接、少客套。
邮件必须包含：背景、请对方完成的事项、截止时间、需要回复的内容。
不确定的信息用 [待确认] 标记，不要替我承诺资源。

背景：<粘贴背景>

你可以继续追问：“请再给一个更简短、适合手机阅读的版本”。

九、办公案例 3：整理 Excel 或 CSV

我有一份销售 CSV。请先解释字段含义，并检查：重复行、空值、日期格式、异常金额。
不要修改原文件。请先输出清洗规则和风险清单，等待我确认后再生成新文件。

正确做法是保留原始文件，把清洗结果保存为新文件，然后抽查 10-20 行。

十、办公案例 4：写每日工作总结

把下面零散记录整理为日报：今日完成、阻塞问题、明日计划。
每部分最多 3 条，使用事实，不夸大成果。
阻塞问题必须写清楚：卡在哪里、需要谁协助、希望何时解决。

<粘贴工作记录>

十一、遇到结果不满意，怎么继续问

不要只说“重写”。指出具体问题：

内容方向正确，但太长。保留事实和数字，删掉背景铺垫，
改成 5 条项目符号，每条不超过 30 字。

十二、安全边界

• 上传前删除 API Key、密码、身份证号、银行卡号和客户敏感数据。
• 明确是“只总结”“给建议”还是“允许修改文件”。
• 法律、财务、医疗、人事决定必须人工复核。
• 代码修改必须查看 diff，并运行测试或手工验证。

十三、练习

选一个真实但低风险的小任务，按“目标、背景、格式、限制、验收”写指令。完成后检查：AI 是否按格式输出、是否编造信息、是否超出范围。

十四、国内编程案例：修复 Spring Boot 登录接口

场景

你在国内常见的 Java/Spring Boot 项目中遇到问题：前端提示“登录失败”，后端日志出现 401 或 500。小白不要直接让 AI “把登录修好”，而要逐层排查。

第一步：描述现象

这是一个 Spring Boot + Vue 的登录项目。
现象：输入正确账号后，前端提示登录失败；后端偶尔返回 401。
请先列出可能原因，并说明还需要查看哪些文件。
不要修改代码，不要读取真实数据库密码。
相关日志：<粘贴脱敏后的日志>

第二步：限定检查范围

只检查以下内容：
1. 登录 Controller 和 Service；
2. JWT 或 Session 配置；
3. Vue 的请求封装和响应拦截器；
4. application.yml 中与登录有关的非敏感配置。
请先给排查顺序，等待确认后再修改。

第三步：要求测试

修复后请补充 3 个测试：正确账号登录、错误密码、Token 过期。
运行测试并说明真实结果；如果测试无法运行，请说明缺少什么环境。

这类分层提问特别适合国内前后端分离项目，因为问题可能在后端鉴权，也可能在前端请求头或跨域配置。

十五、国内办公案例：飞书、钉钉、企业微信

1. 会议纪要转待办

下面是一次飞书会议纪要。请整理成表格：
事项、负责人、截止时间、依赖部门、状态、原文依据。
负责人和日期必须来自原文；没有依据就写“待确认”。
最后列出需要在飞书群里确认的 3 个问题。

2. 给钉钉或企业微信写通知

请把下面的制度变更写成企业微信通知。
受众是一线员工，语气清楚、少官话；按“发生了什么、我需要做什么、什么时候完成、去哪里提问”组织。
不要添加制度原文没有的处罚或承诺，字数控制在 300 字以内。

3. 生成周报但不夸大

根据以下 Jira/GitLab/禅道工作记录生成中文周报。
分为：已完成、进行中、风险、下周计划。
每项保留任务编号或提交依据；没有数据的地方写“暂无”，不要编造百分比。

十六、国内数据处理案例：Excel、CSV 和 MySQL

如果你要处理销售表、库存表或客户名单，先让 AI 设计规则，再处理副本：

这是一份脱敏后的销售 CSV。
请先检查列名、日期格式、重复订单、空手机号和异常金额，
输出“问题、判断规则、可能影响、人工确认项”。
不要修改原文件，不要连接公司 MySQL。

确认规则后，再让它生成 Python 清洗脚本，并要求：

• 原文件只读；
• 输出到新文件；
• 每一步打印处理数量；
• 失败行单独保存；
• 脚本运行前先展示命令。

十七、国内小白常见误区

• 把“写一段代码”当成“功能已经上线”：必须经过测试、评审和发布流程。
• 把群聊里的客户资料直接复制给 AI：先脱敏，确认公司政策。
• 让 AI 自己决定截止时间和负责人：这些属于人的管理决策。
• 只看“代码能运行”：还要检查权限、日志、异常处理和数据是否正确。