From c7811c7dfa8f57cf87444a71cd4cb5931fdf7e1f Mon Sep 17 00:00:00 2001 From: lili Date: Mon, 29 Jun 2026 10:45:31 -0700 Subject: [PATCH] =?UTF-8?q?docs(knowledge):=20tech-decisions=20=C2=A75.1?= =?UTF-8?q?=20=E8=92=B8=E9=A6=8F=E9=98=B6=E6=AE=B5=E4=B8=80B=E8=90=BD?= =?UTF-8?q?=E5=9C=B0=20=E2=80=94=E2=80=94=20=E6=96=B9=E5=90=91=E2=91=A0?= =?UTF-8?q?=E5=90=91=E6=AF=8D=E8=AF=AD=E5=AF=B9=E9=BD=90=E5=85=A8=E5=AE=8C?= =?UTF-8?q?=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 把"降AI参与方向①(插件API向母语直觉对齐)"的落地写回 tech-decisions §5.1(该节正是 drawButton 等改签名的方向源):附A 15处签名 #1-#15 全完成 + 正交泛型门修(save.get 误杀) + 减摩擦端到端见效(打地鼠+save 从失败→一次过九门/¥0.64/不thrash),2a20e5e7→2be7b718 13提交。 剩:补密度(阶段一C)+ 扩模板(数据点门控)。 Co-Authored-By: Claude Opus 4.8 (1M context) --- .agents/knowledge/tech-decisions.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.agents/knowledge/tech-decisions.md b/.agents/knowledge/tech-decisions.md index 3e9ed12d..c061f809 100644 --- a/.agents/knowledge/tech-decisions.md +++ b/.agents/knowledge/tech-decisions.md @@ -129,6 +129,8 @@ W-G1 实证后创始人亲玩校准拍定：**生产环无 Claude**，质量由* ⚠️ **方向修正(2026-06-29 创始人纠正,推翻"换母语"初判)**:便宜档按 SoT 定位是"AI 参与深度低的高质游戏"(轻量≠简单,见运行时 SoT §一/§4.1),**不是简单玩具**;L2 插件库是"降 AI 参与=便宜+高质"的核心载体、**不是"税"**。"换母语扔插件"会让 AI 从头写整个游戏 = **升** AI 参与,与便宜档"降 AI 参与"的核心策略正相反,故推翻。本实验测的点击得分恰是产品不做的简单玩具、对象本身无产品意义——它留下的真发现是:**当前 AI 在方言里写 game-logic.js 时,学插件 API 形状的摩擦极大(drawButton 当返按钮对象、define 想批量都是按母语直觉猜错;9 步 358K),"降 AI 参与"的设计意图没兑现**。修正方向(创始人方向 3,分阶段)= ① 保留插件库,让**插件 API 向模型母语直觉对齐**(drawButton 真返按钮对象、define 批量,消除"按直觉写就错"的坑)+ RAG/few-shot/skill 补 API 密度,把学习摩擦降到接近母语;② 扩玩法模板与工程脚手架覆盖,缩小 AI 自由写的面。地基(确定性受控面 + 九门)仍是护城河。详见 [`../../docs/agent-specs/2026-06-28-母语vs方言-生成对照实验-evidence.md`](../../docs/agent-specs/2026-06-28-母语vs方言-生成对照实验-evidence.md),它给 [`../../docs/agent-specs/2026-06-20-生成设计合理性-对抗审查裁决.md`](../../docs/agent-specs/2026-06-20-生成设计合理性-对抗审查裁决.md) 的"表现力硬编码"补量化证据。 +✅ **落地(2026-06-29 阶段一B 改签名)**:方向①「插件 API 向母语直觉对齐」已全部完成——附 A 15 处可改签名 #1-#15 逐插件改逐插件验:drawButton 返命中矩形(#5,治"误把 void 当返回值"#1 翻车点根因)、sessionScore.add / juice.burst / gamefeel 工厂(免 new)、collision·physics 几何挂实例、Aabb 兼收 {x,y,w,h}(#12)、**ctx.random()·ctx.time() 可调用 + 保留方法双 API**(#1,单点 buildContext 包装、框架内部不破)、audioMusic 语义音名、timer·scene·juice.render doc 钉死。另修一个正交真 bug:check 的 API 静态门方法名正则漏认泛型声明 `get(`、把真实存在的 `save.get` 误判不存在、误杀一整类带存档游戏(`851b86fe`)。`2a20e5e7`→`2be7b718` 共 13 提交,每处单元+确定性验、各插件测试绿、双源 prompt 一致、形状门 11/11 不破。**减摩擦端到端见效**:改签名前栽在 save.get 泛型门 bug 的打地鼠+高分游戏(2 attempts/¥6.69/失败),改后**一次过九门、¥0.64/209s、不 thrash**。剩:方向①的补密度(阶段一C few-shot/RAG)+ 方向②扩模板(数据点门控)。详见 [`../../docs/agent-specs/2026-06-29-便宜档降AI参与-减摩擦与扩模板覆盖-设计.md`](../../docs/agent-specs/2026-06-29-便宜档降AI参与-减摩擦与扩模板覆盖-设计.md)。 + ## 6. 决策落地的关键工程参数（供选型校验，技术决策版 §4/§7） - **AI 生成**：生成任务状态机 queued→running→succeeded/failed/timed_out/canceled；超时 120s；失败重试 ≤2 次、超时重试 ≤1 次；队列最大积压 500（超则返回 429）；P50<60s、P95<180s。