diff --git a/.claude/settings.json b/.claude/settings.json new file mode 100644 index 0000000..090799c --- /dev/null +++ b/.claude/settings.json @@ -0,0 +1,7 @@ +{ + "permissions": { + "allow": [ + "Bash(python3 -c ' *)" + ] + } +} diff --git a/.vscode/settings.json b/.vscode/settings.json index 6f3a291..155422b 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,3 +1,3 @@ { - "liveServer.settings.port": 5501 + "liveServer.settings.port": 5503 } \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..b7c7913 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,98 @@ +# 水晶男孩推廣部 — 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` | + +**最重要的三條:** +1. 沒說「執行」→ 不改檔 +2. 只改被點名的那一頁/區塊 +3. 改完必附 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 操作守則(血淚版) + +> 每次新增或修改導覽,必須先讀這裡再動手。 + +1. **先查 `extra/site-guide.html` 確認層級**,再動 `portal-nav.js`。 + site-guide 的 depth 數字 = nav 的層級:depth-1 是第一層 `