From b027044cb4af6c4b68d1d8637bb2289ad39605c8 Mon Sep 17 00:00:00 2001 From: richblack Date: Tue, 21 Jul 2026 10:55:28 +0800 Subject: [PATCH] =?UTF-8?q?docs(template):=20CLAUDE.md=20=E6=A8=A3?= =?UTF-8?q?=E6=9D=BF=E5=8A=A0=E3=80=8C=E7=AC=AC=E4=B8=80=E9=90=B5=E5=BE=8B?= =?UTF-8?q?=EF=BC=9Awiki=20=E6=98=AF=E5=88=A4=E6=BA=96=EF=BC=8C=E4=B8=8D?= =?UTF-8?q?=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 會攔，但 CLAUDE.md 是各 repo AI 開工必讀處，鐵律要寫在會被讀到的地方。 含：grep 查法、三條硬規則（衝突以 wiki 為準/核對解除條件/回頭更新 wiki）、 動外部系統前先找現成腳本（07-21 curl 硬幹實例）。 註：CLAUDE.md 屬使用者資料檔，update.sh 不覆蓋 → 既有 repo 由總管手動補齊。 Co-Authored-By: Claude Opus 4.8 (1M context) --- template/CLAUDE.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/template/CLAUDE.md b/template/CLAUDE.md index 7290f7e..afb377e 100644 --- a/template/CLAUDE.md +++ b/template/CLAUDE.md @@ -34,6 +34,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 讀取順序 | 檔案 | 時機 | 用途 |