AI 写完代码,你真的看懂了吗?AntiVibe 想解决一个被忽视的效率陷阱

AI 写完代码,你真的看懂了吗?AntiVibe 想解决一个被忽视的效率陷阱


用 Claude Code 写代码,体验过的人都承认:太快了。几秒钟,一两百行代码就出来了,功能看似完整,逻辑看似合理。但问题也在这里——代码出来得越快,你花时间理解它的机会就越少。Ctrl+A、Ctrl+C、Ctrl+V,一气呵成,AI 说了什么、为什么这么写、有没有你没注意到的坑,根本没来得及看。

这不是某个人的问题。这是整个 AI 编程范式的结构性问题。

mohi-devhub/antivibe(761 ⭐,45 Fork,MIT License)做的事情很直接:给 Claude Code 加一个 Skill,在 AI 写完代码之后,把它变成一份可读的学习材料——不是代码摘要,而是带上下文、带设计理由、带替代方案的那种。

它到底干了什么

AntiVibe 的核心是一个 Claude Code Skill,安装到 ~/.claude/skills/antivibe 目录之后,你在任何项目里都可以调用它。

调用的方式很自然:

/antivibe
/antivibe full
"deep dive"
"walk me through src/auth/"
"audit this, just the trade-offs"

它会扫描指定代码,然后在你项目的 deep-dive/ 目录下生成一份 Markdown 文档。compact 模式(默认)输出代码概览、关键组件和核心概念;full 模式额外加上逐行walkthrough、每个概念的先修知识、以及精心挑选的学习资源链接。

这里有个细节值得注意:它不需要 git 历史,不需要代码是 AI 生成的。任意代码——新写的、遗留的、任何语言的——都可以丢给它分析。Issue 区有人在讨论”Kernal integration for knowledge graph”,说明作者在思考把代码理解和知识图谱结合起来,这是更长远的方向。

三种深度,总有一款适合你

这是 AntiVibe 设计得比较聪明的地方。它不是把所有东西都塞给你,而是分了层级:

junior 模式:类比解释、术语定义、全代码片段加行内注释,适合刚学编程不久、连设计模式都没接触过的人。

mid 模式:跳过基础知识,专注设计决策和权衡取舍,代码片段只引用不展开。这是大多数有经验的开发者会用到的层级。

senior 模式:路由到专门的 Auditor Agent,不再解释什么是 JWT,直接告诉你”JWT 是无状态的——过期前撤销需要一个 denylist,而这段代码没实现”。500 字以内,信号密度极高,没有任何废话。

这种分层不是噱头。你真的可以根据自己的水平选择合适的输出,不需要 AI 每次都从头解释一遍你已经懂的东西。

适合谁,不适合谁

AntiVibe 不是银弹。在决定要不要用之前,你需要清楚它的边界。

适合这些场景:

  • 接手一个没有注释的遗留项目,想快速搞清楚架构思路
  • AI 刚跑完一个功能,你想确认它有没有埋坑
  • 想学习一个你没写过的模块的设计逻辑
  • 团队 code review 之前,自己先过一遍关键路径

不适合这些场景:

  • 你希望它帮你写代码——它不写,只解释
  • 你的代码库超过 5 个文件且想要 full 模式深度分析——compact 模式限制 5 个文件,full 模式没有这个限制但 token 消耗会很大
  • 追求实时性——它生成的是离线文档,不是交互式对话

实际用起来是什么体验

举一个具体的场景:你在做一个电商后端,Claude Code 帮你生成了一个 JWT 认证模块。跑完 /antivibe full,你会在 deep-dive/auth-system-2026-08-03.md 里看到:

## Concepts Explained
### JWT (JSON Web Tokens)
- What: Stateless authentication tokens...
- Why: Server doesn't need to store sessions...
- When: APIs, SPAs, microservices...
- Prerequisites: HTTP request/response, Base64 encoding, cryptographic signing

## Learning Resources
- [JWT.io](https://jwt.io): Official documentation
- [Auth0 Guide](https://auth0.com/blog): Best practices

这个输出格式是固定的——Overview、Key Components、Concepts、Resources(full 模式)。你可以自己配置 known_concepts 列表,把你熟悉的东西跳过去,不浪费 token。

另外,它还支持 auto-trigger 钩子。在 .claude/hooks.json 里配置 SubagentStopStop 钩子,可以在任务完成或会话结束时自动触发深度分析。对于习惯每次做完功能都要复盘的人来说,这是一个省力的自动化。

现在可以做的事

如果你心动,以下是可执行的步骤:

第一步(2 分钟): 把 Skill 装上,看看效果

git clone https://github.com/mohi-devhub/antivibe.git
cp -r antivibe ~/.claude/skills/antivibe

在任意 Claude Code 项目里跑一次 /antivibe,在 deep-dive/ 目录下看输出。

第二步(5 分钟): 用 senior 模式审计一段你最近写的或接手的关键代码

"audit this, just the trade-offs"

对比你自己对代码的理解和 AI 审计出来的结论,看有没有遗漏。

第三步: 如果你在带团队,考虑在 code review 流程里引入这个工具。AI 生成代码 + AntiVibe 审计 + human review,是一个比直接信任 AI 输出更稳妥的链路。

值得关注的周边: GitHub Issue 区有人在讨论与 Kernal(知识图谱工具)的集成,以及把 AntiVibe 扩展为 active support/mentor 模式。如果这些方向成熟,它的价值会更大。


最后说一句:AI 编程工具越来越强,但有一个隐性风险正在积累——开发者越来越习惯”接受代码”而不是”理解代码”。技术债不只是代码里的,技术债也是你脑袋里对系统理解的那块空白。AntiVibe 做的事,就是把那块空白填上。

GitHub 仓库:https://github.com/mohi-devhub/antivibe

评论区

0 条评论

登录后可评论。

拾光·开源拾遗 12 阅读