定好 4 层约束团队用 Vibe Coding 写代码才不翻车【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址: https://gitcode.com/GitHub_Trending/aig/ai-guideai-guide 里记录的 Vibe Coding 实践上个月冲刺收尾时真实翻过车两个人各自让 AI 做同一个导出模块合并那天评审人沉默了——一个 AI 用 camelCase 命名另一个用 snake_case一个引 axios另一个用 fetch两份 lockfile 还各自带进同一个工具库的不同大版本。个人 AI和团队 AI的差别从来不在效率而在约束AI 把每个人的个人偏好放大了十倍没有约束层合并出来的代码就是一块拼布。这篇把团队用来止血的四层约束——契约层、流水线层、沉淀层、边界层——拆开讲每一层都是当天就能落地的小事。契约层把团队约定变成 AI 会自动读的硬约束团队 AI 协作里最反直觉的一点是团队规矩不能只发在群里AI 也得读得到。我们上次更新代码约定只发了群 贴了文档站半个月后新同学的 AI 照样按旧技术栈生成了一整套代码。原因不复杂AI 的上下文是仓库 这次对话不包括上周群聊记录。于是我们把约定做成了三环节链条文档 → 规则文件 → CI每一环补上一环的短板。CONTRIBUTING.md给人看技术栈、命名、评审要求按新人能读懂的方式写并且它是规则的单一事实来源——有争议时以它为准。AGENTS.md给 AI 看越来越多 AI 编程工具在收敛到从仓库根目录自动加载规则文件的约定——Cursor 认.cursorrulesClaude Code 认CLAUDE.mdCodex CLI 等较新的工具认AGENTS.md各工具的加载机制以官方文档为准。我们选AGENTS.md作为 AI 实际读的那份从CONTRIBUTING.md手工派生全文压到 40 行以内# AGENTS.md ## 技术栈 - Next.js TypeScriptstrict状态管理 Zustand - HTTP 请求一律走 src/lib/http.ts禁止直接 fetch / axios ## 禁止事项 - 不引入新的顶层依赖必要时先提 issue - 不改动已有 API 响应字段允许新增 - 不改动现有命名与目录结构 - 时间处理统一 dayjs禁用 moment内容有两个设计点。禁止事项写成负向规则AI 对不能做什么的敏感度远高于建议做什么一句统一 dayjs比一段建议统一时间库管用得多。规则文件不写长AI 的上下文窗口有限规则文件超过一定长度中间部分会读了但不执行40 行硬规则好过 500 行的最佳实践。CI 是兜底环节。AI 有时会不读规则人有时会忘记跑本地检查但 CI 不会讲情面流水线加三道工序——类型检查、lint、跑测试任何一道红了就不给合并。这一环顺带治好了开头的 lockfile 问题新增依赖不提交 lockfile安装直接失败根本轮不到人肉发现。为什么非要做成链条文档是源头防止两个版本规矩的争论规则文件让文档变成机器可读防止AI 看不见CI 让规矩变成硬约束防止看见了不执行。三环缺任何一环规矩都会退化成口号。流水线层从想法到合并每个环节谁干什么契约层铺好之后接下来的问题是一段代码从想法到合并的路径上哪几步交给 AI哪几步留给人卡口。我们的做法是按环节派工而不是争论AI 能干什么环节AI 做什么人卡在哪常见翻车点需求拆解出技术方案、改动文件清单、任务拆分改动面是否合理、是否凭空发明接口顺手扩大范围一个需求带上重构三个无关模块编码写功能代码、单测、commit 信息方案是否合理、是否过度设计命名风格漂移新依赖版本没进 lockfile自测跑测试、修复失败项测试 diff 是否放宽断言不改代码改测试让它通过合并请求初审总结改动、指出潜在问题每条审查意见是否成立AI 盖章、人也盖章的双重放行合并发布生成 changelog、整理版本说明发布窗口、版本 taglockfile 忘了更新环境间依赖漂移表格里有两行翻车值得展开。自测那一行是最阴险的一次。有份 PR 修排序 bugdiff 里藏着一处改动expect(result.total).toBe(3)变成了expect(result.total).toBeGreaterThan(0)。AI 没搞稳定排序就把断言改松了测试全绿bug 还在。后来我们的规则是合并请求里人先看测试文件 diff再看业务代码。这条为什么站得住AI 的目标函数是绿人的目标函数是对目标函数不同这一步就得留人。需求拆解的顺手扩大范围是另一个高频事故。AI 特别爱顺便把这个文件也清理一下某次一份 MR 改了两千行评审人看到一半放弃最后只能拆 MR 重审。现在的做法是把一句话写进规则文件发现其他模块的问题只列出来不要动手。改动面约束的成本为零评审效率立刻回来。沉淀层把 AI 踩过的坑写回规则文件还有一种隐性成本容易被漏掉AI 踩过的坑下一个人还会再踩一遍。有人 review 时发现 AI 生成了一段早就废弃的 API 用法花了十分钟解释清楚半个月后另一个人的对话里同样的坑又出现一次。经验躺在一条 review 评论里MR 合并完就消失了。我们的做法是把坑写回AGENTS.mdreview 发现一个坑先判断它属于这个人手滑还是AI 默认就会这么错。后者就在禁止事项里加一行。规则文件本身走 Git 管理更新走 MR门槛设得很低改AGENTS.md的 MR 必须贴出对应的翻车实例两行字的 MR 当天就合。每条规则都有出处没人能把我觉得写进规则。这一步的传染性成本接近零下一次会话每个成员的 AI 都会自动加载更新后的规则文件那个错法不再出现——比开一次培训会便宜比下次注意可靠。反方向也要做每两周有人过一遍AGENTS.md删掉早就全部遵守和已经不适用的规则。规则文件会自然膨胀膨胀的文件稀释 AI 的注意力CI 的规则也会跟着变吵。我们有一段时间禁止事项涨到三十行AI 开始对中间部分打滑清理回十二行后才恢复。沉淀和删减是一枚硬币只沉淀不删规则文件会死掉。边界层人和 AI 的分工线画在哪跑了三个月之后团队不再问AI 能不能干这件事而是问这件事谁干、出了事谁负责。我们用了三条判断标准画线。标准一看可逆性。不可逆操作——生产库数据迁移、权限变更、删除长期分支、公共依赖升大版本——AI 可以产出完整的操作清单和回滚预案但执行要人逐条点。区分的原因在翻车成本可逆代码上的 AI 错误代价是重写几分钟不可逆操作上的错误代价是回滚加复盘。标准二看信息在不在上下文里。判断依据在代码库之外的事——需求是不是有歧义、该砍哪个功能、定价合不合理——AI 只能猜因为它的上下文是仓库和你贴的 prompt不包括上周三的产品会。这类事 AI 只出选项和利弊人拍板。标准三看责任能不能说清。任何要上线的代码必须能对应到团队里至少一个人他能完整讲出这段逻辑。如果线上出 bug这段合并代码的作者只有 AI没人能回答为什么这么写那就是红线。所以我们会把MR 作者能否讲清这段逻辑做成评审里的一道问答题。反过来AI 必须接手的是机械重复型工作样板代码、批量改名、生成测试数据、diff 初审。这类任务它的边际成本趋近于零出错率也不高。代码评审是典型的两边都做AI 做第一遍风格、明显 bug、缺测试人做第二遍业务正确性、安全边界安全敏感的改动不要只信一个 AI 的判断换第二个工具或人来交叉因为模型的安全知识有训练截止日期。落地清单团队明天就能开始的 7 件事 以下按落地顺序排列每条都是谁 做什么 产出物可以直接建成 checklist 执行。技术负责人当天在仓库根目录建AGENTS.md50 行以内——产出物规则文件第一版。一名前端 一名后端从最近的 review 记录里挑出 10 条AI 做错的事——产出物10 条负向规则当天合入。CI 负责人在流水线里加类型检查、lint、跑测试三道工序——产出物能拦截不合规代码的 CI配置可以让 AI 生成。任意两名成员用同一份规则文件让 AI 各自生成一个小需求的首版代码对比两份输出——产出物一页对比记录用于校准规则。每位 MR 作者合并前把 diff 交给第二个 AI 工具做初审——产出物初审意见附在 MR 描述里。团队负责人定每两周一次的规则文件清理机制轮值到人——产出物规则文件清理 MR。技术负责人挑一个不可逆操作如数据迁移在发布文档里写明AI 出清单、人执行——产出物写进发布 SOP 的边界层。这 7 条做完四层约束就齐了契约层决定代码长什么样流水线层决定每步谁卡口沉淀层决定坑不踩第二次边界层决定责任停在哪。AI 让每个工位变快而让团队速度真正叠加起来的是这四层。想了解更多细节仓库里的《Vibe Coding 代码质量保障》讲了审查维度怎么写《团队研发规范》是一份企业级版本的流水线层实践可以对照着读。【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址: https://gitcode.com/GitHub_Trending/aig/ai-guide创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/3 2:01:41 · 阅读 1.2k 定好 4 层约束，团队用 Vibe Coding 写代码才不翻车
定好 4 层约束团队用 Vibe Coding 写代码才不翻车【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址: https://gitcode.com/GitHub_Trending/aig/ai-guideai-guide 里记录的 Vibe Coding 实践上个月冲刺收尾时真实翻过车两个人各自让 AI 做同一个导出模块合并那天评审人沉默了——一个 AI 用 camelCase 命名另一个用 snake_case一个引 axios另一个用 fetch两份 lockfile 还各自带进同一个工具库的不同大版本。个人 AI和团队 AI的差别从来不在效率而在约束AI 把每个人的个人偏好放大了十倍没有约束层合并出来的代码就是一块拼布。这篇把团队用来止血的四层约束——契约层、流水线层、沉淀层、边界层——拆开讲每一层都是当天就能落地的小事。契约层把团队约定变成 AI 会自动读的硬约束团队 AI 协作里最反直觉的一点是团队规矩不能只发在群里AI 也得读得到。我们上次更新代码约定只发了群 贴了文档站半个月后新同学的 AI 照样按旧技术栈生成了一整套代码。原因不复杂AI 的上下文是仓库 这次对话不包括上周群聊记录。于是我们把约定做成了三环节链条文档 → 规则文件 → CI每一环补上一环的短板。CONTRIBUTING.md给人看技术栈、命名、评审要求按新人能读懂的方式写并且它是规则的单一事实来源——有争议时以它为准。AGENTS.md给 AI 看越来越多 AI 编程工具在收敛到从仓库根目录自动加载规则文件的约定——Cursor 认.cursorrulesClaude Code 认CLAUDE.mdCodex CLI 等较新的工具认AGENTS.md各工具的加载机制以官方文档为准。我们选AGENTS.md作为 AI 实际读的那份从CONTRIBUTING.md手工派生全文压到 40 行以内# AGENTS.md ## 技术栈 - Next.js TypeScriptstrict状态管理 Zustand - HTTP 请求一律走 src/lib/http.ts禁止直接 fetch / axios ## 禁止事项 - 不引入新的顶层依赖必要时先提 issue - 不改动已有 API 响应字段允许新增 - 不改动现有命名与目录结构 - 时间处理统一 dayjs禁用 moment内容有两个设计点。禁止事项写成负向规则AI 对不能做什么的敏感度远高于建议做什么一句统一 dayjs比一段建议统一时间库管用得多。规则文件不写长AI 的上下文窗口有限规则文件超过一定长度中间部分会读了但不执行40 行硬规则好过 500 行的最佳实践。CI 是兜底环节。AI 有时会不读规则人有时会忘记跑本地检查但 CI 不会讲情面流水线加三道工序——类型检查、lint、跑测试任何一道红了就不给合并。这一环顺带治好了开头的 lockfile 问题新增依赖不提交 lockfile安装直接失败根本轮不到人肉发现。为什么非要做成链条文档是源头防止两个版本规矩的争论规则文件让文档变成机器可读防止AI 看不见CI 让规矩变成硬约束防止看见了不执行。三环缺任何一环规矩都会退化成口号。流水线层从想法到合并每个环节谁干什么契约层铺好之后接下来的问题是一段代码从想法到合并的路径上哪几步交给 AI哪几步留给人卡口。我们的做法是按环节派工而不是争论AI 能干什么环节AI 做什么人卡在哪常见翻车点需求拆解出技术方案、改动文件清单、任务拆分改动面是否合理、是否凭空发明接口顺手扩大范围一个需求带上重构三个无关模块编码写功能代码、单测、commit 信息方案是否合理、是否过度设计命名风格漂移新依赖版本没进 lockfile自测跑测试、修复失败项测试 diff 是否放宽断言不改代码改测试让它通过合并请求初审总结改动、指出潜在问题每条审查意见是否成立AI 盖章、人也盖章的双重放行合并发布生成 changelog、整理版本说明发布窗口、版本 taglockfile 忘了更新环境间依赖漂移表格里有两行翻车值得展开。自测那一行是最阴险的一次。有份 PR 修排序 bugdiff 里藏着一处改动expect(result.total).toBe(3)变成了expect(result.total).toBeGreaterThan(0)。AI 没搞稳定排序就把断言改松了测试全绿bug 还在。后来我们的规则是合并请求里人先看测试文件 diff再看业务代码。这条为什么站得住AI 的目标函数是绿人的目标函数是对目标函数不同这一步就得留人。需求拆解的顺手扩大范围是另一个高频事故。AI 特别爱顺便把这个文件也清理一下某次一份 MR 改了两千行评审人看到一半放弃最后只能拆 MR 重审。现在的做法是把一句话写进规则文件发现其他模块的问题只列出来不要动手。改动面约束的成本为零评审效率立刻回来。沉淀层把 AI 踩过的坑写回规则文件还有一种隐性成本容易被漏掉AI 踩过的坑下一个人还会再踩一遍。有人 review 时发现 AI 生成了一段早就废弃的 API 用法花了十分钟解释清楚半个月后另一个人的对话里同样的坑又出现一次。经验躺在一条 review 评论里MR 合并完就消失了。我们的做法是把坑写回AGENTS.mdreview 发现一个坑先判断它属于这个人手滑还是AI 默认就会这么错。后者就在禁止事项里加一行。规则文件本身走 Git 管理更新走 MR门槛设得很低改AGENTS.md的 MR 必须贴出对应的翻车实例两行字的 MR 当天就合。每条规则都有出处没人能把我觉得写进规则。这一步的传染性成本接近零下一次会话每个成员的 AI 都会自动加载更新后的规则文件那个错法不再出现——比开一次培训会便宜比下次注意可靠。反方向也要做每两周有人过一遍AGENTS.md删掉早就全部遵守和已经不适用的规则。规则文件会自然膨胀膨胀的文件稀释 AI 的注意力CI 的规则也会跟着变吵。我们有一段时间禁止事项涨到三十行AI 开始对中间部分打滑清理回十二行后才恢复。沉淀和删减是一枚硬币只沉淀不删规则文件会死掉。边界层人和 AI 的分工线画在哪跑了三个月之后团队不再问AI 能不能干这件事而是问这件事谁干、出了事谁负责。我们用了三条判断标准画线。标准一看可逆性。不可逆操作——生产库数据迁移、权限变更、删除长期分支、公共依赖升大版本——AI 可以产出完整的操作清单和回滚预案但执行要人逐条点。区分的原因在翻车成本可逆代码上的 AI 错误代价是重写几分钟不可逆操作上的错误代价是回滚加复盘。标准二看信息在不在上下文里。判断依据在代码库之外的事——需求是不是有歧义、该砍哪个功能、定价合不合理——AI 只能猜因为它的上下文是仓库和你贴的 prompt不包括上周三的产品会。这类事 AI 只出选项和利弊人拍板。标准三看责任能不能说清。任何要上线的代码必须能对应到团队里至少一个人他能完整讲出这段逻辑。如果线上出 bug这段合并代码的作者只有 AI没人能回答为什么这么写那就是红线。所以我们会把MR 作者能否讲清这段逻辑做成评审里的一道问答题。反过来AI 必须接手的是机械重复型工作样板代码、批量改名、生成测试数据、diff 初审。这类任务它的边际成本趋近于零出错率也不高。代码评审是典型的两边都做AI 做第一遍风格、明显 bug、缺测试人做第二遍业务正确性、安全边界安全敏感的改动不要只信一个 AI 的判断换第二个工具或人来交叉因为模型的安全知识有训练截止日期。落地清单团队明天就能开始的 7 件事 以下按落地顺序排列每条都是谁 做什么 产出物可以直接建成 checklist 执行。技术负责人当天在仓库根目录建AGENTS.md50 行以内——产出物规则文件第一版。一名前端 一名后端从最近的 review 记录里挑出 10 条AI 做错的事——产出物10 条负向规则当天合入。CI 负责人在流水线里加类型检查、lint、跑测试三道工序——产出物能拦截不合规代码的 CI配置可以让 AI 生成。任意两名成员用同一份规则文件让 AI 各自生成一个小需求的首版代码对比两份输出——产出物一页对比记录用于校准规则。每位 MR 作者合并前把 diff 交给第二个 AI 工具做初审——产出物初审意见附在 MR 描述里。团队负责人定每两周一次的规则文件清理机制轮值到人——产出物规则文件清理 MR。技术负责人挑一个不可逆操作如数据迁移在发布文档里写明AI 出清单、人执行——产出物写进发布 SOP 的边界层。这 7 条做完四层约束就齐了契约层决定代码长什么样流水线层决定每步谁卡口沉淀层决定坑不踩第二次边界层决定责任停在哪。AI 让每个工位变快而让团队速度真正叠加起来的是这四层。想了解更多细节仓库里的《Vibe Coding 代码质量保障》讲了审查维度怎么写《团队研发规范》是一份企业级版本的流水线层实践可以对照着读。【免费下载链接】ai-guide程序员鱼皮的 AI 资源大全 Vibe Coding 零基础教程分享 OpenClaw 保姆级教程、大模型玩法DeepSeek / GPT / Gemini / Claude / GLM、最新 AI 资讯、Prompt 提示词大全、AI 知识百科Agent Skills / RAG / MCP / A2A、AI 编程教程Harness Engineering、AI 工具用法Cursor / Claude Code / TRAE / Codex / Copilot、AI 开发框架教程Spring AI / LangChain、AI 产品变现指南帮你快速掌握 AI 技术走在时代前沿。本项目为开源文档 aiguide已升级为鱼皮 AI 导航网站项目地址: https://gitcode.com/GitHub_Trending/aig/ai-guide创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考