docs: 校正殘留舊路徑 .claude/wiki → system-dev/wiki(總管裁定路徑筆誤)

wiki 於 1.9.x 已遷出 .claude/、真實慣例為 system-dev/wiki/;把描述當前架構
卻仍寫舊路徑的 doc 一併校正,讓 template 路徑故事一致、避免未來 install 被誤導。

- docs/why.md:雙空間說明的 wiki 路徑。
- docs/wishlist.md:三層機敏防護 L1/L3 的 .wikiignore 與 hook 掃描路徑。
- skills/llm-wiki/SKILL.md:架構圖、L1、維護規則。
- skills/llm-wiki/references/templates.md:CLAUDE.md/INDEX/mistakes/decisions 範本全部路徑。
- template/system-dev/docs/README.md:wiki 記憶空間標題。
- template/system-dev/wiki/.wikiignore:L3 註解。
- CHANGELOG 1.14.0 條目自身用語清乾淨。

保留(刻意不改):install.sh/update.sh/session-start-recall.sh 的舊路徑「遷移偵測」、
CHANGELOG 歷史版本記錄、.gitignore 根目錄自裝忽略——這些本就該指舊路徑。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Claude
2026-07-06 03:06:04 +00:00
parent 9a5219d8bd
commit 989a6fbfed
7 changed files with 20 additions and 20 deletions
+1 -1
View File
@@ -20,7 +20,7 @@
- **原文唯讀 + D16**:只寫 `system-dev/wiki/``journals/`/`pages/` git status 須 0 異動(改了會被 Syncthing 推回 leo 手機污染筆記);精耕知識點、不地毯灌全文。 - **原文唯讀 + D16**:只寫 `system-dev/wiki/``journals/`/`pages/` git status 須 0 異動(改了會被 Syncthing 推回 leo 手機污染筆記);精耕知識點、不地毯灌全文。
- **新增 Logseq 任務 marker 解析(單一真相源)**:`template/system-dev/docs/4-guides/logseq-markers.md`。Logseq 原生任務是**大寫 marker** block`- TODO …``- DOING …``- DONE …`),**不是** GFM `- [ ]`;只抓 checkbox 會漏抓 notes/kb 全部任務(leo 2026-07-04 發現,issue #4 更正)。狀態映射:TODO/LATER→`todo`、DOING/NOW→`in-progress`、WAITING→`blocked`、DONE→`done`、CANCELED/CANCELLED→`closed`;跳過 `:LOGBOOK:…:END:``key:: value` 屬性行。**這份是唯一權威**——vault 萃取(#5)與 tasks→Project 投影(#4)**共用同一套解析,不各寫一份**。marker → 任務卡 frontmatter `task_status` - **新增 Logseq 任務 marker 解析(單一真相源)**:`template/system-dev/docs/4-guides/logseq-markers.md`。Logseq 原生任務是**大寫 marker** block`- TODO …``- DOING …``- DONE …`),**不是** GFM `- [ ]`;只抓 checkbox 會漏抓 notes/kb 全部任務(leo 2026-07-04 發現,issue #4 更正)。狀態映射:TODO/LATER→`todo`、DOING/NOW→`in-progress`、WAITING→`blocked`、DONE→`done`、CANCELED/CANCELLED→`closed`;跳過 `:LOGBOOK:…:END:``key:: value` 屬性行。**這份是唯一權威**——vault 萃取(#5)與 tasks→Project 投影(#4)**共用同一套解析,不各寫一份**。marker → 任務卡 frontmatter `task_status`
- install/update 隨 WIKI 模組帶下 `/wiki-extract``logseq-markers.md` 放共用區,wiki 或 sdd 任一模組在用都拿得到。 - install/update 隨 WIKI 模組帶下 `/wiki-extract``logseq-markers.md` 放共用區,wiki 或 sdd 任一模組在用都拿得到。
- ⚠️ **邊界**:本能力只產 `.claude/wiki`(實作落點 `system-dev/wiki/`卡片給下游機械撈;三元組拉取、KBDB 寫入歸下游 Arcrun ingest(另立 issue),不在此。頂層 SDD:`kb-ingest-architecture`(R1 AI 只萃/R2 萃冪等/R5 Logseq 正確性歸 template)。 - ⚠️ **邊界**:本能力只產 `system-dev/wiki/` 卡片給下游機械撈;三元組拉取、KBDB 寫入歸下游 Arcrun ingest(另立 issue),不在此。頂層 SDD:`kb-ingest-architecture`(R1 AI 只萃/R2 萃冪等/R5 Logseq 正確性歸 template)。
--- ---
+1 -1
View File
@@ -44,7 +44,7 @@ SDD 強制 CC 在動手前先思考:這個修改影響哪些地方?有沒有
**雙空間設計:** **雙空間設計:**
- `docs/`:人寫的原始文件,依照開發生命週期分類 - `docs/`:人寫的原始文件,依照開發生命週期分類
- `.claude/wiki/`:CC 整理的 LLM 友善知識,每次 session 累積 - `system-dev/wiki/`:CC 整理的 LLM 友善知識,每次 session 累積
每次 session 開始,CC 讀 wiki,不需要重新學習。 每次 session 開始,CC 讀 wiki,不需要重新學習。
每次 session 結束,CC 更新 wiki,知識不再消失。 每次 session 結束,CC 更新 wiki,知識不再消失。
+4 -4
View File
@@ -57,15 +57,15 @@ system-dev-template 自身要補的功能。
| 層 | 機制 | 擋什麼 | 性質 | | 層 | 機制 | 擋什麼 | 性質 |
|---|---|---|---| |---|---|---|---|
| **L1** | `.claude/wiki/.wikiignore`glob,像 .gitignore | 整個機敏檔不編入 | 協議(CC 遵守) | | **L1** | `system-dev/wiki/.wikiignore`glob,像 .gitignore | 整個機敏檔不編入 | 協議(CC 遵守) |
| **L2** | 行內標記 `<!-- wiki:ignore -->``<!-- wiki:end -->` | 檔案內某段不編入 | 協議(CC 遵守) | | **L2** | 行內標記 `<!-- wiki:ignore -->``<!-- wiki:end -->` | 檔案內某段不編入 | 協議(CC 遵守) |
| **L3** | `wiki-secret-scan.sh` hookPreToolUse | 機敏值真寫進 `.claude/wiki/` → exit 2 擋 | **硬攔截(機械偵測)** | | **L3** | `wiki-secret-scan.sh` hookPreToolUse | 機敏值真寫進 `system-dev/wiki/` → exit 2 擋 | **硬攔截(機械偵測)** |
L1/L2 是使用者主動標記,L3 是自動兜底——前兩層漏掉時,寫進 wiki 那一刻 regex 攔下(密碼賦值、PEM 私鑰、AWS/GitHub/Slack/Google/Stripe 金鑰、JWT、連線字串帳密、台灣身分證、信用卡號)。 L1/L2 是使用者主動標記,L3 是自動兜底——前兩層漏掉時,寫進 wiki 那一刻 regex 攔下(密碼賦值、PEM 私鑰、AWS/GitHub/Slack/Google/Stripe 金鑰、JWT、連線字串帳密、台灣身分證、信用卡號)。
**已做** **已做**
- `template/.claude/wiki/.wikiignore`L1 範本(預設排除 `.env`/`*.pem`/`*secret*` 等)。 - `template/system-dev/wiki/.wikiignore`L1 範本(預設排除 `.env`/`*.pem`/`*secret*` 等)。
- `template/.claude/hooks/wiki-secret-scan.sh`L3 hook,只掃 `.claude/wiki/**` 寫入,`wiki-secret-ok` 行尾標記可豁免誤判。 - `template/.claude/hooks/wiki-secret-scan.sh`L3 hook,只掃 `system-dev/wiki/**` 寫入,`wiki-secret-ok` 行尾標記可豁免誤判。
- `settings.json`PreToolUse(Write|Edit) 加掛。 - `settings.json`PreToolUse(Write|Edit) 加掛。
- `wiki-init.md` / `wiki-capture.md` / `SKILL.md`:寫入 L1+L2 協議。 - `wiki-init.md` / `wiki-capture.md` / `SKILL.md`:寫入 L1+L2 協議。
+3 -3
View File
@@ -44,7 +44,7 @@ description: >-
│ ├── 4-guides/ │ ├── 4-guides/
│ ├── 5-records/{incidents,test-reports}/ │ ├── 5-records/{incidents,test-reports}/
│ └── 6-user/ │ └── 6-user/
└── .claude/wiki/ ← CC 整理的知識(CC 寫) └── system-dev/wiki/ ← CC 整理的知識(CC 寫)
├── INDEX.md ├── INDEX.md
├── mistakes.md ├── mistakes.md
├── status.md ├── status.md
@@ -63,7 +63,7 @@ description: >-
| 層 | 機制 | 擋什麼 | 性質 | | 層 | 機制 | 擋什麼 | 性質 |
|----|------|--------|------| |----|------|--------|------|
| **L1** | `.claude/wiki/.wikiignore`glob,像 .gitignore | 整個機敏檔不編入 | 協議(CC 遵守) | | **L1** | `system-dev/wiki/.wikiignore`glob,像 .gitignore | 整個機敏檔不編入 | 協議(CC 遵守) |
| **L2** | 行內標記 `<!-- wiki:ignore -->``<!-- wiki:end -->` | 檔案內某段不編入 | 協議(CC 遵守) | | **L2** | 行內標記 `<!-- wiki:ignore -->``<!-- wiki:end -->` | 檔案內某段不編入 | 協議(CC 遵守) |
| **L3** | `wiki-secret-scan.sh` hookPreToolUse | 機敏值真的寫進 wiki → exit 2 擋 | 硬攔截(機械偵測) | | **L3** | `wiki-secret-scan.sh` hookPreToolUse | 機敏值真的寫進 wiki → exit 2 擋 | 硬攔截(機械偵測) |
@@ -148,7 +148,7 @@ Session 結束時固定更新 status.md
## 維護規則 ## 維護規則
1. `docs/` 只讀不改 1. `docs/` 只讀不改
2. `.claude/wiki/` 只增不刪 2. `system-dev/wiki/` 只增不刪
3. `CLAUDE.md` 不增長,超過 100 行就是放錯地方 3. `CLAUDE.md` 不增長,超過 100 行就是放錯地方
4. 分類不確定就問 4. 分類不確定就問
5. 對話結論當場 capture 5. 對話結論當場 capture
+9 -9
View File
@@ -26,7 +26,7 @@
開始任一任務,按順序: 開始任一任務,按順序:
1.`.claude/wiki/status.md`3 分鐘) 1.`system-dev/wiki/status.md`3 分鐘)
2. 確認有對應 SDD`docs/3-specs/` 2. 確認有對應 SDD`docs/3-specs/`
3. 動手前宣告範圍 3. 動手前宣告範圍
4. 完成後更新 wiki 4. 完成後更新 wiki
@@ -37,10 +37,10 @@
| 檔案 | 時機 | 用途 | | 檔案 | 時機 | 用途 |
|------|------|------| |------|------|------|
| `.claude/wiki/status.md` | session 開始第一件事 | 當前進度、下一步 | | `system-dev/wiki/status.md` | session 開始第一件事 | 當前進度、下一步 |
| `.claude/wiki/mistakes.md` | 做新功能前 | 已知誤解 + 快速檢查清單 | | `system-dev/wiki/mistakes.md` | 做新功能前 | 已知誤解 + 快速檢查清單 |
| `.claude/wiki/decisions-summary.md` | 遇到設計判斷時 | 架構決策快速查 | | `system-dev/wiki/decisions-summary.md` | 遇到設計判斷時 | 架構決策快速查 |
| `.claude/wiki/INDEX.md` | 找不到東西時 | wiki 導引 | | `system-dev/wiki/INDEX.md` | 找不到東西時 | wiki 導引 |
--- ---
@@ -96,10 +96,10 @@
--- ---
## .claude/wiki/INDEX.md 範本 ## system-dev/wiki/INDEX.md 範本
```markdown ```markdown
# .claude/wiki/ — [專案名稱] LLM 記憶系統 # system-dev/wiki/ — [專案名稱] LLM 記憶系統
> 新 session 開始時從這裡導航。 > 新 session 開始時從這裡導航。
> 目的:讓 CC 不需要重新學習已知的事。 > 目的:讓 CC 不需要重新學習已知的事。
@@ -122,7 +122,7 @@
--- ---
## .claude/wiki/mistakes.md 範本 ## system-dev/wiki/mistakes.md 範本
```markdown ```markdown
# CC 已知誤解 + 避坑方法 # CC 已知誤解 + 避坑方法
@@ -142,7 +142,7 @@
--- ---
## .claude/wiki/decisions-summary.md 範本 ## system-dev/wiki/decisions-summary.md 範本
```markdown ```markdown
# 架構決策摘要 # 架構決策摘要
+1 -1
View File
@@ -46,7 +46,7 @@ CC 動手前必須有這兩個檔案。找不到就停手。
--- ---
## .claude/wiki/ — CC 的記憶空間(CC 維護,人不手動編輯) ## system-dev/wiki/ — CC 的記憶空間(CC 維護,人不手動編輯)
| 檔案 | 用途 | 更新時機 | | 檔案 | 用途 | 更新時機 |
|------|------|---------| |------|------|---------|
+1 -1
View File
@@ -10,7 +10,7 @@
# <!-- wiki:ignore --> # <!-- wiki:ignore -->
# 這幾行不會被編入 wiki # 這幾行不會被編入 wiki
# <!-- wiki:end --> # <!-- wiki:end -->
# L3 機械底線:萬一機敏值仍被寫進 .claude/wiki/wiki-secret-scan.sh 會 exit 2 擋下。 # L3 機械底線:萬一機敏值仍被寫進 system-dev/wiki/wiki-secret-scan.sh 會 exit 2 擋下。
# #
# 三層的分工:L1 整檔排除(你主動列)|L2 局部遮蔽(你標記)|L3 兜底攔截(自動掃)。 # 三層的分工:L1 整檔排除(你主動列)|L2 局部遮蔽(你標記)|L3 兜底攔截(自動掃)。
# ──────────────────────────────────────────────────── # ────────────────────────────────────────────────────