docs(starpuff): #906 審查收斂——註解漂移修正、AGENTS.md v5.7 與 002 數字訂正

[s123104]

背景

#906（GameScene strangler 拆分）兩席審查（Grok 96/95 APPROVE、Sonnet 93/91 REQUEST_CHANGES）確認拆分本體無行為回歸，必修項全為文件層級。#906 已由 PM 合併，本 PR 承載全部文件層級收斂；#906 的 PR 描述已同步改寫（證據階層重排＋移除「characterization test 先行鎖定」措辭）。

六項處置

1. PR 敘事證據階層重排（必修）：已直接修訂 refactor(starpuff): W2 前置債務車——GameScene strangler 拆分 1180→875 行（行為零改變） #906 描述——機械搬移 diff 為最高權重，既有 1048 案零修改次之，L2 靜態軸/L4 clearRate 第三，新模組測試為補強，L4EX bot 勝率降級為觀測、明確標註不得作為裁決真值
2. 移除「characterization test 先行鎖定」敘事（必修）：已改寫為「機械搬移＋同步撰寫新模組測試；行為零改變由既有套件零修改全綠＋機械搬移 diff＋e2e 既有失敗逐字重現三條證據鏈佐證」，並在測試段明註「同 commit 落地不構成先行鎖定證明」
3. 002 條目內文數字訂正（必修）：1096→1106（rebase 前舊基準未同步）；檔頭記分行不動（+1／累計 +325 數學不變），精確性修正守門依規跳過
4. 註解漂移修正（必修，Grok LOW 根修＋全庫掃描）：共 13 處——除 Grok 點名的 starburstDirector.ts:8（seenFlavorHints→sceneEvents）外，rg 全庫掃描搬走符號另找出 12 處：main.ts（syncGateSweep→levelGate.sweep）、stage.ts ×3（掃掠基準歸屬/鏡像命名）、caramelStatus.ts（sync 呼叫者→damageDirector）、boss.ts/syrona.ts/bossRoom.ts（getVentLift/updateBuffHud 逐幀委派者→damageDirector）、stageModel.ts＋docs/design/04-levels-world.md（spawnGate→門生成當幀）、04-levels-world.md（advanceTide 歸屬）、03-enemies-bosses.md（getVentLift 委派者）；「」引述綁定字串零變更，design-docs 守門通過
5. L4 TTK 多輪包絡（Grok MEDIUM）：交錯 A/B（pre-refactor(starpuff): W2 前置債務車——GameScene strangler 拆分 1180→875 行（行為零改變） #906 main db07e8fd6 ↔ post-refactor(starpuff): W2 前置債務車——GameScene strangler 拆分 1180→875 行（行為零改變） #906，mid bot 各 4 輪逐輪交替）：兩側皆 4/4 通關；TTK base 16.6–22.6s（中位 19.5）vs branch 15.4–19.7s（中位 18.4），包絡重疊；靜態軸全等（d 3.5/m 3.5/pStatic 3.8）。裁決依據採 clearRate＋靜態軸（理由：與本輪同步入 SOP 的證據階層一致——TTK 屬 bot 動態指標，作為支持性觀測而非裁決真值），原單點對照 18.9→17.5 由本包絡取代
6. AGENTS.md v5.7（流程 SOP）：實務模式新增三節——(a) 工人分支 rebase 稽核前置（PM rebase 前必留 pre-rebase/<branch> ref 供 patch-id 覆核）(b) 難度驗收證據階層（bot 勝率非裁決真值；若必須用，比照 Lighthouse 序列化真值：單機序列 ×N 取中位＋穩定性前證）(c) strangler 兩段式 commit 慣例（①模組＋測試 ②切 wiring，使測試先行在 git 史可證；不採者敘事必須誠實）

驗證

• vitest 82 檔 1106 案全綠；tsc --noEmit 0 錯；lint 0 error；GameScene 維持 875 行
• design-docs 守門通過（md 修改未動引述綁定）
• 全部變更為註解/文件/SOP，零行為改動；L4 重測未揭露任何真實行為差異

Made with Cursor

[github-actions]

⚠️ Deprecation Warning: The deny-licenses option is deprecated for possible removal in the next major release. For more information, see issue 997.

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None