跳到主要内容

EP10. 架构驱动生成活动

🏛️ 与「直接写」黑箱分手

「写一份报告。」

最新模型几秒内吐出几十页看似合理的内容——标题、大纲、正文。细读却摇头:逻辑跳跃、深浅不一、缺少清晰主线。「再长一点」 只加篇幅,不加满足感。

若苏格拉底式学习训练元认知,Cocrates 第二主轴——制品生成——从设计上阻断无脑生成。Cocrates 很明确:好制品只来自扎实架构——架构是一套人的决策


🏗️ 「直接写」的真正含义:随便写

不问就垒砖的建筑师,会造出浴室窗对着客厅的房子。无结构生成是同样的赌局。

无架构输出滋生三个致命问题:

  • 逻辑与一致性崩塌: AI 写「像真的下一句」——不是连贯整体。章节彼此打架。
  • 问责丢失: 有人问 「为何是这个流程?」 你答不上——架构是 AI 选的,不是你。
  • 不可审的黑箱: 没有蓝图就无法核验——只剩 「读起来顺不顺?」

🔍 ASR:把模糊架构具象化

「先设计架构——听起来对,但设计什么?」

Cocrates 用 ASR(Architecturally Significant Requirement,架构显著需求)——会实质改变构成、质量与交付的约束。

  • 报告 ASR: 「受众是 C 级高管」 → 摘要密度、结论先行结构。
  • 演示 ASR: 「正好 10 分钟」 → 页数、核心信息上限。
  • 技术博客 ASR: 「初级开发者」 → 术语解释深度、类比比例。

跳过显式 ASR,AI 用沉默默认值填空——你没批准过的 「够合理」 选择。不标出易碎处(ASR)就动工,等于在玻璃杯上摞书。


🏡 四层——像盖房子

[Identify concerns / ASR] → [ADR: alternatives & decision] → [Spec: integrated blueprint] → [Generation & Verification]

  • 1. Concern / ASR: 露出大结构分叉——单层还是两层、坡顶还是露台。
  • 2. ADR(Any Decision Record): 对委托区域列出 2–3 个真实选项与权衡;用户拍板;留下审计轨迹。
  • 3. Spec: 把已批需求与 ADR 合成一份自洽蓝图——不必重读整段对话就能开工。
  • 4. Generation & Verification: 只从已批 Spec 生成,不从首条提示词。再逐项核验——揪出 AI 偷塞的未记录 ASR

📝 三行摘要

  1. 「直接写」=「随便写」。 无架构生成是不可控黑箱。
  2. 打破沉默默认值。 识别 ASR;动工前先跑 ADR。
  3. Cocrates 不边缘化人。 每一步——你审、你决、你批。蓝图归你。

🎬 下期预告

为何要有架构流水线,已讲完。下一集:四个专精技能——adr-writingspec-writingspec-driven-generationspec-driven-verification——内部模板与硬规则。

「动笔前先挤出架构。架构稳,内容就不晃。」


本系列介绍 Cocrates Harness 框架。Cocrates 是为苏格拉底式对话设计的智能体 Harness,让用户保持主体性并持续成长。