EP2. 未经审视的代码,不值得生成
📢 宣言:停止不假思索地写代码
上一集我们确立了一点:人们使用同样的 AI,结果分化——不是因为模型——而是因为用户态度。
若要把总监 B 的立场压缩成一句话,会是什么?本集从一句贯穿全系列的宣言开始——它可能改变你与 AI 协作的方式。
一句话贯穿整个系列。
「未经审视的代码,不值得生成。」
若哲学课没睡过去,你可能听出苏格拉底的回响:「未经审视的人生,不值得过。」 正如缺乏不断追问的人生没有意义,你不理解、未审视的 AI 产出也没有价值。
💡 等等——「代码」不只是源代码!
「可我不是开发者——我用 AI 写报告和幻灯片。」 请别走开。在 Cocrates 里,「Code」 是更广的概念。
在 Cocrates 中,「Code」 指你用 AI 要创造的每一份最终交付物。
- 💻 源代码(当然)
- 📝 报告与文档
- 📊 演示与幻灯片
- 📚 博客系列(就像你现在读的这篇!)
- 🧠 学习笔记与摘要
换言之,你最终让 AI 产出的一切都是「Code」。
AI 产出往往趋向平均——谁都能用的那种。它很少 100% 反映你的具体情境与上下文。不经审视就复制粘贴这份平均——等于把交付物的完全控制权交回给 AI。
🛠️ 为何架构重要——以博客为例
我们不会一次到位产出最终「Code」。我们先设计扎实的架构,审视并批准,再填充实质。
这篇博客系列也是这样诞生的。
[Step 1] Design the series overview (overview.md) ➡️ Review & approve 🔍
⬇️ (Use this structure as the basis for the next step)
[Step 2] Design each episode outline (outline.md) ➡️ Review & approve 🔍
⬇️ (Use this structure as the basis for the next step)
[Step 3] Write detailed episode plans (episodes.md) ➡️ Review & approve 🔍
⬇️ (Use this structure as the basis for the next step)
[Step 4] Generate the episode body readers will see ➡️ Review & approve 🔍
Cocrates 就是这样工作的。它不会先倾倒正文或代码。每一步都先搭骨架,你审查批准,然后才成为下一步的坚实基础。
🤔 审视究竟意味着什么
我们常把审查当成扫一眼错别字和错误。Cocrates 要求更严格。
审视 = 理解 + 判断 + 批准
- 1. 理解: 看到 AI 产出心想*「哦,懂了」*不算理解。当你能用自己的话解释为何选这种架构而非其他方案时,才算理解。
- 2. 判断: 在此基础上决定*「这真的是最好的吗?」* 这架构是否契合项目的性能与目标?没有判断的认同只是空点头。
- 3. 批准: 最后,你掌舵宣布:「我检查过了——就按这个来。这份交付物我负责。」 只有这时,AI 的外壳才变成你的交付物。
审视的终极目标是驾驭无知——清楚知道自己不知道什么,并填补缺口。成长就在那里。
🦉 Cocrates Harness 设定节奏
Cocrates Harness 是严格(但关怀)的配速员。它不会让你跳过审视、仓促前进。
👤 用户:「唉,随便拼个登录模块吧!」 🦉 Cocrates:「未经审视的产出不值得生成。我们先一起设计架构好吗?」
起初那些问题可能让人烦。「别的 AI 直接给代码——为啥问这么多?」
请记住:花一小时审查架构,能省下一周通宵改 bug。 Cocrates 不是答案贩卖机——是帮你成为有主导权总监的护栏。
📌 要点回顾
- 核心原则: 「未经审视的代码,不值得生成。」 不经审视的生成没有意义。
- 扩展的「Code」: 不只是源代码——报告、幻灯片及 AI 产出的一切都要审视。
- 审视三步: 不是随便读读——理解 → 判断 → 批准。
- 驾驭无知: 成长来自通过审视发现并填补你不知道的东西。
🎬 下期预告
你理解了这套哲学。也许在想,「好吧——我会做会审视的开发者。」
该行动了。Cocrates Harness 在你的开发环境中以 opencode 插件运行。安装比你想的简单。
下一集:在你的机器上安装 Cocrates Harness,开始第一次对话——动手实操。真正的旅程从那里开始。🚀
本系列介绍 Cocrates Harness 框架。Cocrates 是为苏格拉底式对话设计的 agent harness,使用户保留主导权并持续成长。