Skip to content

docs(starpuff): 六個 T5 主題招式模組註解誤引 GAME_DESIGN §5,應為 §111–§113 #875

Description

@s123104

摘要

v21–v23(#813 T5 列車)新增的六個純邏輯模組,檔頭註解一律寫 GAME_DESIGN §5——§5 是「角色設定(全部原創)」的主角/小怪設定表,與這些模組毫無關係。正確章號應為 §111–§113。

背景/證據

T7-C 文件拆分(PR 待補)為「章號 §N 是穩定識別碼、索引表負責解析章號到檔案」做了守門,這批誤引因此浮現——照註解查號會落到完全無關的章節。

apps/starpuff/src/game/logic/moveTable.ts:1     // 魔王加權選招 SSOT(GAME_DESIGN §5 / #813)
apps/starpuff/src/game/logic/eclipseCloak.ts:1  // 蝕月斗篷純邏輯(GAME_DESIGN §5 / #813)
apps/starpuff/src/game/logic/jellyPatch.ts:1    // 果凍回彈純邏輯(GAME_DESIGN §5 / #813)
apps/starpuff/src/game/logic/mirrorShadow.ts:1  // 鏡像殘影純邏輯(GAME_DESIGN §5 / #813 W2)
apps/starpuff/src/game/logic/caramel.ts:1       // 焦糖化純邏輯(GAME_DESIGN §5 / #813 W2)
apps/starpuff/src/game/logic/starSiphon.ts:1    // 星光虹吸純邏輯(GAME_DESIGN §5 / #813 W3)

對應的正確章節(現行 SSOT apps/starpuff/docs/design/03-enemies-bosses.md):

檔案 應引章號
moveTable.ts §111.1(加權選招基礎設施 SSOT)
jellyPatch.ts §111.2
eclipseCloak.ts §111.3
mirrorShadow.ts §112.3
caramel.ts §112.4
starSiphon.ts §113.2

影響

  • 低(P3,僅維護性):不影響執行期行為;但破壞「程式註解→設計章節」的可追溯性,後續調參者依註解查到錯章。

範圍

  • 上列六個檔案的檔頭註解單行,純字串修正。
  • 不在範圍:任何邏輯、型別或測試變更。

驗收標準

  1. 六檔註解章號改為上表值。
  2. rg "GAME_DESIGN §5 " apps/starpuff/src 零命中(§5 僅應由角色設定相關處引用)。
  3. 全量 vitest 綠(純註解變更,行為零改變)。

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationseverity:p3Lower-priority optimization

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions