| name | prepush |
| description | 放置天堂專案 push 前的完整檢查與準備 — bump 改動外掛的 ?v=、重算 sw.js 版本、跑 Playwright smoke、檢查衝突標記，全綠才建議 push。當使用者說「準備 push」「push 前檢查」「跑 prepush」或 /prepush 時使用。 |
| disable-model-invocation | true |
/prepush — push 前一鍵備齊
對應 CLAUDE.md「每次 push 前的檢查清單」。從 repo 根目錄(D:\ppRepos\idle-lineage-class)依序做完，全綠才建議使用者 push。 任一步紅就停下回報，不要硬推。
步驟
-
看這次要 push 什麼
git status + git log origin/main..HEAD --oneline(還沒 push 的 commit)git diff origin/main..HEAD --name-only 抓出「動到的 afk-*.js」清單。
-
bump 改動的 ?v=
js/*.js、css/*.css、afk-*.js 全部：跑 node scripts/stamp-code-versions.mjs(自動把 ?v= 對齊「內容 sha1 前 10 碼」，不必手動算、也不會漏；afk-*.js 也在涵蓋範圍，不要手動 bump)。
🚨 這步絕不可省：?v= 沒 bump ⇒ URL 沒變 ⇒ 玩家的瀏覽器/SW 繼續用舊快取，而同頁其他有 bump 的檔卻是新的 ⇒ 新舊混搭。2026-07-11 踩過：遺物移植同時改了 js/04(新增 equipSkillDmgMult)與 js/07(呼叫它)、兩個 ?v= 都沒 bump → 先快取過舊 js/04、之後才抓 js/07 的玩家拿到「新 07 + 舊 04」→ 一施放技能就 Can't find variable: equipSkillDmgMult，離線結算整段中斷、收益歸零。看玩家何時快取而定，故低機率、無法重現，極難查。- 改到
assets/、public/assets/ 的圖 → 跑 node scripts/gen-manifests.mjs 重產對帳清單一起 commit(動到 assets/anim/ 另跑 node tools/gen-anim-manifest.js)。
-
重算 sw.js 版本(PWA 偵測更新靠這個)
node scripts/stamp-sw-version.mjs
-
冒煙測試(確認外掛都掛得上、沒被改壞)
node scripts/smoke-hooks.mjs → 要看到「冒煙測試通過」、exit 0。- 紅了代表某外掛 hook 失效(遊戲碼被改到 / 外掛自己改壞)，回報是哪支。
- smoke 沒有任何自動排程在跑，這裡就是 push 前唯一的把關點，不可跳過。(同步上游走
/sync-upstream 時腳本內也會跑一次。)
-
衝突標記把關(rebase 沒解乾淨會壞整頁)
grep -nE "^<<<<<<<|^=======|^>>>>>>>" index.html sw.js afk-*.js 必須為空。- 順手確認每支外掛在 index.html 只出現一次
<script>(沒有重複)。
-
最後把關:?v= 全對得上
node scripts/stamp-code-versions.mjs --check → 必須 exit 0(「所有 js/css 的 ?v= 都與內容一致」)。- 紅了代表步驟 2 漏跑或有人手改過 → 跑一次不帶
--check 的版本修好再 push。
-
回報結果
- 全綠：列出「bump 了哪幾支、sw 版本、smoke 通過」，告訴使用者可以
git add -A && git commit && git push 了(或直接幫忙 commit/push)。
- 有紅：明確指出哪步、要修什麼，停在這裡別 push。
註：實際 git push 時還有 prepush-guard.mjs hook 會再擋一次衝突標記/引用/sw 版本，這支 skill 是「主動把全部準備做完」。
