📚 Claude 規則百科 · Thomas 小白學習版

這裡記錄你教給 Claude 的所有規則、Skills、Agents，用白話解釋給你看，同時附原文讓你學技術細節。

Lessons 教訓

Skills 技能

Agents 專家

CLAUDE.md 段

User/Project/Ref

🕐 資料最後更新：載入中...

🎯 八大功能

📖 白話百科 — 艱深檔名翻成白話，點開看原文學技術
🗺️ 讀檔流程 — 圖示 Claude 每次啟動 + 對話時讀哪些檔
🏥 健康度 — 規則有沒有亂（硬編碼/模糊/重複），A/B/C 選項改
🔄 雙機同步 — 每天 6 點檢查兩台電腦同步狀態
🌳 Worktree — 兩台電腦 worktree 看板，避免重名/孤兒
📱 手機禁忌 — Remote Control 常踩的坑
📊 成長曲線 — 每週教 Claude 幾條新規則
🔍 衝突偵測 — 多條規則用同一觸發詞提醒

💡 資料從哪來？GitHub repo thomastangnz-commits/downloads-config 是唯一真理源。兩台電腦關機了也沒關係，GitHub Actions 每天自動掃 + 更新本站。

📖 白話百科

每條規則 = 白話卡片（預設）+ 原文（點展開）。MVP 放 3 個示範，後續 GLM 批量生成 169 條。

Lesson 教訓 🔴 鐵律

刪檔案前一定先看再確認

Claude 要刪任何檔案前，必須先讀內容 + 告訴你刪什麼 + 等你說「刪掉」才動。

🩹 踩坑：2026-04-14 Claude 刪了 rule-sentinel.yml 沒查內容也沒問，git 歷史找不到，內容永久丟失。之後加了 L2 hook 強制。

Read 看內容
告訴你：刪什麼、為什麼、能否恢復
等你說「刪掉」才執行

觸發詞：刪掉 / 同意刪 / 確認刪除

📅 建立：2026-04-14 07:21 🔄 更新：2026-04-14 07:21

📄 查看原檔

---
name: 刪除前必 Read 鐵律
type: feedback
---
任何 rm / Remove-Item / del /F / unlink 執行前，必須：
1. 先用 Read 看目標內容
2. 告訴 Thomas：刪什麼、為什麼、有無備份
3. 取得確認（「刪掉」/「同意刪」）
4. 命令前加註釋 # CONFIRMED-DELETE: 原因

L2 技術強制：pre-delete-guard.py 掛 PreToolUse hook

CLAUDE.md 段落 🟡 計劃中

CC 家慢慢搬家（不一次改完）

6 個月慢慢把硬編碼 D:\Backup\Downloads 改成 D:\ClaudeCode，禁止大批量 sed。

寫新路徑一律用 D:\ClaudeCode\
改舊文件順手機會性替換
大批量替換要你明確說「做一次大掃除」

觸發詞：遷移進度多少了 / 做最終改名

📅 建立：2026-04-14🔄 更新：2026-04-14

Agent 專家 🟢 健康

教會影片剪輯助手

給它影片路徑和剪輯要求，它用 ffmpeg 剪好拼好加背景音樂。

多段剪切、無縫拼接
背景音樂混音
崇拜程序稿片段輸出

觸發詞：剪影片 / 做教會影片

📅 建立：2026-04-01🔄 更新：2026-04-01

📌 完整 169 條由 GitHub Actions + GLM-4-flash 每晚批量生成，成本 0。

🗺️ Claude 讀檔流程

每次你打開 Claude Code，它默認讀什麼？你說話後又讀什麼？看流程圖就懂。

階段一：CC 啟動時（一次性載入）

讀專案 CLAUDE.md
D:\Backup\Downloads\CLAUDE.md
→ 鐵律、永久規則、系統配置。整段貼進系統提示，每次對話都生效。

⬇

讀 MEMORY.md 索引
~/.claude/projects/.../memory/MEMORY.md
→ 這是一張「目錄」，列 169 條記憶每條的一句話描述。用得到才翻具體檔。

⬇

載入 settings.json
.claude/settings.json + 全局 settings
→ 權限白名單、bypassPermissions、hooks 掛鉤。

⬇

掃 Skills / Agents 定義
.claude/commands/*.md + .claude/agents/*.md
→ 只讀 frontmatter（描述），不讀內文。用到才完整載入。

階段二：你說話時（按需讀檔）

你打一句話
例：「幫我剪影片」

⬇

Claude 查 MEMORY.md 索引
看哪些記憶和「剪影片」有關，決定要展開哪些具體檔。

⬇

決定派誰做
→ 簡單任務自己做
→ Skill 觸發詞匹配 → 跑 SOP
→ Agent 描述匹配 → 派子對話做

⬇

工具前 hook 檢查
例：要刪檔 → PreToolUse hook 攔下要你確認。

⬇

回答完 Stop Hook
→ worktree 寫日誌 → master auto-sync（commit + pull --rebase + push）。

📌 小白必懂三件事

1. CLAUDE.md 每次都看 — 要永遠記住的鐵律寫這裡

2. Memory 按需看 — 場景化經驗寫記憶檔

3. Skill / Agent 觸發才看 — 流程寫 skill，角色寫 agent

⚠️ 禁忌：所有東西塞 CLAUDE.md → 每次對話都載入，浪費 context + 規則打架。
✅ 正解：鐵律進 CLAUDE.md；場景進 memory；SOP 寫 skill；角色寫 agent。

🏥 規則健康度

自動掃 169 條記憶 + 22 skills + 10 agents + 26 段 CLAUDE.md。

💡 A/B/C 按鈕怎麼用？
1. 逐張卡片點 A / B / C 選你的決定（右下會出現「已選項目」紫色氣泡）
2. 全選完點氣泡 → 彈視窗顯示生成好的指令
3. 點「複製指令」→ 貼回 Claude Code 對話框 → Claude 逐項執行整改
重點：網頁不會直接動你的檔，必須你貼指令回 Claude 才會執行，安全。

🟢 健康

🟡 小問題

🔴 大問題

📌 MVP 放 4 個示範。完整掃由 GitHub Actions 每週跑 regex + GLM 分析。

🔴 大問題Lesson

feedback_html_deploy.md 職責太多

一個檔塞了：HTML 製作 + 部署 + 中文路徑 + Tab 樣式 — 應拆 3 個。

🟡 小問題Lesson

feedback_recall.md 沒寫觸發詞

Claude 不知道你說「記憶」「recall」會觸發這條。description 建議加。

🔴 大問題CLAUDE.md

CC 家保護鐵律和刪除鐵律部分重疊

兩段都在講「動重要檔前要停下來問」。建議合併或互相引用。

🟡 小問題Skill

多個 skill 硬編碼 D:\Backup\Downloads\

應改用相對路徑或環境變量，否則換電腦就壞（或未來物理改名也壞）。

🔄 雙機同步健康度

GitHub Actions 每天 6 點 NZ 自動檢查。

🟢 最後檢查：2026-04-14 06:00 NZ — 全部正常

檢查項	台式機	筆記本	狀態
最後 push 時間	04-14 14:32	04-13 22:10	🟢
CLAUDE.md MD5	a3f...	a3f...	🟢 一致
MEMORY.md MD5	b7c...	b7c...	🟢 一致
settings.json hooks	4 個	4 個	🟢
auto-sync 最近 3 天	12 次	5 次	🟢
孤兒分支	0	0	🟢

紅燈時怎麼辦

🔴 MD5 不一致 → 可能一台 push 前另一台也改了。到兩機 git log CLAUDE.md 看誰晚，晚的那台 git pull --rebase。

🔴 一機 >24h 沒 push → 那台可能關機或 hook 壞了。開機後應該自動同步。

🌳 Worktree 看板

分支	機器	用途	最後動作	狀態
`claude/2026-04-10-desktop-nas-improve`	台式機	NAS 改進	2026-04-10	🟡 進行中
`claude/youthful-chatelet`	台式機	（未標註）	-	🟡 待合併

📌 資料源：.claude/worktree-logs/ 每個分支最後 Stop Hook 寫入。

📱 手機 Remote Control 禁忌 + 正確做法

⛔ 三大禁忌

1. 直接在 master 改東西
後果：Stop hook auto-sync 會 commit + push，錯了難回滾。
✅ 正確：說「進 worktree 做 XXX」，Claude 自動建 claude/phone-用途-日期。

2. 兩台電腦同時開同名 worktree
後果：合併時 rebase 衝突。
✅ 正確：命名帶機器前綴（phone-/dt-/lp-）。

3. worktree 做完沒合併就開新的
後果：一堆孤兒分支。
✅ 正確：說「合併」或「棄這個 worktree」。

✅ 手機口訣

進：「進 worktree 做 [事情]」

看：「看 worktree 看板」

合：「合併這個 worktree 到 master」

棄：「棄這個 worktree」（會確認你才刪）

📊 成長曲線

過去 7 天新增

總 lessons

總條目

過去 7 天新增的（最新 20 條）

載入中...

最近在教 Claude 什麼（TOP 3）

遠程控制 + 家人電腦 — 24 條
教會影片/PPT 自動化 — 18 條
網頁部署 + Cloudflare — 15 條

📌 Phase 2 加完整圖表。

🔍 觸發詞衝突偵測

🟡 衝突

「備份」同時觸發 2 條規則

feedback_git_backup.md — AI 禁止自動 push
CLAUDE.md 配置備份段 — AI 可自動 push/pull

兩條互相矛盾！Claude 按哪條執行看載入順序，不穩定。

🟢 無衝突

其他 167 條無重複觸發詞

🌐 網站庫存審計

掃描 Cloudflare Pages 所有站，對照 thomastangnz-commits/ 下是否有 GitHub repo。

總站數

✅ 有 repo

❌ 缺 repo

💡 怎麼補？
對缺 repo 的站點擊 「A. 補 repo」 加入購物車，點右下氣泡複製指令貼回 Claude，Claude 會批量：
① gh repo create --private ② git init + 首次 push ③ 寫 auto-deploy workflow ④ 推 production

❌ 缺 repo 的站（違反 CLAUDE.md 鐵律）

✅ 已有 repo 的站

🛡️ 安全守衛

GitHub Actions 每日早 7 點（NZ）自動掃描 thomastangnz-commits 下所有 repo 的 public/private 狀態。發現 public 會立即發郵件到 thomastangnz@gmail.com，附一鍵修復指令。

總 repo

🔒 私人

⚠️ Public

載入中…

📋 全部 repo 清單

🔧 如果發現 public 怎麼辦

1. 打開郵箱 thomastangnz@gmail.com

找標題「⚠️ GitHub 可見性警報」的郵件

2. 複製郵件裡的 gh repo edit ... --visibility private 指令

郵件會列出每個違規 repo 對應的修復命令

3. 貼回 Claude Code 對話框執行

Claude 會逐個改回 private，再回報結果

💡 為什麼這麼設計：雲端排程獨立於兩台電腦，即使 CC 家被駭或本地腳本壞掉，守衛仍在掃。郵件 + 手動貼指令比自動改回安全 — 萬一誤判也不會亂動 repo。