AI 的＂职场生存指南＂:怎么让代码助手不再乱来

你的 AI 同事，为什么总是自作主张？

上周我让 AI 帮我改一份配置文件。我说”把数据库地址换成新的”，它二话不说直接改了——不光改了地址，还顺手把我调了半天的超时参数”优化”成了它觉得更合理的值。

我改回来，又让它帮忙处理另一个文件。这次我学聪明了，说”改之前先问我确认”。它倒是问了，但问题藏在一大段分析文字的中间，我差点没看到。

相信用过 AI 编程工具的人都遇到过类似的场景。Claude Code 的核心开发者 Thariq 最近发了一篇长文，分享了他们在设计工具时踩过的坑。读完后我发现，这些”不听话”的行为背后都有原因——而且只要搞懂三件事，就能显著减少这类问题。

第一件事：让它问清楚再动手

先看一个真实的”翻车 → 修好”对比。

改之前，你让 AI 帮你搭一个登录页面。AI 直接开始写代码，做了一个邮箱密码登录。你其实想要手机验证码登录。返工。

改之后，同样的需求，AI 先弹出一个对话框：

请选择登录方式：

• • 邮箱密码（最基础，实现快）
• • 手机验证码（需要接入短信服务）
• • 第三方登录（GitHub/微信等）

你勾一个，它再动手。方向不会错。

这个”弹窗问你”的功能不是一开始就有的。Thariq 说，团队试了三次才做对：

第一次，把问题”夹带”在 AI 的正常回复里。结果问题经常被淹没在一堆分析文字中间——就像同事在邮件最后一行写”顺便问一下”，你大概率看不到。

第二次，让 AI 用特殊格式标注问题。但 AI 老是”不守规矩”，格式一会儿用一会儿不用。

第三次，做成独立的提问工具——专门的弹窗、清晰的选项、你不回答它就不继续。这一版终于稳了。

背后的道理很简单：专事专办。 提问就是提问，不要混在干活的过程中。

你现在就能做的事： 在给 AI 的规则文件里加一句——”涉及以下情况必须先问我确认再动手：删除文件、修改配置、选择技术方案”。就这一句话，能拦住大部分”自作主张”的问题。越具体越好，别只写”不确定就问我”，AI 经常觉得自己很确定。

第二件事：别把所有规矩一股脑塞给它

再看一个对比。

改之前，你给 AI 写了一份超长的规则文件，从代码风格到提交规范到测试要求，事无巨细写了 300 行。结果 AI 把提交规范记得死死的，但你最在意的”所有 API 必须写错误处理”反而被忽略了。

改之后，你把规则文件砍到 30 行，只留最核心的 7 条。详细的代码规范单独放一个文件，只在规则文件里写了一句”需要代码规范时，去看 rules/code-style.md”。AI 不仅核心规则条条执行，需要查规范的时候也能自己找到。

Thariq 管这个叫”按需给信息”。他们团队的做法是把指令分成三层：

核心规则——永远生效、不超过一页纸。比如”代码缩进两个空格””测试没通过不许提交”。

分类手册——根据当前任务自动加载。做前端时看前端规范，做后端时看后端规范。

参考资料——AI 平时不看，遇到具体问题时自己去翻。

甚至连 AI 能用的工具说明书，也不是一次性全部加载的——只有需要用到某个工具时，才去查怎么用。

你现在就能做的事： 打开你给 AI 写的规则文件（如果你还没写，现在是个好时机）。数一下有多少行。如果超过 100 行，试着做一次”断舍离”：核心规则留在主文件里（目标：一屏以内），其余的分类归档到单独文件中。你会发现 AI 反而更听话了——因为它终于能看清楚哪些是重点。

第三件事：让它交活之前先自己检查

最后一个对比。

改之前，你让 AI 帮你写一段代码。它写完直接交给你，你运行发现报错——少了一个引号。你告诉它，它改完又交给你，这次换了另一个错误。来回三轮，你比自己写还累。

改之后，同样的任务，AI 写完代码后自己先跑了一遍测试，发现报错，自己修好了，再跑一遍测试通过了，然后才告诉你”写好了，测试通过”。你拿到手直接能用。

Thariq 说这是他们团队最看重的一条设计原则：让 AI 有能力验证自己的工作。

所以 Claude Code 在设计时，专门确保 AI 能自己运行测试、检查代码格式、验证文件是否正确。不是”做完就交”，而是”做完、自查、确认没问题再交”。

你现在就能做的事： 给 AI 安排任务时，在后面加一句验证指令。比如：

• • “写完代码后跑一遍测试，确保通过”
• • “改完配置后验证格式是否正确”
• • “重构完毕后确认所有现有功能不受影响”

就像你安排同事做方案时会说一句”交之前自己过一遍”——AI 也需要这句提醒。

总结：三个设计逻辑，一个靠谱同事

Claude Code 团队把工具数量严格控制在 20 个左右——不是做不出更多，而是每多一个工具，AI 就多一份”我该用哪个”的纠结。少而精，才管得住。

把今天说的三件事串起来，就是一个靠谱同事的工作方式：

任务来了，先问清楚 → 需要查资料，按需去找 → 做完之后，自己检查一遍 → 确认没问题，再交付。

今天就试一件事：打开你给 AI 写的规则文件，数一下有多少行。如果超过一屏，砍掉一半只留最核心的。少即是多，这一刀下去，你大概率会发现 AI 反而更听话了。

本文是精简版，Blog 技术版还包含：

• • AskUserQuestion 的完整参数结构和代码示例
• • TodoWrite vs TaskCreate 详细对比表（持久化、依赖管理、子代理协作等 6 个维度）
• • CLAUDE.md 分层组织的目录结构示例和 @import 语法
• • 用 Hook 实现自动验证的配置方案
• • 从”需求到交付”的完整工作流贯穿案例

点击「阅读原文」查看完整技术版。

本文观点整理自 Claude Code 核心开发者 Thariq 发布的长文《Lessons from Building Claude Code: Seeing like an Agent》及 Claude Code 官方文档。