3.8 KiB
3.8 KiB
站主與助手協作備忘
由對話整理；程式真值仍以 repo 與 .cursor/rules/*.mdc 為準。本檔僅記「這次講定的做事方式」，不取代規則檔。
1. 邊界（站主明講）
- 沒有叫你做的，不要順手做（含刪註解、順手整理、自訂「以後我都會……」流程）。
- 看不懂先問；你說「執行」再改檔。你說「檢查」就只對照回報，不擅自改。
- 不要自己訂規則代替站主（例如自創「只調樣式就保留註解」這類概括）。
2. 參考圖怎麼讀
- 畫線／粉線：提醒「這一段要看」，不是「整段都要包 span」或「這裡一定要
mark_b」。 - 實際標記：對照圖裡字重、黃標、一般內文，再對應既有 class（
mark_y、mark_b），自己判斷。 - 開發者工具截圖（勾選／刪除線）：照屬性開關改 CSS；沒叫動註解就不要動註解。
3. 首頁 #mission（做法，非定稿內容）
- 第一段：站主若只說調 span，只增刪
<span>與既有 class；未要求不改 CSS。實際哪些詞要mark_y／mark_b會變，以當下index.html與站主圖為準，不寫死在筆記。 - 第二段金句：未要求時只改內文、不改 span 結構。
- devtools 截圖：照屬性開關改；沒叫動註解就不要動註解。
4. 籌備中連結（portal-nav.js，若後續對話有改動以檔案為準）
- 頂欄與頁內按鈕：
NAV_SOON_PHRASES隨機氣泡（滑過）；無障礙 aria「尚無開放」。 - 頁內按鈕：不加可見「（籌備中）」後綴。
totoga2-copy-timeline.html在COMING_SOON_PAGES（時間軸不公開）。
5. 2026-05 慘痛教訓（務必讀 agent-must-ask.mdc）
- 用 PowerShell 批次改全站 HTML 沒 UTF-8 → 首頁中文全毀、
</span>露出；已git checkout還原 HTML。 - 擅自把
map-archive-header改成inner-page-header（站主沒點頭、沒給名字）。 - 站主說先電子書 + dev
center 78%，助手卻自加clamp／全站100vh／又全站改掉。 - 頂欄擅自「傳奇的轉折（六六歌2）」— 已改回「傳奇的轉折」；以後 nav 文案不自擴。
6. 改完就給 commit（站主訂）
每做完一項改動，回覆末尾直接附一段（不要為此反覆跑 git status／git diff 確認；助手自己知道改了什麼）：
git add .
git commit -m "類型 修改重點"
| 項目 | 約定 |
|---|---|
| 類型 | 三選一，以本次修改為主的那一種：feat（新功能／新行為）、fix（修 bug／修壞掉的行为）、style（純樣式／排版，無新功能） |
| 格式 | 類型後空一格，再接修改重點；整段 "" 內建議維持 類型 + 空格 + 重點 一行 |
| 字數 | 修改重點15 字以內（中文為主，標點計入字數；過長請精簡） |
範例
git add .
git commit -m "feat 頂欄992px漢堡選單"
git add .
git commit -m "fix 三層子選單hover接軌"
git add .
git commit -m "style 內頁標題深灰配色"
- 站主若只說「檢查」、未說執行：不附 commit（也沒有改檔）。
- 一次對話若分多項獨立交辦，每項做完各附一段 commit，不要合併成一句含糊帶過。
7. 相關規則檔
| 檔案 | 用途 |
|---|---|
.cursor/collaboration-notes.md §6 |
改完附 commit（類型、15 字內重點） |
.cursor/rules/agent-must-ask.mdc |
必問再改、禁止批次毀 UTF-8、header／nav 勿擅自改名 |
.cursor/rules/ai-change-boundaries.mdc |
變更範圍、共用 CSS |
.cursor/rules/user-scope-and-nav.mdc |
導覽開放、錨點刪除 |
.cursor/rules/portal-nav-rules.mdc |
portal-nav.js 技術細節 |