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:
+1
-1
@@ -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
@@ -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
@@ -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` hook(PreToolUse) | 機敏值真寫進 `.claude/wiki/` → exit 2 擋 | **硬攔截(機械偵測)** |
|
| **L3** | `wiki-secret-scan.sh` hook(PreToolUse) | 機敏值真寫進 `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 協議。
|
||||||
|
|
||||||
|
|||||||
@@ -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` hook(PreToolUse) | 機敏值真的寫進 wiki → exit 2 擋 | 硬攔截(機械偵測) |
|
| **L3** | `wiki-secret-scan.sh` hook(PreToolUse) | 機敏值真的寫進 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
|
||||||
|
|||||||
@@ -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
|
||||||
# 架構決策摘要
|
# 架構決策摘要
|
||||||
|
|||||||
@@ -46,7 +46,7 @@ CC 動手前必須有這兩個檔案。找不到就停手。
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## .claude/wiki/ — CC 的記憶空間(CC 維護,人不手動編輯)
|
## system-dev/wiki/ — CC 的記憶空間(CC 維護,人不手動編輯)
|
||||||
|
|
||||||
| 檔案 | 用途 | 更新時機 |
|
| 檔案 | 用途 | 更新時機 |
|
||||||
|------|------|---------|
|
|------|------|---------|
|
||||||
|
|||||||
@@ -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 兜底攔截(自動掃)。
|
||||||
# ────────────────────────────────────────────────────
|
# ────────────────────────────────────────────────────
|
||||||
|
|||||||
Reference in New Issue
Block a user