45 min · 产出一份设计文档(六件套逐件决策)· 下一课按图实现
🎒 预备知识:完成上一课「L18」(零基础入口:第 0 课)
新手写设计文档的通病:三千字散文,读的人找不到决策在哪。决策卡格式强制你把 选项、选择、理由三件事写在一行——它的隐藏价值是"一句话测试": 如果一个决策的理由说不成一句话,说明你自己还没想清楚。 六张卡 = 六个强制想清楚的关口。另外每张卡都有"默认答案"(Easel 的选择)—— 先抄默认再偏离是工程决策的正道:偏离默认的人必须能说出理由, 抄默认的人不需要理由。
| # | 构造块 | 决策点 | Easel 的答案(参考) | 我的选择 |
|---|---|---|---|---|
| 1 | Harness | 自研 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 · 分工线
选项:a) 全给模型(prompt 里写流程,模型直接调浏览器)
b) 全给脚本(连文案都模板生成)
c) 碰环境的归脚本,决策归模型
选择:c
理由:模型会软失败且数不清字数(L5/L2),但只有它能理解需求写文案;
脚本确定可测但不会创作——各干各的强项。
边界实例:字数校验=脚本;"这条笔记面向谁写"=模型。
注意这份卡的信息密度:有选项(说明考虑过 alternatives)、有理由(引用了课程机理)、 有边界实例(把抽象分工落到具体判断)。你的六张卡都应该有这个密度—— 尤其"边界实例",它是最能暴露"以为想清楚了其实没有"的地方。
① 你的 agent 最重要的不可逆操作是什么?它的证据链在哪张卡上?
② 你的常驻 token 预算是多少?哪些内容必须按需加载?
③ 如果明天模型供应商倒闭换 provider,你的设计里哪几张卡要重写?
(好答案:最多一张。模型相关的只有卡 1 的 provider 选择——六件套的其他五件都该是
provider 无关的。如果你的卡 3、卡 5 也要重写,说明业务资产长在 harness 上了,A17 坑 3。)
目标 200–300 行:单文件 Python、OpenAI 兼容 API、2-3 个工具、1 个技能目录、1 个出站闸门。 约束是设计工具——写不进 300 行的设计是过度设计。 自检清单:你的六张卡里有没有"先做通用框架"?删掉——300 行只够做一个具体场景。 Easel 自己也是从具体场景长出来的(先有发布,后有 114 技能)。
坑 1:六张卡全偏离默认。每张都自创 = 六个未验证的新想法同时上马—— 失败了你不知道是哪张卡的锅。坑 2:卡与卡不自洽。选了技能目录(卡 3)却设计了 50 个函数工具;选了分域记忆(卡 5)却在卡 2 写全局记忆文件——卡要互查。坑 3: 安全卡留白。"边界以后再加"——A12 讲过,注入面第一天就在。坑 4: 卡里只有结论没有边界实例。抽象的"分工给脚本"没有落地——每张卡配一个具体判断案例。
把六张决策卡(含"为什么"+ 至少一张带边界实例)发给我评审。我重点看:每张卡的"为什么" 是否一句话能说清、卡与卡之间是否自洽、边界实例是否真的具体。
参考:六件套速查 的"关键构造决策"表——默认答案都在。