避免 AI 编程技术债：五条节奏控制原则

快不是问题，失控才是

VibeCoding 让「从想法到可点界面」变得很短。若缺少节奏控制，仓库会在一个月内堆满：重复组件、拷贝粘贴业务逻辑、无测试的关键路径、以及只有作者能读懂的对话残留注释。

本文给出五条原则，帮助你在继续快的同时，把债压在可偿还区间。详见工作流总览：VibeCoding 实战。

原则一：垂直切片，禁止「一次十文件大礼包」

让 AI 每次只交付可验证的一条链路：页面或接口或脚本。切完就 build / 测，再开下一刀。大礼包式生成会让调试成本指数上升。

原则二：每两个切片强制一次「只重构」会话

明确告诉模型：本轮不接受新功能，只做去重、命名、提取。没有这条闸门，原型结构会永久固化。

原则三：关键路径必须有自动化锚点

不必追求覆盖率虚高，但登录、支付、权限、数据删除等路径至少要有测试或可重复脚本。AI 改代码时先跑锚点，再谈感觉。

原则四：生成代码的准入标准写进 Rules

例如：禁止无理由 any；禁止秘密键进库；新增依赖必须说明。标准见 Cursor Rules 指南。没有成文标准，Review 只能靠心情。

原则五：用 PR 大小限制「对话惯性」

单 PR 超过一定 diff（团队自定，如 400 行业务代码）就拆。AI 会话可以很长，合并单元必须短，否则审查与回滚都会失效。

技术债看板（简易）

维护三列即可：

• 已知妥协：当时为了上线故意留下的
• AI 产物异味：重复、命名混乱、注释谎言
• 下个迭代偿还：绑定具体负责人与版本

债被看见，才可能被排期；只存在于聊天记录里的债等于不存在。

个人项目也要有「刹车」

独立开发者没有经理盯进度，反而更容易一路 vibe 到底。建议用日历固定：每周五下午只重构与补文档，不接新需求。

小结

AI 放大了编码速度，也放大了制造债务的速度。用切片、重构窗、测试锚点、Rules 准入与 PR 限幅五条原则做节奏器，你才能在 RuleHub 式的快速迭代中仍然睡得着觉。

下一步：回顾本周由 AI 合并的改动，挑出一处重复实现，开一个「仅重构」PR 练手。