網站建置 SOP

附錄 B：常用指令速查

安裝（一次性，👤）

brew install git node lychee     # 三條必裝工具
chmod +x audit.sh                # 確保審計腳本可執行（每個新專案跑一次）

開發（👤 + 🤖）

npm run dev              # 🤖→你：一開始由 AI 跑，確認後你接手驗收 → http://localhost:4321
npm run build            # 🤖：AI push 前自動跑，確認 0 error。你也跑一次雙重確認
npm run preview          # 👤：預覽靜態輸出，確認跟 dev 一致

Git（👤）

git add -A && git commit -m "訊息" && git push   # 👤：你決定何時 push（觸發 Cloudflare 部署）
git pull --rebase                                  # 👤：push 被拒時先拉再推（遠端有 CMS 內容更新）
ssh -T git@github.com                              # 👤：確認 SSH 連線正常（部署前置）
git remote -v                                      # 🤖：AI 檢查是否推錯帳號/repo

檢查（🤖 跑，👤 看報告）

./audit.sh                                           # 🤖：5 階段全檢查，你只看最後結果
./audit.sh https://新網域                              # 🤖：指定網域的版本
lychee dist/ --base https://網域 --exclude "mailto:*"  # 🤖：單跑 dead link（audit 第 1 階段）

手動抽查（👤）

curl -sL https://網域/ | grep -o '<title>[^<]*'     # 👤：確認頁面標題不是「無標題」或舊站名
curl -sL https://網域/sitemap.xml | head            # 👤：確認 sitemap 存在 + 網域不是 github.io
curl -sL https://網域/rss.xml | head -20            # 👤：確認 RSS 有產出
grep -rn "localhost" dist/ | grep -v "wrangler.json"  # 👤：確認無 localhost 殘留在 HTML 中
grep -rn "github.io" dist/ | grep -v "wrangler.json"  # 👤：確認無舊 GitHub Pages URL
grep "repo:" public/admin/config.yml                # 👤：確認 CMS 推對 repo（跟 git remote -v 一致）

[[#table-of-contents|← 回目錄]]

附錄 C：網站風格選擇指南

C.1 為什麼風格要事先決定

風格決定 OpenCode 的初始提示詞範圍。先選定風格可以避免做到一半才改色。

C.2 8 種風格完整對照

詳細風格內容見下方子章節。

風格 1：日式侘寂風

風格 2：海洋清新風

風格 3：極簡黑白風

風格 4：粉嫩柔和風

風格 5：森林自然風

風格 6：日落暖橙色（目前風格）

風格 7：城市現代風

風格 8：大膽撞色風

8 種風格速查總表

C.3 風格切換提示詞模板

萬用模板：

我要把網站改成 [風格名稱]。
關鍵詞：[詞1]、[詞2]、[詞3]
配色：主色[色碼] 輔色[色碼] 背景[色碼] 暗背景[色碼]
字體：標題[字體] 內文[字體]
圓角：[rounded-xx]
陰影：[無/shadow-md/lg/xl]
請先改 global.css + Layout.astro 讓我確認方向。

輕量模板（只改配色）：

幫我把配色從暖色系改成 [色碼] 為主。只改顏色不改變局。先從 global.css、Layout.astro、index.astro 開始。

暗色模式獨立調整：

暗色模式配色跟新風格不搭。請獨立調整 dark: 相關 class，背景改[色碼] 卡片改[色碼] 文字改[色碼]。

C.4 設計參考資源

C.5 換風格常見陷阱