aetherbound-guild/.agent-taskgraph/spec.md

Execution Spec: P9.1 Arbitrary-Party Complete First Session

Status: FROZEN Requested: 2026-08-13 Frozen by: Owner / 2026-08-13 Revision: p9.1-spec-r2

本批要回答的问题

P9.0R10 允许玩家从四人中任意选择两人，并让全部六种无序组合完成前两战。 但旧 R5-R7 只完整支持常规“前排 + 远程/治疗”结构。P9.1 必须让每一种合法 双人组合都完成同一条可理解、有取舍、有因果结果的首局。

冻结玩家链路

每一种双人组合都必须可达：

任选两人 -> 系统排阵 -> 第一战 -> 组合诊断 -> 安全/节奏适配 -> 第二战 -> 公会响应 -> 第三战 -> 路线选择 -> 第四战 -> 个人成长 -> 第五战 -> 首局结果

公会响应、路线与成长必须读取实际队伍状态；不得把异常组合套入旧的常规组合结果。

体验约束

• 玩家只选人，不手动选前后排；系统按角色能力形成横向队列并解释结果。
• 第一个有意义选择不能预选；至少两个选项在不同组合或状态下各自合理。
• 第三人、保留装备、路线覆盖和个人成长之间必须有真实机会成本或能力变化。
• 每战保留近战碰撞、远程攻击、治疗/保护、伤害数字和结果因果的可读性。
• 结果页回答：发生了什么、为什么、哪个决定造成差异、下一步是什么。
• 中文是第一审查语言；英文、130% 文本、降低动态、静音和低功耗不得回归。
• P9.0R3 已接受的动作节奏、反馈语言和 P9.0R8 前门不可退化。

架构约束

• 不允许多个并行开发者同时修改 runtime/main.gd。
• 先建立行为等价的运行时拆分边界，再并行实现 domain、UI 与 tests。
• 领域状态和结果计算不得依赖 Control 节点树或渲染帧率。
• UI 只通过声明的快照/事件读取领域结果，不复制组合判断。
• 旧 P9.0R1-R10 测试必须继续通过。
• 合并 worker 是唯一可修改共享入口和共享 runner 的实现角色。

专家与实现波次

1. 游戏策划、UX/视觉设计、技术架构并行输出三份互斥规格。
2. PMO 汇合三份规格，消除矛盾并冻结实现合同。
3. Foundation worker 行为等价拆分共享运行时；代表性视觉切片可并行准备。
4. Domain、UI、Tests 三个 worker 在互斥路径中并行实现。
5. Integration worker 接入共享入口，跑完整回归、矩阵、触摸和正常渲染。
6. Fresh independent reviewer 固定 revision 只读验收。
7. Reviewer PASS 后才导出并发布新的私有 H5。

验收

• 六个无序双人组合、两种适配和所有声明后续选择有确定性矩阵覆盖。
• 每个组合完成五战和首局结果，不进入未实现页面，也不使用虚假结果。
• 至少两个公会/路线/成长选择随队伍状态改变价值；没有单一支配答案。
• 真实 Input.parse_input_event ScreenTouch/ScreenDrag 覆盖完整首局，fallback/direct 为零。
• 小/参考/大横屏、zh_CN/EN、130%、降低动态、静音和低功耗均有代表状态。
• 全套 P9.0R1-R10 与 P9.1 测试通过，终态 marker 唯一，严格运行时诊断为零。
• 正常渲染能看出队列、角色行为、伤害/治疗、选择原因和结果变化。
• 固定源 reviewer PASS 后才生成并发布远程 H5。

明确冻结

• 第二章节及以后、完整 42 职业/320 装备/100 敌人内容生产。
• 正式 Market、持久装备背包、权威 XP 3-10、晋升、伤亡恢复和 save migration。
• 权威完整战斗公式、难度、经济、离线进度与长期元进度。
• 除 P9.1 首战/诊断代表性视觉切片外的付费图片、音频、视频和批量最终媒体生产。
• 代表性视觉切片最多 4 次付费图片调用、总额不超过 5 美元（含重试），并记录任务 ID、成本与来源；不再逐次请求 Owner 批准。
• iOS/Android 打包、TestFlight、设备安装、签名、商店、评审与发布。
• 复制参考商业游戏的名称、文案、数值、布局、代码或资产。

人工闸

• Owner 判断完整首局是否看得懂、选择是否有意义、是否愿意继续。
• Owner 判断视觉和听感；自动测试/截图不得替代。
• 物理设备、打包和发布保持开放。

开放问题

无