🔒 內部文件 · 給協作團隊

一起編輯
彰化雙語資源網的方法

這份指南教大家怎麼用 Claude Code 安全地一起改學校網站。第一次加入請完整看一遍。

🌐 changhua-bilingual.org 📦 lukelin7429/changhua-bilingual 👤 主理人 林吉祥 Luke
🛠️

一次性設定

每台電腦只做一次

① 加入 repo

  • 申請一個 GitHub 帳號，把帳號名稱給 Luke
  • Luke 把你加為 collaborator 後，到 email 收 GitHub 邀請信，按 Accept
  • 安裝 Claude Code（裝過就跳過）

② 把網站抓下來、設定身分

# 把整個網站 clone 到你電腦
git clone https://github.com/lukelin7429/changhua-bilingual.git
cd changhua-bilingual

# 設定你的身分，commit 才會掛你名下
git config user.name "你的名字"
git config user.email "你的GitHub email"

之後每次工作，都在 changhua-bilingual 這個資料夾裡開 Claude Code —— 這樣設計鐵律（CLAUDE.md）才會自動載入。

🎯

每次開工的五步口訣

不用背 git 指令 —— 用中文指揮 Claude，它幫你做完所有 git 動作

每次都一樣 · 把它當口訣

Pull → 指揮 → 預覽 → 上線 → 確認

1

先同步 🔒 安全紀律

永遠先拿最新版再動工，別人可能剛上線新東西，不 pull 你會做在舊版上。

先幫我 git pull 拿最新版
2

指揮 Claude

告訴 Claude 你要做哪一間學校、哪一頁、改什麼。

幫我把 schools/<學校>/ 首頁的 banner 換成這張照片
3

本機驗收 🔒 安全紀律

改完先預覽，自己用手機尺寸從頭滑到尾，對照 CLAUDE.md 自檢清單。沒看過、沒滑過，不要上線。這一步取代了「Luke 審核」那道關。

先在本機預覽給我看
4

上線

確認 OK 後叫 Claude 推上去，它會寫好 commit message。

沒問題了，commit 並 push 到 main
5

確認上線

等 1–2 分鐘，打開 changhua-bilingual.org/schools/<學校>/ 重新整理，確認真的更新了。

🔑

你的權限

每個人都能改每一間學校

🏫

每個人都能改每一間學校

權限上沒有「這間是你的、那間是別人的」之分 —— 誰有空就誰做。schools/ 底下任何學校你都可以改、直接 push 到 main，約 1–2 分鐘自動上線。

✅ 你可以
  • clone repo 到自己電腦
  • 修改 schools/ 底下任何學校的資料夾
  • 直接 push 到 main（我們不走 PR 審核）
⛔ 不要碰
  • CNAME、GitHub Pages 設定
  • apps-script/、.github/
  • 根目錄檔案（index.html、build.py、sitemap.xml 等）
  • schools/ 以外的東西要動，先問 Luke
🚦

怎麼避免「撞車」

人人可改任何學校，所以這段要懂

只有一種情況會撞車：兩個人同時改到「同一間學校的同一個檔案」。改不同學校、或同校不同檔案，都不會撞車。預防三招：

🔄 開工前先 pull

第一步永遠拿最新版（口訣第 1 步），就是這個用意。

⚡ 做完盡快 push

不要把改動囤在自己電腦好幾天，越早上線越不會跟別人撞。

💬 動別人剛碰的學校先講一聲

群組說「我來改 X 校首頁」，避免兩人同時改同一頁。

🛟 真的撞到了怎麼辦？別慌，絕不要 force push

如果 push 被擋下來（出現 rejected / non-fast-forward），代表有人比你先推。直接跟 Claude 說：

我 push 被擋了，幫我 pull --rebase 之後再 push

只要沒有人 force push，沒有人的東西會憑空消失 —— 最壞就是重推一次、慢一兩分鐘。

🚫

絕對不要做的事

記住這四條就好

💥 不要 force push

git push -f 是唯一會洗掉別人成果的動作，絕對禁止。撞車時用 pull --rebase，不要 force。

📦 不要 git add .

不要 git add . 或 -A。只 add 你這次真的有改的學校：叫 Claude「只 add schools/<slug>/」。

🔐 不要 commit 隱私 / 金鑰

不要 commit .env、Google API key、家長/老師個資、薪資、簽名圖片。

👀 沒預覽過不要 push

跳過「本機驗收」就上線 = 沒有人把關。一定要先預覽、滑過再推。

🎨

三大設計鐵律

在 repo 裡開 Claude Code，這三條 Claude 會自動遵守、自動自檢

🖼️ Banner 不蓋全幅遮罩

照片清晰時不要蓋整片暗化/染色（會「髒髒的」）。文字可讀性只用底部單一漸層 scrim + 字陰影。

🔠 字級以 yangming-jhs 為母版

第一個動作：複製 schools/yangming-jhs/ 的 :root 色票與字型。絕對 px、禁 rem；body ≥ 20/23px、次要文字 ≥ 17/19px。

🗂️ WOTD / Lessons 以 dajuang 為母版

落地頁複製大莊的「主題色卡片網格」，個別單元用 .vc vocab card，每單元 9 字。

💡 完整自檢清單與細節都在 repo 的 CLAUDE.md，Claude 會自動讀；你只要在預覽時對照它從頭滑一遍。

📋

其他內容規則（速查）

細節以 CONTRIBUTING.md 為準

🔤 網址 slug

小寫英文、用學校官方羅馬拼音（和美 = homei）。開新學校前先跟 Luke 確認 slug，上線後不能改。

🧭 Sub-nav 七連結（固定序）

Home · Lessons · Bilingual Campus · Teachers · About · Contact · Festivals（永遠最後）。Festivals 用絕對 URL，不要在校資料夾建 festivals/。

🎧 Bilingual Campus 嵌兩條 playlist

課室英語 + 廣播英語。URL 跟 Luke 索取最新版，不要自己上 YouTube 找替代。

❓ 測驗 Quiz

自製 HTML + Apps Script（不用 Google Forms）。選項一律純英文，中文只在提示與作答後解說。

⬜ 設計基調

全頁純白底 #fff；繁中用系統字體（禁 Google Fonts 中文）；banner 不放會變動的數字；只列校長、不列主任；全 inline 不彈新分頁；不寫學費。

🙋 不清楚就問 Luke

特殊設計需求、加表單收家長資料、嵌 Google Map/Calendar、未公開學生照、要動根目錄檔案 —— 寧可多問一次。