856a583325
override spike-first(创始人 06-23 裁),全栈铺 Phaser tier2 引擎。recon→契约→6模块并行→集成 workflow 产出 ~60 文件,全 6c6g 静态校验过、红线零碰 Tier0/1 产线: - 契约(6):tier2-source-project.schema / tier2-verdict.schema(fork·round放开·三层校验+富游戏门)/ toolkit 签名 / 探针钩子 / boot-phaser-host.d.ts / mini-肥鹅 fixture 规格 - M1 Phaser scaffold+装载 host+引擎能力面(19;logic-smoke 13/13:五耦合点真接线+赢输双路径+latch不回弹) - M2 CDP 探针 Phaser 重写+business-sim driver+九门+富游戏三门(5;verdict 过 schema) - M3 Python 单写 ReAct agent loop+9 工具 toolkit+M3 Anthropic接法+四熔断(9;mini-desktop 真 2.0.2 venv 验:import/9工具/中间件注册 OK) - M4 datatable schema+金标+资产占位(4)/ M5 prompt+Phaser skill+rag(13)/ M6 成本 RecordingChatModel+trace adapter(3) - 集成:run_engine.py 入口 + 接线断点已修 + RUN-ON-MINI-DESKTOP.md 待 mini-desktop 真跑(esbuild build + CDP 九门 + M3 生成 = 本质即 0号 spike)。AgentScope 2.0.2 API 逐条对 /root/oss/agentscope 源码核验。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.6 KiB
tier2 prompt 层（生成域三角色 system prompt 模板）
状态：建（tier2 待 0号 spike）· directional v1 · owner：tier2 引擎线（M5-prompt+skill+rag） 设计源：
docs/architecture/架构/生成引擎/tier2细节图说-E-能力面skills与prompt.md图 E3（prompt 两阶段角色）、图说-C 图 C1/C4（单写 ReAct）；契约tier2/contracts/toolkit-signatures.md（A7 九工具）、contracts/agent-loop/tier2-source-project.schema.json（A3 finish 形状）。
这层是什么
tier2 富游戏自治生成线把「模型该写成什么样、握着哪些工具、在哪个阶段写」沉淀成一组 system prompt 模板。它们是 prompt-as-asset：与代码解耦、单独可审、可随 spike 实证迭代，不把策略硬埋进 Python。
tier2/gen-worker/roles.py 是把这些模板装配进 AgentScope Agent(system_prompt=...) 的 Python 接缝（U2 已落）。本目录是这些模板的 规范文本来源（single source of truth）与设计说明：roles.py 里的字符串若与本目录漂移，以本目录为对账锚、roles.py 同步。
为什么 fork 自 wg1 studio.py 却 ≈ net-new
wg1 的 design/code/fix 三角色 prompt（wg1/gen-worker/worker/agent_loop/roles.py + prompt.py）是 LittleJS 单局几何小游戏 口径：gatespec/driver 二分、单文件 export default 工厂、从 markdown ```js 块抽代码、getEngine() 受控面。tier2 是 Phaser 多系统富游戏 + 多文件 src/ 工程 + agent 在 ReAct 循环内自调工具——这些约定全部反转，所以承袭的是「多角色 + 阶段分工」的范式骨架，prompt 正文按 Phaser 富游戏重写、工作量约等于全新写（图说-C 图 C4 蓝带）。
| 维度 | wg1（LittleJS 廉价线） | tier2（Phaser 富游戏线） |
|---|---|---|
| 生成阶段 | 单轮 ReActConfig(max_iters=1) + 外层 Python for repair |
Agent 内多轮 ReAct（max_iters 放开，建议单系统≤8/整局≤40） |
| 产物形态 | 单文件 export default 工厂源码（贴 ```js 块） |
多文件 src/ 真工程，agent 用 write_source 工具直接落文件 |
| 引擎接面 | getEngine() 受控面 + 五方法 |
Phaser 自掌帧 / scene 树自驱 / 无 render(g)（见 boot-phaser-host.d.ts） |
| 校验门 | 禁 import / 单 export default / 五方法 | 允许 import / 多文件结构 / esbuild 构建 + 九门 + 富游戏三门 |
| 终态上报 | latch（phase 焊死轮询） | latch（同范式，承袭） |
三个模板
| 文件 | 阶段 | 角色 | 作用 |
|---|---|---|---|
design-system.md |
阶段 1（工作室发散） | 设计 agent | 题面 → 富游戏设计稿（多系统 + 耦合点 + 数据表 + scene 树 + 语义 state） |
code-writer-system.md |
阶段 2（单写实现） | 单写 agent | 握九工具、ReAct 多轮自治写 Phaser 多文件工程，过验收门 |
fix-feedback.md |
阶段 2（修复轮） | 单写 agent（续轮） | 把门/玩家反馈摘成「该改哪」喂回循环（read_verdict 的回喂壳） |
阶段 1 设计 agent 在 AgentScope 2.0.2 部署态以 Agent Team 星形多 agent 发散（leader 拆意图 → AgentCreate 拉玩法/数值/UI worker → TeamSay 汇回收敛），design-system.md 是单个设计 worker / 单进程起步态的 system prompt。阶段 2 收敛到单写（防多 agent 写冲突，图说-E 图 E3 红框）。
占位符约定
模板用 {{占位符}} 标可注入字段，装配时由 roles.py 替换：
{{BRIEF}}—— 一句话题面 / 用户需求。{{DESIGN_TEXT}}—— 阶段 1 设计稿（阶段 2 实现依据；无则省略整段）。{{FIXTURE_HINT}}—— 可选品类/靶子约定（如 mini-肥鹅 三系统语义 state 约定），引导语义 state 导出与门对齐。{{PERSONA}}—— 玩家 agent 人格（L3 软检；player prompt 在 roles.py 内，本目录不重复，见player_system）。{{VERDICT_SUMMARY}}—— 失败门/findings 摘要（fix 回喂用）。{{PLAYER_PROBLEMS}}—— 玩家 agent 反馈的体验问题列表（fix 回喂用，可选）。
三条不许碰的铁律（与 toolkit-signatures A7 同源）
- agent 自调工具、绝不贴代码块：单写 agent 用
write_source直接落文件，不在回答里贴 ```js（与 Tier0/1 extract_code 范式反转）。 - finish 形状 = A3 源项目契约：
finish交付的 sourceProject 形状必须就是contracts/agent-loop/tier2-source-project.schema.json认的形状。 - 验收零自评：
run_gates的 verdict 由 judge 纯代码产出，agent 不给自己打分，只据门反馈改源（防 Goodhart）。