ARTICLE · 1058423
别急着让 AI 写代码:全栈工程师的 5 条协作纪律
两个月真实项目踩坑记录
一年前，AI 帮我补全一整段样板代码，我会觉得爽。
现在我不太看它写了多少行。真正拉开差距的东西换了——以前是"下一行怎么写"，现在是"谁能把一个工程闭环跑完"。
用 Claude Code、Codex 这类 Coding Agent 做了两个月真实项目，我把踩过的坑收敛成 5 条纪律。它们和提示词技巧关系不大，更多是关于边界、授权和上下文。
01
先别让它写代码
新需求进来，最顺手的动作是打一句"帮我实现这个功能"。
这也是效率最低的开端。
一个没吃透上下文的 Agent 直接动手，你换来的是能跑、但风格不对、边界不清、下游全要返工的代码。正确姿势是把它当成一名高潜力实习生，先走三步：
1先读代码。强制它把现有上下文吃透——相关模块在哪、怎么串联、谁调用谁。
2先说影响范围。这次改动会碰到哪些前端组件、哪些后端 Service、哪些表结构。
3先给方案。动手前先输出逻辑计划，你评审完再开工。
第三步最容易被跳过，但它最值钱：评审一份方案的沟通成本，远低于返工一次实现。
复杂任务还可以把它组织成一个虚拟小团队，用 AGENTS.md 定义分工：开发位按模块拆解，Review 位给即时反馈，测试位负责挑刺，UI 设计位盯组件层级和移动端适配。
链路是固定的：读懂上下文 → 拆出影响范围 → 小步修改 → 跑验证 → Review diff → 记录风险。少一环，后面都要还债。
02
把 CLAUDE.md 当成项目的锚
Agent 的随机性会带来漂移。你不可能每次靠对话把项目规矩重讲一遍——讲多了它会忘，讲少了它会猜。
所以第一步永远是 /init 这一步。它的产物 CLAUDE.md，就是给 Agent 立的流程护栏——四类硬信息必须写进去：
架构定义：模块怎么划分，前后端分别从哪启动。
工程指令：编译、测试、提交前必须跑的命令，一字不差。
约束禁区：哪些目录是生成物不能手改、哪些架构底线不能碰、代码风格怎么定。
历史避坑：项目里已知的技术债和需要特殊处理的逻辑。
最常见的翻车是这样：Agent 按自己的习惯建了目录和命名，两周后没人敢动那堆文件。
别把它当成一份说明书。它更像是你对这个项目主权的宣示。
03
旧项目里，模仿比创造值钱
在老旧代码库里，Agent 的模仿能力远比创造能力重要。
旧项目的难点从来不是"这行代码怎么写"，而是模块边界模糊、逻辑耦合。让它在这样的代码里跳舞，靠两条：
一是先找既有模式。让它搜项目里相似功能的实现，然后沿着现有风格做增量修改。要求它"和 XXX 模块保持一致"，比要求它"写得更好"有用得多。
二是试点扩散。面对国际化这类大重构，千万别全量铺开。先挑一个模块试点，把 i18n key 的管理规则、错误处理方案定下来；跑稳了，再把互相独立的模块拆给多个 Subagent 并行推进。
顺序别搞反：先定规则，再上规模。
04
上下文是内存，不是硬盘
长周期开发里，Agent 的 Context 就像内存——堆得越多，反应越慢，判断越糊。
把会话当资源管理，四个动作：
精确命名。给每个会话起一个带语义的名字，比如 order-timeout-debug。下次要找回它，用 /resume 就能从一堆历史里精准捞出来。
先总结再压缩。执行 /compact 之前，必须让它交一份交接单：改了哪些文件、跑通了哪些验证、还有什么风险、下一步从哪开始。Token 被压掉了，主线还在。
断舍离。任务从"重构方案"切到"排查 Bug"时，直接 /clear——上一个任务的判断逻辑会污染新任务。
看板监控。把 Token 消耗和输出发散程度当成仪表盘看。一旦它开始胡言乱语，就是该整理上下文的信号。
这块短板也值得单独补：装一个 UI 体验类插件（比如 ui-ux-pro-max），让 Agent 在工程逻辑之外，还能带上页面信息结构、空状态和用户操作习惯这些体验视角。
05
哪些活能放权，哪些永远不能
Agent 是执行者，不是决策者。涉及资产安全和破坏性变更时，人必须站在第一线。
授权不是信不信它的问题，是成本问题：放权省下的时间，和出错后要还的债，得先算清楚。按这个标准，活分三档。
安全区 充分授权
读陌生代码、找调用链、补单元测试、PR 前的风格 Review、重复性迁移。这些交给它，你只看结论。
风险区 严格审核
密钥与证书管理、高并发下的一致性逻辑、发布与回滚脚本、公共 SDK 的破坏性变更。它可以辅助分析，但每一步都要你点头。
禁区 严禁放权
鉴权模型、租户隔离逻辑、资金与订单结算的核心逻辑、生产环境的数据库脚本。这些地方的每一行，都必须由人写、人确认、人执行。
判断标准就一条：出错之后能不能回滚，代价由谁承担。回滚不了、代价是钱的，别放。
最后
全栈的定义正在被重写
过去的全栈，意思是前后端都能写。
现在的全栈，意思是你对整个工程链路有深度掌控。
当标准化的执行环节被 Agent 承包，开发者的价值就浓缩成四件事：定义边界、拆解任务、判断风险、验证结果。
说白了，全栈开发者正在变成工程指挥官。你要回答的问题也变了——你有没有能力划出那些真正有价值的边界和流程？这道护城河，只能自己修。
五条纪律 · 收藏版
01 先调研后动手，方案评审过再写代码。
02 把项目规矩写进 CLAUDE.md，不靠对话重复。
03 旧代码库里先模仿再扩散，先定规则再上规模。
04 上下文当内存管：会命名、会总结、该清就清。
05 安全区放权，风险区审核，禁区永远自己来。
你现在手上这个项目，哪一类活已经敢放心交给 Agent 了？评论区聊聊。