水晶男孩推廣部 — AI 工作上下文

這個檔案讓 AI 在任何裝置（家／學校）都能快速恢復上下文。 每次對話做了重要決定，請叫我更新這裡，然後 git commit。

專案簡介

水晶男孩（Sechs Kies）推廣粉絲網站。靜態 HTML + PHP + 原生 CSS/JS，無框架。站主（Noopy）2016 年入坑，藝廊式創作風格。

規範速查（詳細見 `developer-rules/rules/`）

規範	檔案
改檔行為守則（必問再改）	`agent-must-ask.md`
變更邊界（只改被點名的）	`ai-change-boundaries.md`
CSS 顏色 Token	`color-tokens.md`
版面視覺預設	`design-defaults.md`
Git commit 規範	`git-commit-required.md`
導覽邏輯（portal-nav）	`portal-nav-rules.md`
文案語調	`site-voice.md`

最重要的三條：

沒說「執行」→ 不改檔
只改被點名的那一頁／區塊
改完必附 commit 指令（禁止在 sandbox 跑 git）

架構重點

全站導覽：assets/js/portal-nav.js（COMING_SOON_PAGES 控制開放）
全站 CSS：assets/css/style.css（定義所有 color token）
首頁：index.html
站主索引（自用）：extra/site-guide.html（data-portal-nav-all-open，不對外）
內頁 header class：inner-page-header（禁改回舊名）

variety/ 頁面

檔案	頁面標題	說明
`variety/bangxiao.html`	世紀級寶藏 / 爆笑養老院	甜蜜負擔計量器；六人卡片選取 + jQuery 計算；CTA → `totoga2/ebook.html`
`variety/variety-shows.html`	全員發瘋	綜藝節目存檔表；tabs + 搜尋；已對齊 albums.html 扁平結構
`variety/NJTW/NJTW5.html`	新西遊記5	各自暴走專頁

portal-nav 操作守則（血淚版）

每次新增或修改導覽，必須先讀這裡再動手。

先查 extra/site-guide.html 確認層級，再動 portal-nav.js。
site-guide 的 depth 數字 = nav 的層級：depth-1 是第一層 <li>，depth-2 是子選單項目，depth-3 是 subgroup 裡的巢狀項目。
COMING_SOON_PAGES 只放檔名（不含路徑）。
normalizePageKey 只取 href 最後一段，所以 variety/bangxiao.html → 比對 bangxiao.html。
直接連結不需要 subgroup。
子選單內只要 <li><a> 就夠；portal-nav__subgroup 只在該項目還有巢狀子項目時才用（例如「傳奇的轉折」有時間軸、電子書等四項）。
site-guide.html 要同步更新，否則站主索引頁會顯示舊名稱。
commit 前網站不會更新。本地端強制重整用 Ctrl+Shift+R；GitHub Pages 需 git push 後等約 1 分鐘。

目前工作狀態

最後更新： 2026-06-17

進行中：

待確認：

developer-rules 健檢尚未執行

已完成：

建立 AGENTS.md 跨裝置上下文檔案
新增 variety/bangxiao.html（世紀級寶藏 / 爆笑養老院，甜蜜負擔計量器）
variety/variety-shows.html 重構：移除多層包裝，對齊 albums.html 扁平結構
portal-nav 新增世紀級寶藏，正確放入淪陷瞬間子選單
extra/site-guide.html 同步更新：全員發瘋 → 世紀級寶藏

如何使用這個檔案

換裝置後，告訴 AI：

「請先讀 AGENTS.md，再讀 developer-rules/rules/ 裡的所有規範，然後繼續 [任務]。」

Imported Claude Cowork project instructions

在這個專案資料夾中，有一個名為 developer-rules 的資料夾。

這是我們第一次合作，我不確定裡面目前記錄的規範是否完全正確、有沒有被之前亂寫的扣給弄髒。

請你在初始化專案後，立刻去徹底閱讀 developer-rules 裡的所有內容，並且不要盲目死背。請幫我仔細檢查、挑出裡面是否有前後矛盾、不夠乾淨、或是不符合現代高標準前端美感與 PHP 結構的規範。讀完後，請在我們的第一次對話中，條理分明地向我回報你的健檢結果，並給出優化建議，等我確認後我們再正式鎖定。

4.1 KiB Raw Blame History Unescape Escape