From 2cb9d19442415d1c0db3caa63d719a0a3c2452c7 Mon Sep 17 00:00:00 2001
From: richblack <leo21c@gmail.com>
Date: Tue, 21 Jul 2026 10:55:41 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20CLAUDE.md=20=E5=8A=A0=E3=80=8C=E7=AC=AC?=
 =?UTF-8?q?=E4=B8=80=E9=90=B5=E5=BE=8B=EF=BC=9Awiki=20=E6=98=AF=E5=88=A4?=
 =?UTF-8?q?=E6=BA=96=EF=BC=8C=E4=B8=8D=E5=87=86=E8=B7=B3=E9=81=8E=E3=80=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

leo 2026-07-21：「其他 repos 各自都要警覺不能跳過 wiki」。
hook 只是提醒，鐵律要寫在本 repo AI 開工必讀的地方。
含 grep 查法、三條硬規則、動外部系統前先找現成腳本（別自創方法）。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 CLAUDE.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 6e51c60..5ca8b88 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -50,6 +50,29 @@
 
 ---
 
+## 🔴 第一鐵律：wiki 是判準，不准跳過（2026-07-20/21 leo 兩度點破）
+
+**要查任何東西之前，先搜尋 wiki——用 grep，不是只讀開頭幾行。**
+
+> leo：「花很多力氣去產生 wiki，最重要的就是要可以查詢，**結果要查的時候就跳過，那就白寫了**。」
+> 「重點是你自己的記憶對嗎？而你有按照規定去切實讀 wiki 嗎？」
+
+```bash
+grep -rin "<本題關鍵字>" system-dev/wiki/
+```
+
+**三條硬規則**：
+1. **wiki 與程式碼/歷史文件衝突 → 以 wiki 為準**。程式碼反映「還沒清乾淨」，不等於「還在用」。
+2. wiki 寫「不可動／待廢除／進行中」→ **讀它的解除條件並逐條核對**。那是當時狀態，不是永久禁令。
+3. 翻原文後得到新結論 → **回頭更新 wiki**（wiki 過時是債，要還）。
+
+**動外部系統（部署／curl／wrangler／acr／gh）前**：先找 repo 有沒有**現成腳本或 README 部署段**，
+別自創方法。（實例：2026-07-21 明明有 `npx wrangler deploy` 這條驗過的路，卻自己 curl 硬幹踩坑。）
+
+> hook `wiki-first-search.sh` 會在你查 code／下高風險指令時自動推 wiki 命中行；
+> **但機制只是提醒，判斷是你的責任**。
+
+
 ## Wiki 讀取順序（LLM 記憶系統，CC 維護）
 
 | 檔案 | 時機 | 用途 |