M7 输出 · L19

毕业蓝图:六件套设计工作表

45 min · 产出一份设计文档(六件套逐件决策)· 下一课按图实现

🎒 预备知识:完成上一课「L18」(零基础入口:第 0 课)

本课唯一结论:读别人一万行,不如为自己的 agent 写对六张决策卡。 每件套只需回答:选项有哪些 → 我选什么 → 为什么(一句话能说清的为什么)。

一、基础:设计文档为什么要"卡"而不要"文"

新手写设计文档的通病:三千字散文,读的人找不到决策在哪。决策卡格式强制你把 选项、选择、理由三件事写在一行——它的隐藏价值是"一句话测试": 如果一个决策的理由说不成一句话,说明你自己还没想清楚。 六张卡 = 六个强制想清楚的关口。另外每张卡都有"默认答案"(Easel 的选择)—— 先抄默认再偏离是工程决策的正道:偏离默认的人必须能说出理由, 抄默认的人不需要理由。

二、六张决策卡模板(逐张填写)

#构造块决策点Easel 的答案(参考)我的选择
1Harness自研 loop 还是复用?复用 OpenClaw____
2提示词栈几层?各层写什么/不写什么?SOUL/AGENTS/CONTEXT/SKILL 四层____
3能力系统函数工具还是技能目录?路由靠什么?技能目录 + frontmatter 路由____
4分工线哪些固化给脚本?碰环境的全给脚本____
5记忆状态作用域多大?怎么持久化?画像分域 + jsonl 追加____
6安全边界什么硬拦?什么只提醒?对账怎么做?exit7 闸门 + dry-run + readback____

每张卡的决策依据都在课程里:卡 1 看 A17 四问、卡 2 看 A5/L04、 卡 3 看 A2/L06 的 token 算术、卡 4 看 L07 短板互补与 A4 工具设计、 卡 5 看 A6 串味推演、卡 6 看 A12 阶梯 + L14 证据链。这门课的全部内容就是这六张卡的论据库。

三、示范:填好的一张卡长什么样(以卡 4 为例)

卡 4 · 分工线
选项:a) 全给模型(prompt 里写流程,模型直接调浏览器)
     b) 全给脚本(连文案都模板生成)
     c) 碰环境的归脚本,决策归模型
选择:c
理由:模型会软失败且数不清字数(L5/L2),但只有它能理解需求写文案;
     脚本确定可测但不会创作——各干各的强项。
边界实例:字数校验=脚本;"这条笔记面向谁写"=模型。

注意这份卡的信息密度:有选项(说明考虑过 alternatives)、有理由(引用了课程机理)、 有边界实例(把抽象分工落到具体判断)。你的六张卡都应该有这个密度—— 尤其"边界实例",它是最能暴露"以为想清楚了其实没有"的地方。

四、三个校准问题(填完自问)

① 你的 agent 最重要的不可逆操作是什么?它的证据链在哪张卡上?
② 你的常驻 token 预算是多少?哪些内容必须按需加载?
③ 如果明天模型供应商倒闭换 provider,你的设计里哪几张卡要重写?
(好答案:最多一张。模型相关的只有卡 1 的 provider 选择——六件套的其他五件都该是 provider 无关的。如果你的卡 3、卡 5 也要重写,说明业务资产长在 harness 上了,A17 坑 3。)

五、规模约束(为 L20 实现预留)

目标 200–300 行:单文件 Python、OpenAI 兼容 API、2-3 个工具、1 个技能目录、1 个出站闸门。 约束是设计工具——写不进 300 行的设计是过度设计。 自检清单:你的六张卡里有没有"先做通用框架"?删掉——300 行只够做一个具体场景。 Easel 自己也是从具体场景长出来的(先有发布,后有 114 技能)。

六、常见踩坑

坑 1:六张卡全偏离默认。每张都自创 = 六个未验证的新想法同时上马—— 失败了你不知道是哪张卡的锅。坑 2:卡与卡不自洽。选了技能目录(卡 3)却设计了 50 个函数工具;选了分域记忆(卡 5)却在卡 2 写全局记忆文件——卡要互查。坑 3: 安全卡留白。"边界以后再加"——A12 讲过,注入面第一天就在。坑 4: 卡里只有结论没有边界实例。抽象的"分工给脚本"没有落地——每张卡配一个具体判断案例。

七、检索练习

八、出口检验

把六张决策卡(含"为什么"+ 至少一张带边界实例)发给我评审。我重点看:每张卡的"为什么" 是否一句话能说清、卡与卡之间是否自洽、边界实例是否真的具体。

参考:六件套速查 的"关键构造决策"表——默认答案都在。