管教 AI 写代码的「八荣八耻」——拆解一份被塞进 Claude Code 的提示词清单

原视频：勋荣 ·《AI 编程八荣八耻，太有才了》

作者：勋荣｜时长：约 29 秒｜类型：工具/提示词安利（口播极短，干货全在屏幕上那张文档截图里） 拆解材料：SenseVoice 逐字稿（作者口播）+ 视频逐帧识图读屏 + GitHub 原文核对（2025Emma/vibe-coding-cn、langbot-app/LangBot 的 AGENTS.md）。屏幕上那份文档恰好 764 字节，与 GitHub 原文 逐字节一致——下面贴的就是一字不差的原文。

一句话定性

这不是一条”教程”，而是一条 29 秒的提示词安利：作者把一份在社区流传的《Claude Code 八荣八耻》文档怼到镜头前，反复念叨”太有才了""放进你的 Claude Code 或者放进 Cursor 里，效果非常好”。

它真正值钱的不是这条视频，而是它安利的那 764 个字节——一份用”八荣八耻”句式压缩的 AI 编程行为公约。它精准命中了 vibe coding（放手让 AI 写代码）里最高频的六个翻车点，一句一个、好记好抄，所以才被 LangBot 这类正经开源项目直接抄进了 AGENTS.md。

作者口播没有任何讲解（逐字稿大意就是”这谁写的太牛了，给你点个大拇哥”），全部干货都在屏幕那张截图里。所以这篇拆解的重点不是复述视频，而是把那 8 条原文捞出来、逐条翻译成”它到底在治 AI 的什么病”。

先把原文一字不差摆出来

下面这份就是视频里那张截图的完整内容，已与 GitHub 原文逐字节核对（标题 + 8 条荣辱对照 + 8 条白话行动版，正好 764 字节）：

Claude Code 八荣八耻

  • 以瞎猜接口为耻，以认真查询为荣。

  • 以模糊执行为耻，以寻求确认为荣。

  • 以臆想业务为耻，以人类确认为荣。

  • 以创造接口为耻，以复用现有为荣。

  • 以跳过验证为耻，以主动测试为荣。

  • 以破坏架构为耻，以遵循规范为荣。

  • 以假装理解为耻，以诚实无知为荣。

  • 以盲目修改为耻，以谨慎重构为荣。

  1. 不猜接口，先查文档。
  2. 不糊里糊涂干活，先把边界问清。
  3. 不臆想业务，先跟人类对齐需求并留痕。
  4. 不造新接口，先复用已有。
  5. 不跳过验证，先写用例再跑。
  6. 不动架构红线，先守规范。
  7. 不装懂，坦白不会。
  8. 不盲改，谨慎重构。

上半截是”价值观”（朗朗上口、立人设），下半截是同样 8 条的”可执行版”（落到动作）。两截一一对应，是同一件事的”口号”和”做法”。

逐条白话解读：每条在治 AI 的什么病

下面把 8 条逐一翻译成 Claude Code / vibe coding 里你真会踩的坑。

一、以瞎猜接口为耻，以认真查询为荣

治的病——API 幻觉。 这是 AI 写代码头号翻车点：你让它调某个库，它凭印象编一个 client.fetchUser()，结果库里压根没这方法，一跑就 AttributeError。或者它瞎猜你项目里某个函数的参数顺序、返回结构。

正确姿势：先查再写。 Claude Code 手里的 Read/Grep 工具就是干这个的——动手前先 grep 真实签名、翻一眼文档，而不是”我觉得应该是这样”。一条规则省掉一半的”跑起来才发现方法不存在”。

二、以模糊执行为耻，以寻求确认为荣

治的病——需求没对齐就闷头干。 你扔一句”帮我加个登录功能”，AI 不问就开干，做出来的跟你脑子里想的差十万八千里，返工重来。

正确姿势：边界不清，先问一句。 vibe coding 里最省时间的动作，往往是开工前那 30 秒澄清——“要邮箱登录还是手机号？要不要记住登录态？“问清楚再写，比写完推倒重来快得多。

三、以臆想业务为耻，以人类确认为荣

治的病——脑补业务规则。 “用户余额不足该怎么处理？“AI 不会承认自己不知道，它会自作主张假设一套逻辑写进去——可你的业务是另一套。技术能推断的是代码，推断不出来的是业务。

正确姿势：业务规则必须人类确认，而且留痕。 “留痕”是这条的精髓——把确认下来的规则写进文档/注释，不然换个会话 AI 又从零脑补、又跑偏一次。

四、以创造接口为耻，以复用现有为荣

治的病——重复造轮子。 项目里明明已经有 formatDate()，AI 没看见，又造一个 dateToString()；久而久之同一件事三四种写法，代码库越滚越臃肿。

正确姿势：先搜有没有现成的，再决定要不要新写。 这正是 Claude Code 的核心准则”写得像周围的代码”（match the surrounding code）——复用既有约定，而不是每次都发明一套自己的。

五、以跳过验证为耻，以主动测试为荣

治的病——改完不跑就说”完成了”。 这是 vibe coding 翻车率最高的一环：AI 信誓旦旦”已完成 ✅“，你一运行，报错。它根本没执行过。

正确姿势：改完自己先跑一遍，能写用例就写。 一句话——“测了才能说 done”。让 AI 把”运行验证”当成交付的一部分，而不是把验证甩给你。

六、以破坏架构为耻，以遵循规范为荣

治的病——小改动引爆大重构。 你让它修个小 bug，它顺手把整个模块重写了、改了目录结构、换了状态管理方案——一个三行的改动，diff 出来三百行。

正确姿势：守住架构红线，按既定规范来。 白话版说得更狠——“不动架构红线”。让 AI 明白：没让你重构就别擅自”优化”，改动范围要克制。

七、以假装理解为耻，以诚实无知为荣

治的病——不懂装懂。 AI 给你一本正经的错答案，比直接说”我不确定”危害大得多——因为它说得太自信，你会信，然后被带进坑里。

正确姿势：不确定就说不确定。 “诚实无知”远胜”自信胡说”。这一条治的不是某个具体操作，而是 AI 的”嘴硬”——宁可它说”这块我没把握，你确认下”，也别要一个糊弄你的漂亮答案。

八、以盲目修改为耻，以谨慎重构为荣

治的病——大刀阔斧瞎改。 AI 一看到代码就手痒想全改，改完测试全红、想回滚都理不清动了哪些地方。

正确姿势：小步、谨慎、可回退地重构。 跟第六条呼应但更进一层——第六条管”别越界”，这条管”就算该改，也要稳着改”：一次只动一块、改一处验一处，而不是推倒重来。

为什么这套东西火，以及怎么用

为什么火？ 因为它把 vibe coding 六个最高频的痛点——幻觉 API、不问就干、脑补业务、重复造轮子、不验证、乱重构——用”八荣八耻”这种中国人骨子里熟悉的句式压成了八句口诀。好记、好念、好抄，复制粘贴就能用，门槛几乎为零。

怎么用？ 就像视频里说的”放进你的 Claude Code 或者放进 Cursor 里”——把这段塞进项目根目录的规则文件：

  • Claude Code → CLAUDE.md（或 AGENTS.md）
  • Cursor → .cursorrules
  • Gemini CLI → GEMINI.md
  • 其它 Agent 类工具 → 各自的系统提示词/规则文件

放进去之后，它就成了每次对话都生效的系统级约束，不用你每轮重复叮嘱。建议放在规则文件里”核心原则 / Core Principles”那一节，跟你项目自己的红线并列。

诚实附注：它能治什么，治不了什么

来源。 这份”八荣八耻”是社区集体智慧，最早在知乎/GitHub 流传，现已被 langbot-app/LangBot、2025Emma/vibe-coding-cn 等一批开源项目收进 AGENTS.md。抖音作者「勋荣」是搬运安利、不是原创——他做的事是帮它扩散，本文也算其一。

它是”提示词”，不是”保险”。 八荣八耻是软约束：它把 AI 往对的方向引，能显著降低翻车率，但不能 100% 消灭幻觉。AI 仍可能在某次回答里把这八条全忘了。

真正的护栏，还得靠工程手段兜底——让 AI 真的去 Read/Grep 而不是嘴上说查、改完跑测试、改动走 code review、关键逻辑写断言。八荣八耻负责”教 AI 想对”，工程纪律负责”逼 AI 做对”，两者叠加才稳。换句话说：这八句值得贴进每个项目，但贴完了，你还是得验。