High-Quality Vibe Coding 是一个面向 AI 辅助编码的质量实践技能,目标是让 vibe coding 产出生产级代码,而不是垃圾代码。资料把开发者定位为架构师,把 AI 定位为构建者,强调纪律层:你负责架构、监督与判断,AI 负责写代码。
用途与适用场景
资料列出的适用场景包括:使用 AI 辅助开始新项目或新功能;为 AI 辅助开发工作流设置护栏;为 AI 生成的代码配置 CLAUDE.md、.cursor/rules、预提交钩子或 CI;教团队在不制造技术债的前提下使用 AI 编码工具;以及任何你发现自己在不理解 AI 输出却准备接受它的时候。
不适用场景包括:多人协作编码(资料建议使用 cooperative-vibe-coding)、构建 AI/LLM 应用(使用 ai-engineer)、非编码任务的提示工程(使用 prompt-engineer)、Git 工作流机制(使用 git-best-practices)、测试编写模式(使用 vitest-testing-patterns)。
三条法则
- 绝不接受你无法验证的东西。如果你不能测试、类型检查或视觉确认它,就不要合并。
- 始终小批量。一次一个函数、一个功能、一个修复,绝不要“把整个东西建出来”。LLM 在聚焦提示下表现最好。
- 护栏不可妥协。类型、检查器、格式化器、预提交钩子和测试要自动运行,而不是等你想起时才运行。
代码质量提示方法
资料给出有效提示公式:[CONTEXT] + [CONSTRAINT] + [EXAMPLE] + [TASK] + [VERIFICATION]。并强调“展示而非描述”:从代码库中给出一个示例,让 LLM 模仿,而不是用散文描述模式。提示规模方面:1-2 句话适合重命名、格式化等琐碎任务;3-8 句话适合大多数函数、组件任务;1-2 段适合范围清晰的复杂功能;整页以上收益递减且容易矛盾,几乎不应使用,应拆成更小任务。
先规划后构建
复杂任务前强制进入规划阶段,例如要求 AI 先给出要改的文件、需要的新文件、公共 API 签名、边界情况和测试计划,不写任何代码,由你审阅计划后再实现。资料提到在 Cursor 中可按 Shift+Tab 两次进入 Plan Mode,防止修改文件。这能消除最常见的失败:AI 快速而自信地建错东西。
验证层
资料按成本排序列出验证栈:类型检查器(tsc --strict)捕获类型错误与空值错误;检查器(ESLint、Biome)捕获风格违规与常见 bug;格式化器(Prettier、Biome)保证格式一致;单元测试(Vitest)捕获逻辑错误与回归;视觉检查捕获 UI bug 与布局问题;人工差异审查捕获设计缺陷与安全问题。最小可行验证命令为:tsc --noEmit && eslint . && vitest run,资料称可在 15 秒内捕获约 80% 的 AI 错误。
测试驱动与截图驱动
资料把 TDD 称为最高质量 AI 编码的最有效技术:测试即规格,先写测试就定义了“正确”的含义,AI 无法通过写验证错误行为的测试来作弊。工作流为:你写测试(或精确描述让 AI 写);AI 实现直到测试通过;你验证测试通过后审阅差异;对下一个行为重复。关键规则:如果 AI 同时写了测试和实现,要格外审查测试,因为 AI 会写“函数返回它返回的东西”而非“函数返回它应该返回的东西”的测试。对于 UI,资料推荐截图驱动开发:AI 构建组件,你渲染查看,不对则截图给 AI 并附反馈,循环直到视觉正确。
差异审查分级
资料建议:始终阅读安全代码、公共 API 表面、配置变更、被删除的代码;抽查实现逻辑、错误处理、资源管理;在测试通过的前提下信任格式化、导入顺序、变量重命名、样板代码。
接受/拒绝/优化框架
每段 AI 生成的代码都需要决策。决策树:类型检查不通过则拒绝并反馈错误;测试不通过则拒绝并反馈失败;没做要求的事则优化并澄清需求;方案不合理则优化并建议更好方案;不可维护则优化并简化;最后接受。拒绝适用于方案根本错误、添加不想要的依赖、修改任务范围外文件、幻觉 API、比问题所需更复杂。优化适用于方案对但细节错、缺少错误处理、命名不一致、测试覆盖不完整。接受适用于类型、检查器和测试通过,你理解架构(不必每一行),与代码库模式一致,抽查无问题。资料称健康的接受率是 60-80%,高于 90% 说明审查不足,低于 50% 说明提示需要改进。
何时重置与迭代
当 AI 已迭代 3 次以上仍未收敛、方案根本错误、或你已失去对代码行为的掌握时重置;当方案正确但细节有偏差、测试失败具体、AI 正朝正确方向收敛时迭代。启发式规则:如果第三条反馈消息比原始提示还长,就重置,因为你现在有更多上下文,新提示会比继续打补丁更好。
架构护栏
资料强调 TypeScript 严格模式不可妥协,给出 compilerOptions 示例,包括 strict、noUncheckedIndexedAccess、noImplicitReturns、noFallthroughCasesInSwitch、exactOptionalPropertyTypes。预提交钩子示例使用 husky 与 lint-staged,对 ts/tsx 文件运行 biome check --write 和 tsc-files --noEmit,对 json/md 运行 biome format --write。Claude Code 钩子示例在 PostToolUse 中对 Write|Edit 自动格式化文件,在 PreToolUse 中拦截 rm、git push --force、git reset --hard 等破坏性操作(exit 2 表示阻止)。
上下文管理
资料建议 CLAUDE.md 保持在 200 行以内,每行都问“删掉它会不会让 AI 犯错”,不会就删。模板包含项目概述、命令、代码约定、测试约定、要遵循的模式、禁止事项。Cursor 规则使用 .cursor/rules/*.mdc 文件并带 frontmatter,资料指出 .cursorrules 已弃用。项目结构本身也是上下文:命名清晰、分组相关文件、测试共置,AI 会从代码中学习。
迭代循环与上下文窗口
小任务使用紧循环:提示、生成、验证(类型+测试+视觉)、接受或反馈,约 30 秒一轮。功能开发使用结构化循环:规划(不写代码)、定义接口/类型、写测试、实现、视觉审查(如有 UI)、差异审查、提交。资料提醒对话变长后质量下降,约 70% 上下文时精度下降,85% 以上幻觉增加;应在不相关任务之间用 /clear,在 Cursor 中为新功能开新 Composer 会话,显式引用文件而不是依赖对话记忆,清理上下文前先总结进度。
工具特定模式
Claude Code:项目根目录设置 CLAUDE.md;配置钩子自动格式化并阻止破坏性操作;复杂任务前用 Plan mode(Shift+Tab 两次);不相关任务之间 /clear;利用权限模型在批准 Write/Edit/Bash 前审查提示;对安全操作(Read、Glob、Grep)授予 blanket 权限。Cursor:设置带作用域的 .mdc 规则文件;复杂任务前用 Plan Mode;Cmd+K 用于小型内联编辑;Composer 用于多文件修改并逐个审阅差异;后台代理用于独立任务,要发射后审查,而不是发射后不管。任何技术栈都应配置等价四支柱:严格类型 + 检查器 + 格式化器 + 测试,例如 Python 的 mypy --strict + ruff + pytest,Go 的编译器 + golangci-lint + go test。
反模式
资料列出多种反模式:YOLO 全接受(不验证就接受一切);巨型提示(一个提示要求整个功能,LLM 长输出会失去连贯性);剪贴板调试(把错误直接贴给 AI 说“修这个”,无上下文);无类型无测试无护栏;上下文失忆(没有 CLAUDE.md 或规则,AI 每次重新发明模式);过度委托(让 AI 做数百个你没审查的架构决策);忽视警告(认为“能跑就行”)。每种反模式都给出修复建议。
质量清单
会话前:CLAUDE.md 或 .cursor/rules 已记录约定;严格类型模式已启用;检查器与格式化器已配置运行;预提交钩子已安装;测试框架就绪且至少一个测试通过;关键模式有参考实现。会话中:超过 30 分钟工作量的任务先规划;小批量;每次生成后验证;安全敏感代码和公共 API 做差异审查;所有 UI 变更做视觉检查;不相关任务之间 /clear。资料在“会话后”部分被截断,未提供完整内容。