Phaser4 Template Upgrade
Archived on 2026-08-20 · roadmap: game-web-phaser-template
Archived: 2026-08-20 · roadmap-id:
game-web-phaser-template
Why
决定下了四个月，代码里一个字没变——templates/game-web-phaser/package.json 仍是 ^3.90.0。
这不是"文档待更新"，是决定与代码的落差，而且它正在持续产生两个后果：
- 平台每一次 Run 都在告诉执行者用 Phaser 3。 下游 cogito-lib 的
PLATFORM_CONTEXT第一条逐字写着「技术栈固定为 Phaser 3」，它是平台约束的单一来源，同喂投递消息、讨论 agent 与 PRD agent。那条现在是对的（模板实装就是 3.90.0），正因如此它不能先改——顺序必须是 模板先升。 - 28 个官方 skill 拿不到。 它们是 4.x 独有资产，3.x 有 0 个。
本刀开工前实测的四条事实（不是引用文档，是现查的）
| 事实 | 怎么查的 |
|---|---|
官方 registry 有 phaser@4.2.1，MIT，发布于 2026-07-09 | npm view --registry=https://registry.npmjs.org |
🔴 registry.npmmirror.com 上没有 4.2.1（404），其 phaser 副本停在 2026-04-10、最高 4.0.0 | 同命令指向镜像；time.modified = 2026-04-10 |
| 主因是包体：4.2.1 解包 112 MB / 3593 文件，压缩后 19.5 MB | dist.unpackedSize / dist.fileCount / 实测下载 |
腾讯源 mirrors.tencent.com/npm 有 4.2.1 且最快（19.5 MB @ 7.1 MB/s，2.75s）；华为源 4.3 MB/s；官方 3.3 MB/s | 三个源各真下了一段 tarball，不是只看元数据 |
28 个 skill 在 4.0.0 与 4.2.1 逐条相同（各 28 个 SKILL.md，文件清单 diff 无差异）——
所以"能拿到 skill"这个收益不依赖 4.2.x，但既然腾讯源装得到，就没有理由主动放弃四个月的修复。
Non-goals
- ❌ 不接 28 个 skill 进 Shelley 的 skill 目录。那是 PRD §4.1 的落地事项 c，涉及"注入发生在 哪一层"（模板 postinstall？平台脚手架命令？CLI？）——是独立的一刀，且它的价值验证 （模型会不会真去激活）本身就是另一个被降级的条目。本刀只让 skill 变得可得，不负责投喂。
- ❌ 不动 cogito-lib 的
PLATFORM_CONTEXT（backlog 条目 0.5）。理由见 design D3—— 那条翻转有一个 PRD 没考虑到的副作用，需要单独设计。 - ❌ 不动其它两个模板（
web-nextjs/skills-registry）的.npmrc。它们没有被这个问题挡住， 顺手改会把一次可回滚的模板改动变成三个模板的连带改动。 - ❌ 不在 agentdock 仓库根加
registry=。见 design D2：会覆盖 CI 的发布 registry。