docs(template): CLAUDE.md 樣板加「第一鐵律:wiki 是判準,不准跳過」

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) <noreply@anthropic.com>
This commit is contained in:
2026-07-21 10:55:28 +08:00
parent 0a04c9c594
commit b027044cb4
+23
View File
@@ -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 過時是債,要還)。
**動外部系統(部署/curlwrangleracrgh)前**:先找 repo 有沒有**現成腳本或 README 部署段**
別自創方法。(實例:2026-07-21 明明有 `npx wrangler deploy` 這條驗過的路,卻自己 curl 硬幹踩坑。)
> hook `wiki-first-search.sh` 會在你查 code/下高風險指令時自動推 wiki 命中行;
> **但機制只是提醒,判斷是你的責任**。
## Wiki 讀取順序
| 檔案 | 時機 | 用途 |