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:
@@ -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 讀取順序
|
## Wiki 讀取順序
|
||||||
|
|
||||||
| 檔案 | 時機 | 用途 |
|
| 檔案 | 時機 | 用途 |
|
||||||
|
|||||||
Reference in New Issue
Block a user