zizi-al/games-development-ai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
games-development-ai/docs/memorys/2026-06-01-阶段规格计划审查.md

5.9 KiB
Raw Blame History

2026-06-01 阶段规格计划审查

背景

本次任务根据最新产品口径，派发子代理只读审查 S0-S8 阶段 spec 和 plans，并把 Critical/Important findings 写回阶段文档。当前仍是文档设计和执行计划修订，不代表代码、harness、runtime、转换器或发布链路已经实现。

最新口径：

User conversation
-> MainCreationAgent
-> internal subagents
-> AIGameDesignDraft
-> DesignSection / DesignSectionPatch
-> GameIR
-> GameConfig
-> GameLogicModule
-> GamePackage
-> Web Runtime / MiniGameConversion

用户只面对 MainCreationAgent。需求确认、生成游戏 draft、配置修改、预览问题处理等能力由内部可扩展子代理完成；所有子代理输出必须回到受控合同和可验证证据。

子代理审查结论

本次并行审查分为四组：

  • S0-S2：主 Agent 入口、基础模型、creator workbench、GameIR 编译合同。
  • S3-S4：模拟经营 vertical slice、GameLogicModule、Web runtime。
  • S5-S6：小游戏转换、开发者工具导入证据、站内审核发布和 feed。
  • S7-S8：反馈、部署 readiness、总 route Go/No-Go。

阻断问题集中在三类：

  • 入口边界：S2 不能暴露绕过 MainCreationAgent 的公开写 API；Prompt/Draft/Section/Patch 必须带 sessionId 和 agentTaskId lineage。
  • 证据边界：P0 小游戏导入证据只能接受 DevToolImportEvidence.result=passed；DevToolImportBlocker、ChannelReadinessNote、failed/blocked/unknown 不能冒充通过。
  • P0 范围边界：当前 P0 不做三端真机 smoke、渠道提审、自动审核、广告支付结算、完整 telemetry dashboard 或规则建议平台。

已写回的关键修订

  • docs/superpowers/plans/2026-05-31-mvp-S0-harness.md

    • 补强 DevToolImportEvidence.result=passed gate。
    • 增加 blocker/note/failed evidence invalid fixtures。
    • 增加 Node/CommonJS/dynamic execution/Web-only SDK 拒绝项。

  • docs/superpowers/plans/2026-05-31-mvp-S1-app-foundation.md

    • S1 foundation model 补齐 MainCreationAgentSession、AgentTask、ReviewRecord、LifecycleEvent。
    • leak check 改为禁止 S2-S8 业务逻辑泄漏，而不是禁止基础模型名。

  • docs/superpowers/plans/2026-05-31-mvp-S2-creator-workbench.md

    • 公开写入口只保留 POST /creation-agent/messages。
    • 其他 prompt/draft/section mutation 只能是内部 service，并要求 sessionId + agentTaskId + taskType + outputRef。
    • DesignSectionPatch 变成真实持久化/命令对象，带 checksum conflict gate。
    • GameIRArtifact.payload 改成 discriminated union，支持 simulation/light template。
    • S0 GameIR 验证输入改为编译后的 compiled-simulation-game-ir-valid.json。

  • docs/superpowers/specs/2026-05-31-mvp-S3-simulation-slice-design.md

  • docs/superpowers/plans/2026-05-31-mvp-S3-simulation-slice.md

    • DesignSection.payloadJson、GameIR.nodes/resources/objectives/controls、GameConfig.world/systems/controls/objectives 改为 typed contract。
    • GameLogicModule 校验依赖 ValidationReport，不能信 descriptor 自报 validated。
    • RuntimeSdkContract.Canvas 不暴露 raw canvas/context，改为 opaque handle/render commands。

  • docs/superpowers/specs/2026-05-31-mvp-S4-web-runtime-design.md

  • docs/superpowers/plans/2026-05-31-mvp-S4-web-runtime.md

    • Web runtime smoke 必须有浏览器证据：screenshot、pixel delta、NPC movement、coin change、objective visible、input changes state、events sequence、no runtime/console error。
    • GamePackage.web.manifest 绑定 S3 source artifact checksum、validation report 和 package-relative logic path。
    • 增加完整引擎依赖/bundle gate，P0 不直接引入 Phaser/GDevelop/ct-js/Cocos/Laya runtime。

  • docs/superpowers/specs/2026-05-31-mvp-S5-minigame-conversion-design.md

  • docs/superpowers/plans/2026-05-31-mvp-S5-minigame-conversion.md

    • static gate 同时扫描源 GameLogicModule 和三端生成项目。
    • 拒绝 Node builtins、require/process/Buffer、eval/new Function/setTimeout(string)、dynamic import。
    • 最终 evidence gate 不再只检查 result，还要校验证据字段、项目路径、日志/截图、项目 checksum，且拒绝 blocker/note 类型。

  • docs/superpowers/specs/2026-05-31-mvp-S6-publish-review-feed-design.md

  • docs/superpowers/plans/2026-05-31-mvp-S6-publish-review-feed.md

    • P0 删除自动审核发布口径。
    • 拆分 GameVersion.status、ReviewRecord.status、PublishedGame/ExposureRecord.status。
    • 增加 operator/review/feed endpoint access-control matrix 和负向权限测试要求。

  • docs/superpowers/specs/2026-05-31-mvp-S7-feedback-design.md

  • docs/superpowers/plans/2026-05-31-mvp-S7-feedback.md

    • S7 当前 P0 收窄为事件入库、最小质量信号、引用 S5 evidence 的 readiness note。
    • 完整聚合、创作者看板、运营看板、规则建议放到 MVP 后段/P1。
    • ChannelReadinessNote 只能引用 S5 evidence ID，不能自造转换状态或替代 ChannelReview。

  • docs/superpowers/specs/2026-05-30-mvp-product-technical-route-design.md

  • docs/superpowers/plans/2026-05-30-mvp-overall-product-technical-route.md

    • 总 route 改为 DevToolImportEvidence.result=passed；missing/blocked/failed/blocker-only 都是 No-Go。
    • 总 plan 的下游路径改为真实存在的 2026-05-31-mvp-S0...S8。
    • 删除“阶段文件不应存在”的旧 gate，改为校验现有阶段文件引用当前 route。

后续执行约束

  • 实现顺序仍然是先 S0 harness/schema/fixtures/validator，再进入 S1-S8。
  • P0 实现不要绕过主 Agent 做手工配置入口。
  • P0 实现不要把 Web 包改名冒充小游戏项目。
  • P0 实现不要把 blocker/note/failed evidence 当作 passed evidence。
  • P0 实现不要声明三端真机可玩、渠道可上架、已提审或已发布。
  • 后续 review 需要优先检查这些合同是否在代码、fixture、validator、UI 和 evidence 中真实落地。