Leo/system-dev-template
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 安裝結構收進 system-dev/(不污染用戶根目錄)+ 舊版自動遷移 + bump 1.9.0

Browse Source 
工具產物原散在用戶根目錄(docs 七層、scripts),又把 wiki/VERSION 寄生在 CC 原生
.claude/ 裡,用戶分不清哪個 docs 是工具的。這版徹底收斂:除 .claude/(settings/
commands/hooks)與 CLAUDE.md 留根,工具所有資料收進 system-dev/。

對應 SDD: system-dev/docs/3-specs/install-layout/(內部記錄,依原則不推)。

- 新結構 system-dev/{VERSION,wiki/,docs/,scripts/};.claude/ 只剩 CC 機制檔
- wiki 改寫產物落點正式化:install 建 system-dev/wiki/cards/(.gitkeep)
- docs 雙語義拆開:工具文件→system-dev/docs/;用戶 raw source 維持原處只讀
- scripts 一開始就裝進 system-dev/scripts/
- 舊版自動遷移雙保險:update.sh 冪等搬移(wiki 含 .git、docs 白名單)
  + session-start hook 偵測舊結構未遷移時提示(low-code 用戶兜底)
- wiki-secret-scan 觸發路徑改 system-dev/wiki/**(否則新結構防護失效)
- 全套路徑引用同步:CLAUDE/SKILL/wiki-*/sdd-*/hooks/INDEX/README(中英)
- 沙盒驗證:遷移含 .git commit 一致、冪等、用戶自填 docs 保留;全 bash -n 過

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
richblack
2026-06-26 15:13:43 +08:00
parent c95705c286
commit ecf1f882c6
27 changed files with 283 additions and 166 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGELOG.md
+14
View File
@@ -10,6 +10,20 @@
--- ---
## 1.9.0 — 安裝結構收進 `system-dev/`（不再污染用戶根目錄）+ 舊版自動遷移
工具產物原本散在用戶根目錄（`docs/` 七層、update 時的 `scripts/`），又把 `wiki/`、`VERSION` 寄生在 CC 原生的 `.claude/` 裡，用戶分不清「哪個 docs 是工具的、哪個是我的」。這版徹底收斂：除了 CC 死綁的 `.claude/`（settings/commands/hooks）和 `CLAUDE.md` 留根，**工具所有資料收進 `system-dev/`**。對應 SDD：`system-dev/docs/3-specs/install-layout/`。
- **新結構**：`system-dev/{VERSION, wiki/, docs/, scripts/}`。`.claude/` 只剩 CC 機制檔。
- **wiki 改寫產物落點正式化**：install 直接建 `system-dev/wiki/cards/`（含 `.gitkeep`），不再讓用戶自己長出來、自行 git init。
- **docs 雙語義拆開**：工具文件 → `system-dev/docs/`；**用戶 raw source（原始文件來源）維持原處**（用戶的 `docs/`、Logseq `pages/+journals/`、Obsidian vault），工具只讀、不搬。
- **scripts 一開始就裝**：install 把 install.sh/update.sh 放進 `system-dev/scripts/`，之後更新直接 `bash system-dev/scripts/update.sh`。
- **舊版自動遷移（雙保險）**：① update.sh 偵測舊位置 → 冪等搬進 `system-dev/`（wiki 含 `cards/` 與內含 `.git` 一起搬，docs 只搬工具白名單、不動用戶自填內容）；② session-start hook 偵測到舊結構未遷移 → 出聲提示，CC 可當場代為遷移。給「只會叫 CC 做事」的 low-code 用戶兜底。
- **機敏防護路徑跟進**：`wiki-secret-scan.sh` 觸發路徑改 `system-dev/wiki/**`（否則新結構下寫入不啟動、防護失效）。
- 全套路徑引用同步更新：CLAUDE.md、SKILL.md、wiki-init、wiki-recall、wiki-capture、sdd-check、sdd-guard、session-start-recall、INDEX、decisions-summary、README（中英）。
> **升級提醒**：舊用戶跑一次 `update.sh` 即自動遷移；沒跑也會在開 session 時被 hook 提示。屬向下相容的中版號（非破壞性手動遷移）。
## 1.8.2 — 修 update.sh 在 `curl | bash` 下崩潰（bash 3.2 多位元組字元，1.7.0 漏修到的同類 bug） ## 1.8.2 — 修 update.sh 在 `curl | bash` 下崩潰（bash 3.2 多位元組字元，1.7.0 漏修到的同類 bug）
1.7.0 修了 install.sh 的「多位元組字元旁變數要用 `${VAR}` 包」，但 update.sh 第 54 行漏網： 1.7.0 修了 install.sh 的「多位元組字元旁變數要用 `${VAR}` 包」，但 update.sh 第 54 行漏網：
README.en.md
+9 -9
View File
@@ -13,7 +13,7 @@ This template solves both problems with two systems:
| System | What it solves | Core mechanism | | System | What it solves | Core mechanism |
|--------|----------------|----------------| |--------|----------------|----------------|
| **SDD system** | Global view, think before doing | No code change without a `design.md` + `tasks.md` first | | **SDD system** | Global view, think before doing | No code change without a `design.md` + `tasks.md` first |
| **LLM Wiki** | Memory that compounds, ordered docs | Two spaces: raw source (human-written) + `.claude/wiki/` (AI-curated) | | **LLM Wiki** | Memory that compounds, ordered docs | Two spaces: raw source (human-written) + `system-dev/wiki/` (AI-curated) |
> **Not just code projects, not just Claude Code.** LLM Wiki now also recognizes **Logseq / Obsidian vaults** — > **Not just code projects, not just Claude Code.** LLM Wiki now also recognizes **Logseq / Obsidian vaults** —
> at install time it auto-detects which kind of folder you're in, writes the matching "raw source" into `CLAUDE.md`, > at install time it auto-detects which kind of folder you're in, writes the matching "raw source" into `CLAUDE.md`,
@@ -92,7 +92,7 @@ It first compares your version with the latest, tells you **which new features y
| 🔒 **Never touch** your content and settings | `wiki/status.md`, `mistakes.md`, `decisions-summary.md`, `.wikiignore`, `settings.json`, `CLAUDE.md` | | 🔒 **Never touch** your content and settings | `wiki/status.md`, `mistakes.md`, `decisions-summary.md`, `.wikiignore`, `settings.json`, `CLAUDE.md` |
> **Why use curl the first time?** Old installs don't have `update.sh` locally yet, so the first run has to fetch it from the remote. > **Why use curl the first time?** Old installs don't have `update.sh` locally yet, so the first run has to fetch it from the remote.
> After running, it installs itself to `scripts/update.sh`, so **next time just run** `bash scripts/update.sh` — no more curl. > After running, it installs itself to `system-dev/scripts/update.sh`, so **next time just run** `bash system-dev/scripts/update.sh` — no more curl.
Updates only touch "installed modules" (wiki installed → wiki updated; SDD installed → SDD updated), detected automatically. Updates only touch "installed modules" (wiki installed → wiki updated; SDD installed → SDD updated), detected automatically.
If `settings.json` is missing a hook that only the new version has, it won't change your settings for you — but it will **list them at the end** as a reminder to add them manually (it never edits your settings without asking). If `settings.json` is missing a hook that only the new version has, it won't change your settings for you — but it will **list them at the end** as a reminder to add them manually (it never edits your settings without asking).
@@ -113,7 +113,7 @@ Now `install.sh` **auto-detects the folder type** before creating `CLAUDE.md`, a
| Neither | Regular project | `docs/` (original behavior) | | Neither | Regular project | `docs/` (original behavior) |
The declaration written into `CLAUDE.md` is **an instruction for the AI** — it tells the curator "here's where the raw source is, read only from there when curating the wiki", The declaration written into `CLAUDE.md` is **an instruction for the AI** — it tells the curator "here's where the raw source is, read only from there when curating the wiki",
and for vaults it **explicitly forbids moving, renaming, or re-classifying `.md` files**; curation output always goes only into `.claude/wiki/`. and for vaults it **explicitly forbids moving, renaming, or re-classifying `.md` files**; curation output always goes only into `system-dev/wiki/`.
This way, even with a note vault, the original structure stays intact and your notes never become unreadable. This way, even with a note vault, the original structure stays intact and your notes never become unreadable.
> **Already have a `CLAUDE.md`?** It's never overwritten (the "don't touch what exists" principle). Instead, the declaration you should add is **listed at the end** of the install for you to paste manually. > **Already have a `CLAUDE.md`?** It's never overwritten (the "don't touch what exists" principle). Instead, the declaration you should add is **listed at the end** of the install for you to paste manually.
@@ -123,16 +123,16 @@ This way, even with a note vault, the original structure stays intact and your n
## Cowork can curate wikis too ## Cowork can curate wikis too
The wiki curator is no longer limited to Claude Code in the terminal — **claude.ai's Cowork** can do it too. The wiki curator is no longer limited to Claude Code in the terminal — **claude.ai's Cowork** can do it too.
`docs/SKILL.md` provides a skill for Cowork (`wiki-cowork-scan`) that **shares the same rules** as CC's `/wiki-init` and `/wiki-capture`: `system-dev/docs/SKILL.md` provides a skill for Cowork (`wiki-cowork-scan`) that **shares the same rules** as CC's `/wiki-init` and `/wiki-capture`:
- Scans every folder under `~/Documents` that has system-dev-template installed (i.e. has a `.claude/wiki/`) - Scans every folder under `~/Documents` that has system-dev-template installed (i.e. has a `system-dev/wiki/`)
- Uses the **same detection logic as `install.sh`** to decide whether each folder is a regular project / Logseq / Obsidian - Uses the **same detection logic as `install.sh`** to decide whether each folder is a regular project / Logseq / Obsidian
- Reads only the raw source and only appends to `.claude/wiki/` (no overwrite, no delete); **never touches** raw source, `CLAUDE.md`, `logseq/`, `.obsidian/`, `assets/` - Reads only the raw source and only appends to `system-dev/wiki/` (no overwrite, no delete); **never touches** raw source, `CLAUDE.md`, `logseq/`, `.obsidian/`, `assets/`
**CC and Cowork share an identical output format**, so whatever one curates, the other sees and skips or supplements — no duplication, no overwriting. **CC and Cowork share an identical output format**, so whatever one curates, the other sees and skips or supplements — no duplication, no overwriting.
Great for a scheduled Cowork run that keeps every wiki on your machine up to date automatically. Great for a scheduled Cowork run that keeps every wiki on your machine up to date automatically.
> To use it: give `docs/SKILL.md` to your Cowork as a skill reference, then tell it "curate the wiki". > To use it: give `system-dev/docs/SKILL.md` to your Cowork as a skill reference, then tell it "curate the wiki".
--- ---
@@ -189,7 +189,7 @@ Norms are no longer just soft reminders in `CLAUDE.md`; there's a backstop:
|------|------| |------|------|
| `session-start-recall.sh` | Auto-injects the key points of `status` at session start — doesn't rely on CC remembering | | `session-start-recall.sh` | Auto-injects the key points of `status` at session start — doesn't rely on CC remembering |
| `sdd-guard.sh` | Touching a code file with no SDD → block (exit 2); the automated version of `/sdd-check` | | `sdd-guard.sh` | Touching a code file with no SDD → block (exit 2); the automated version of `/sdd-check` |
| `wiki-secret-scan.sh` | A sensitive value about to be written into `.claude/wiki/` → block (exit 2); a mechanical backstop for passwords/keys/PII | | `wiki-secret-scan.sh` | A sensitive value about to be written into `system-dev/wiki/` → block (exit 2); a mechanical backstop for passwords/keys/PII |
| `pre-write-guard.sh` | Skeleton for project-specific bans (disabled by default; takes effect once you fill in a pattern) | | `pre-write-guard.sh` | Skeleton for project-specific bans (disabled by default; takes effect once you fill in a pattern) |
--- ---
@@ -200,7 +200,7 @@ Like `.gitignore`, it keeps content you don't want in the wiki (passwords, keys,
| Layer | Mechanism | What it blocks | Nature | | Layer | Mechanism | What it blocks | Nature |
|-------|-----------|----------------|--------| |-------|-----------|----------------|--------|
| **L1** | `.claude/wiki/.wikiignore` (glob) | An entire sensitive file is not indexed | Protocol (CC complies) | | **L1** | `system-dev/wiki/.wikiignore` (glob) | An entire sensitive file is not indexed | Protocol (CC complies) |
| **L2** | Inline markers `<!-- wiki:ignore -->`…`<!-- wiki:end -->` | A section within a file is not indexed | Protocol (CC complies) | | **L2** | Inline markers `<!-- wiki:ignore -->`…`<!-- wiki:end -->` | A section within a file is not indexed | Protocol (CC complies) |
| **L3** | `wiki-secret-scan.sh` hook | A sensitive value actually being written into the wiki → exit 2 blocks it | **Hard interception (mechanical detection)** | | **L3** | `wiki-secret-scan.sh` hook | A sensitive value actually being written into the wiki → exit 2 blocks it | **Hard interception (mechanical detection)** |
README.md
+38 -28
View File
@@ -13,7 +13,7 @@ CC 是個優秀的工程師，但不是個好的專案經理。它會猛衝完
| 系統 | 解決什麼 | 核心機制 | | 系統 | 解決什麼 | 核心機制 |
|------|---------|---------| |------|---------|---------|
| **SDD 系統** | 全局觀、先想再做 | 動手前必須有 design.md + tasks.md | | **SDD 系統** | 全局觀、先想再做 | 動手前必須有 design.md + tasks.md |
| **LLM Wiki** | 記憶累積、文件有序 | 雙空間：原始文件（人寫）+ .claude/wiki/（AI 整理）| | **LLM Wiki** | 記憶累積、文件有序 | 雙空間：原始文件（人寫）+ system-dev/wiki/（AI 整理）|
> **不只程式碼專案、不只 Claude Code。** LLM Wiki 現在也認得 **Logseq / Obsidian vault**—— > **不只程式碼專案、不只 Claude Code。** LLM Wiki 現在也認得 **Logseq / Obsidian vault**——
> 安裝時自動偵測你在哪種資料夾，把對應的「原始文件來源」寫進 `CLAUDE.md`，整理 wiki 時只讀那裡、 > 安裝時自動偵測你在哪種資料夾，把對應的「原始文件來源」寫進 `CLAUDE.md`，整理 wiki 時只讀那裡、
@@ -91,7 +91,7 @@ curl -sSL https://raw.githubusercontent.com/uncle6me-web/system-dev-template/mai
| 🔒 **完全不碰**你的內容與設定 | `wiki/status.md`、`mistakes.md`、`decisions-summary.md`、`.wikiignore`、`settings.json`、`CLAUDE.md` | | 🔒 **完全不碰**你的內容與設定 | `wiki/status.md`、`mistakes.md`、`decisions-summary.md`、`.wikiignore`、`settings.json`、`CLAUDE.md` |
> **為什麼第一次要用 curl？** 舊版本機還沒有 `update.sh`，所以第一次得從遠端抓它下來跑。 > **為什麼第一次要用 curl？** 舊版本機還沒有 `update.sh`，所以第一次得從遠端抓它下來跑。
> 跑完它會把自己也裝進 `scripts/update.sh`，**之後更新直接跑** `bash scripts/update.sh` 就好，不用再 curl。 > 跑完它會把自己也裝進 `system-dev/scripts/update.sh`，**之後更新直接跑** `bash system-dev/scripts/update.sh` 就好，不用再 curl。
更新只會動「已安裝的模組」（裝了 wiki 就更新 wiki，裝了 SDD 就更新 SDD），偵測自動完成。 更新只會動「已安裝的模組」（裝了 wiki 就更新 wiki，裝了 SDD 就更新 SDD），偵測自動完成。
若 `settings.json` 缺了新版才有的 hook，它不會幫你改設定，但會在結尾**列出來提醒你手動補**（不擅自動你的設定）。 若 `settings.json` 缺了新版才有的 hook，它不會幫你改設定，但會在結尾**列出來提醒你手動補**（不擅自動你的設定）。
@@ -112,7 +112,7 @@ LLM Wiki 原本假設「原始文件放在 `docs/`」，但 Logseq、Obsidian
| 都沒有 | 一般專案 | `docs/`（維持原行為）| | 都沒有 | 一般專案 | `docs/`（維持原行為）|
寫進 `CLAUDE.md` 的這段宣告是**給 AI 讀的指令**——它告訴整理者「原始文件在哪、整理 wiki 時只讀那裡」， 寫進 `CLAUDE.md` 的這段宣告是**給 AI 讀的指令**——它告訴整理者「原始文件在哪、整理 wiki 時只讀那裡」，
而且對 vault **明令不得搬動、改名、重新分類 `.md`**，整理結果一律只寫進 `.claude/wiki/`。 而且對 vault **明令不得搬動、改名、重新分類 `.md`**，整理結果一律只寫進 `system-dev/wiki/`。
這樣面對筆記 vault 也不會破壞它原本的結構，筆記不會變得不可讀。 這樣面對筆記 vault 也不會破壞它原本的結構，筆記不會變得不可讀。
> **已有 `CLAUDE.md`？** 一律不覆蓋（維持「已有的不動」原則），改在安裝結尾**列出該補的宣告**提醒你手動貼。 > **已有 `CLAUDE.md`？** 一律不覆蓋（維持「已有的不動」原則），改在安裝結尾**列出該補的宣告**提醒你手動貼。
@@ -122,44 +122,54 @@ LLM Wiki 原本假設「原始文件放在 `docs/`」，但 Logseq、Obsidian
## Cowork 也能整理 wiki ## Cowork 也能整理 wiki
整理 wiki 的人不再只有終端機裡的 Claude Code——**claude.ai 的 Cowork** 也可以。 整理 wiki 的人不再只有終端機裡的 Claude Code——**claude.ai 的 Cowork** 也可以。
`docs/SKILL.md` 提供一個給 Cowork 用的 skill（`wiki-cowork-scan`），它與 CC 的 `/wiki-init`、`/wiki-capture` `system-dev/docs/SKILL.md` 提供一個給 Cowork 用的 skill（`wiki-cowork-scan`），它與 CC 的 `/wiki-init`、`/wiki-capture`
**共用同一套規則**： **共用同一套規則**：
- 掃描 `~/Documents` 下所有裝了 system-dev-template（含 `.claude/wiki/`）的資料夾 - 掃描 `~/Documents` 下所有裝了 system-dev-template（含 `system-dev/wiki/`）的資料夾
- 用**和 `install.sh` 一致的偵測邏輯**判斷每個資料夾是一般專案 / Logseq / Obsidian - 用**和 `install.sh` 一致的偵測邏輯**判斷每個資料夾是一般專案 / Logseq / Obsidian
- 只讀 raw source、只往 `.claude/wiki/` 增補（不覆蓋、不刪除），**絕不動** raw source、`CLAUDE.md`、`logseq/`、`.obsidian/`、`assets/` - 只讀 raw source、只往 `system-dev/wiki/` 增補（不覆蓋、不刪除），**絕不動** raw source、`CLAUDE.md`、`logseq/`、`.obsidian/`、`assets/`
**CC 與 Cowork 輸出格式相同**，任一方整理過的內容，另一方看到就跳過或補充，不重複也不覆蓋。 **CC 與 Cowork 輸出格式相同**，任一方整理過的內容，另一方看到就跳過或補充，不重複也不覆蓋。
適合掛在 Cowork 的定期排程，讓本機所有 wiki 自動保持更新。 適合掛在 Cowork 的定期排程，讓本機所有 wiki 自動保持更新。
> 想用：把 `docs/SKILL.md` 提供給你的 Cowork 當 skill 參考，再對它說「整理 wiki」即可。 > 想用：把 `system-dev/docs/SKILL.md` 提供給你的 Cowork 當 skill 參考，再對它說「整理 wiki」即可。
--- ---
## 目錄說明 ## 安裝後，你的專案會長這樣
> 設計原則：除了 CC 原生的 `.claude/` 和 `CLAUDE.md` 留在根目錄，**工具的所有資料都收進 `system-dev/`**，
> 不在你的根目錄撒一堆資料夾、也不跟你自己的 `docs/` 混在一起。
```
你的專案/
├── CLAUDE.md ← 導航牌（CC 開 session 自動讀，必須留根）
├── .claude/ ← 只放 CC 原生機制檔
│ ├── settings.json ← 掛 hooks
│ ├── commands/ ← Slash commands（/wiki-init 等）
│ └── hooks/ ← 硬攔截（接關 + SDD 協議 + wiki 機敏掃描）
├── system-dev/ ← 工具所有資料收這裡
│ ├── VERSION
│ ├── wiki/ ← CC 的記憶空間（含 cards/ 改寫產物落點、.wikiignore）
│ ├── docs/ ← 文件結構（六層分類 + SKILL.md）
│ └── scripts/ ← install.sh / update.sh（裝好就在這，下次直接跑）
└── （你自己的檔案 / docs / 筆記 vault —— 工具只讀、不搬、不碰）
```
## 這個 repo 自己的目錄
``` ```
system-dev-template/ system-dev-template/
├── template/ ← 複製到新專案的骨架 ├── template/ ← 發佈源：install/update 從這裡抓檔
│ ├── CLAUDE.md ← 填空版導航牌 │ ├── CLAUDE.md ← 填空版導航牌（落到用戶根目錄）
│ ├── docs/ ← 文件結構（六層分類） │ ├── .claude/ ← commands/ + hooks/（落到用戶 .claude/）
│ └── .claude/ │ └── system-dev/ ← VERSION + wiki/ + docs/（落到用戶 system-dev/）
│ ├── wiki/ ← CC 的記憶空間（含 .wikiignore 機敏排除）
│ ├── commands/ ← Slash commands
│ ├── hooks/ ← 硬攔截（接關 + SDD 協議 + wiki 機敏掃描）
│ └── settings.json ← 掛 hooks（install.sh 依模組組裝）
│
├── skills/ ├── skills/
│ └── llm-wiki/ ← 複製到 Legacy-Workspace/.claude/skills/ │ └── llm-wiki/ ← 複製到 Legacy-Workspace/.claude/skills/
│
├── scripts/ ├── scripts/
│ ├── install.sh ← 已有專案接入腳本 │ ├── install.sh ← 已有專案接入腳本
│ └── update.sh ← 舊版一鍵更新（只換模板，不碰你的資料） │ └── update.sh ← 舊版一鍵更新（含舊結構自動遷移）
│ └── docs/ ← 這個 repo 自己的說明（why.md、wishlist.md…）
└── docs/ ← 這個 repo 自己的說明
├── why.md ← 設計理念
├── wishlist.md ← 待補功能與已完成記錄
└── SKILL.md ← 給 claude.ai Cowork 的 wiki 整理 skill（wiki-cowork-scan）
``` ```
--- ---
@@ -189,7 +199,7 @@ system-dev-template/
|------|------| |------|------|
| `session-start-recall.sh` | 開 session 自動注入 status 重點，不靠 CC 自覺 | | `session-start-recall.sh` | 開 session 自動注入 status 重點，不靠 CC 自覺 |
| `sdd-guard.sh` | 動 code 檔但沒有任何 SDD → 攔（exit 2），對應 `/sdd-check` 的自動版 | | `sdd-guard.sh` | 動 code 檔但沒有任何 SDD → 攔（exit 2），對應 `/sdd-check` 的自動版 |
| `wiki-secret-scan.sh` | 機敏值要寫進 `.claude/wiki/` → 攔（exit 2），密碼/金鑰/個資的機械底線 | | `wiki-secret-scan.sh` | 機敏值要寫進 `system-dev/wiki/` → 攔（exit 2），密碼/金鑰/個資的機械底線 |
| `pre-write-guard.sh` | 專案自訂禁令範本骨架（預設停用，填 pattern 才生效）| | `pre-write-guard.sh` | 專案自訂禁令範本骨架（預設停用，填 pattern 才生效）|
--- ---
@@ -200,7 +210,7 @@ system-dev-template/
| 層 | 機制 | 擋什麼 | 性質 | | 層 | 機制 | 擋什麼 | 性質 |
|----|------|--------|------| |----|------|--------|------|
| **L1** | `.claude/wiki/.wikiignore`（glob） | 整個機敏檔不編入 | 協議（CC 遵守）| | **L1** | `system-dev/wiki/.wikiignore`（glob） | 整個機敏檔不編入 | 協議（CC 遵守）|
| **L2** | 行內標記 `<!-- wiki:ignore -->`…`<!-- wiki:end -->` | 檔案內某段不編入 | 協議（CC 遵守）| | **L2** | 行內標記 `<!-- wiki:ignore -->`…`<!-- wiki:end -->` | 檔案內某段不編入 | 協議（CC 遵守）|
| **L3** | `wiki-secret-scan.sh` hook | 機敏值真的寫進 wiki → exit 2 擋 | **硬攔截（機械偵測）**| | **L3** | `wiki-secret-scan.sh` hook | 機敏值真的寫進 wiki → exit 2 擋 | **硬攔截（機械偵測）**|
docs/SKILL.md
+8 -8
View File
@@ -12,7 +12,7 @@ description: "掃描本機 Documents 下所有裝了 system-dev-template 的資
| 層 | 規則 | | 層 | 規則 |
|------------|-------------------------------------------| |------------|-------------------------------------------|
| raw source | 只讀，不動 | | raw source | 只讀，不動 |
| `.claude/wiki/` | 唯一輸出地點，只增不覆 | | `system-dev/wiki/` | 唯一輸出地點，只增不覆 |
| `CLAUDE.md` | 不動 | | `CLAUDE.md` | 不動 |
| `logseq/`、`.obsidian/`、`assets/` | 絕對不動 | | `logseq/`、`.obsidian/`、`assets/` | 絕對不動 |
@@ -22,12 +22,12 @@ description: "掃描本機 Documents 下所有裝了 system-dev-template 的資
## 第一步：發現所有目標資料夾 ## 第一步：發現所有目標資料夾
掃描 `~/Documents`（遞迴深度 3 層），找出所有含 `.claude/wiki/` 的資料夾。 掃描 `~/Documents`（遞迴深度 3 層），找出所有含 `system-dev/wiki/` 的資料夾。
``` ```
~/Documents/ ~/Documents/
project-a/.claude/wiki/ ← ✅ 目標 project-a/system-dev/wiki/ ← ✅ 目標
Logseq/.claude/wiki/ ← ✅ 目標 Logseq/system-dev/wiki/ ← ✅ 目標
其他資料夾/ ← ❌ 跳過 其他資料夾/ ← ❌ 跳過
``` ```
@@ -37,7 +37,7 @@ description: "掃描本機 Documents 下所有裝了 system-dev-template 的資
## 第二步：對每個資料夾偵測 vault 類型 ## 第二步：對每個資料夾偵測 vault 類型
進入每個目標資料夾的**根目錄**（`.claude/wiki/` 的上兩層），依序判斷： 進入每個目標資料夾的**根目錄**（`system-dev/wiki/` 的上兩層），依序判斷：
### 判斷順序（與 install.sh 一致） ### 判斷順序（與 install.sh 一致）
@@ -60,7 +60,7 @@ else
## 第三步：讀取現有 wiki 狀態 ## 第三步：讀取現有 wiki 狀態
進入 `.claude/wiki/`，讀取： 進入 `system-dev/wiki/`，讀取：
- `INDEX.md`：目前已有哪些 wiki 頁面 - `INDEX.md`：目前已有哪些 wiki 頁面
- `status.md`：上次整理時間、進度 - `status.md`：上次整理時間、進度
@@ -228,6 +228,6 @@ cards/<bucket>/
- ❌ 修改任何 raw source 檔案 - ❌ 修改任何 raw source 檔案
- ❌ 修改 `CLAUDE.md` - ❌ 修改 `CLAUDE.md`
- ❌ 動 `logseq/`、`.obsidian/`、`assets/` 資料夾 - ❌ 動 `logseq/`、`.obsidian/`、`assets/` 資料夾
- ❌ 刪除 `.claude/wiki/` 裡已有的頁面（只增補，不刪除） - ❌ 刪除 `system-dev/wiki/` 裡已有的頁面（只增補，不刪除）
- ❌ 把機敏資訊（密碼、金鑰、個資）寫進 wiki（遇到跳過並記錄） - ❌ 把機敏資訊（密碼、金鑰、個資）寫進 wiki（遇到跳過並記錄）
- ❌ 整理沒有 `.claude/wiki/` 的資料夾（那不是這個 skill 的目標） - ❌ 整理沒有 `system-dev/wiki/` 的資料夾（那不是這個 skill 的目標）
scripts/install.sh
+55 -33
View File
@@ -27,6 +27,8 @@ t() { if [ "$IS_ZH" = "yes" ]; then printf '%s\n' "$1"; else printf '%s\n' "$2";
tn() { if [ "$IS_ZH" = "yes" ]; then printf '%s' "$1"; else printf '%s' "$2"; fi; } tn() { if [ "$IS_ZH" = "yes" ]; then printf '%s' "$1"; else printf '%s' "$2"; fi; }
REPO_URL="https://raw.githubusercontent.com/uncle6me-web/system-dev-template/main/template" REPO_URL="https://raw.githubusercontent.com/uncle6me-web/system-dev-template/main/template"
# install.sh / update.sh 住在 main/scripts/（不在 template/）。
SCRIPTS_URL="https://raw.githubusercontent.com/uncle6me-web/system-dev-template/main/scripts"
CREATED=() CREATED=()
SKIPPED=() SKIPPED=()
@@ -164,7 +166,7 @@ BLOCK
if [ "$IS_VAULT" = "yes" ]; then if [ "$IS_VAULT" = "yes" ]; then
cat <<BLOCK cat <<BLOCK
- 這是 **${VAULT_TYPE} 筆記庫**：保留它原本的目錄與檔名慣例，**不得搬動、改名、重新分類** \`.md\` 檔， - 這是 **${VAULT_TYPE} 筆記庫**：保留它原本的目錄與檔名慣例，**不得搬動、改名、重新分類** \`.md\` 檔，
以免破壞筆記軟體結構造成筆記不可讀。整理只在 \`.claude/wiki/\` 產出，**不動 raw source 本身**。 以免破壞筆記軟體結構造成筆記不可讀。整理只在 \`system-dev/wiki/\` 產出，**不動 raw source 本身**。
BLOCK BLOCK
fi fi
else else
@@ -191,7 +193,7 @@ BLOCK
if [ "$IS_VAULT" = "yes" ]; then if [ "$IS_VAULT" = "yes" ]; then
cat <<BLOCK cat <<BLOCK
- This is a **${VAULT_TYPE} note vault**: keep its original directory and file-naming conventions. **Do not move, rename, or re-classify** \`.md\` files, - This is a **${VAULT_TYPE} note vault**: keep its original directory and file-naming conventions. **Do not move, rename, or re-classify** \`.md\` files,
or you'll break the note-app structure and make notes unreadable. Curation output goes only into \`.claude/wiki/\`; **never touch the raw source itself**. or you'll break the note-app structure and make notes unreadable. Curation output goes only into \`system-dev/wiki/\`; **never touch the raw source itself**.
BLOCK BLOCK
fi fi
fi fi
@@ -218,26 +220,39 @@ download_if_missing() {
fi fi
} }
# ── 共用結構（兩個模組都需要 docs 分類 + .claude）── # ── 共用結構 ──────────────────────────────────────
create_dir "docs/1-vision" # 工具自己的文件骨架收進 system-dev/docs/（不污染用戶根目錄、不跟用戶自己的 docs/ 混）。
create_dir "docs/2-architecture/decisions" # 注意語義分離：這裡的 system-dev/docs/ 是「工具文件」；用戶的 raw source（原始文件）
create_dir "docs/4-guides" # 另有其處（見上方 vault 偵測），工具只讀、不搬。
create_dir "docs/5-records/incidents" # .claude/ 只留 CC 死綁的 commands/ + hooks/，工具資料一律不放這。
create_dir "docs/5-records/test-reports" create_dir "system-dev/docs/1-vision"
create_dir "docs/6-user" create_dir "system-dev/docs/2-architecture/decisions"
create_dir "system-dev/docs/4-guides"
create_dir "system-dev/docs/5-records/incidents"
create_dir "system-dev/docs/5-records/test-reports"
create_dir "system-dev/docs/6-user"
create_dir ".claude/commands" create_dir ".claude/commands"
create_dir ".claude/hooks" create_dir ".claude/hooks"
download_if_missing "docs/README.md" "$REPO_URL/docs/README.md" download_if_missing "system-dev/docs/README.md" "$REPO_URL/system-dev/docs/README.md"
# 工具版號：放 system-dev/，不寄生 .claude/。
download_if_missing "system-dev/VERSION" "$REPO_URL/system-dev/VERSION"
# ── WIKI 模組 ───────────────────────────────────── # ── WIKI 模組 ─────────────────────────────────────
# wiki 是工具資料 → 放 system-dev/wiki/（不放 .claude/）。
# commands/ 與 hooks/ 是 CC 機制檔 → 維持 .claude/。
if $WANT_WIKI; then if $WANT_WIKI; then
create_dir ".claude/wiki" create_dir "system-dev/wiki"
download_if_missing ".claude/wiki/INDEX.md" "$REPO_URL/.claude/wiki/INDEX.md" download_if_missing "system-dev/wiki/INDEX.md" "$REPO_URL/system-dev/wiki/INDEX.md"
download_if_missing ".claude/wiki/TAXONOMY.md" "$REPO_URL/.claude/wiki/TAXONOMY.md" download_if_missing "system-dev/wiki/TAXONOMY.md" "$REPO_URL/system-dev/wiki/TAXONOMY.md"
download_if_missing ".claude/wiki/status.md" "$REPO_URL/.claude/wiki/status.md" download_if_missing "system-dev/wiki/status.md" "$REPO_URL/system-dev/wiki/status.md"
download_if_missing ".claude/wiki/mistakes.md" "$REPO_URL/.claude/wiki/mistakes.md" download_if_missing "system-dev/wiki/mistakes.md" "$REPO_URL/system-dev/wiki/mistakes.md"
download_if_missing ".claude/wiki/decisions-summary.md" "$REPO_URL/.claude/wiki/decisions-summary.md" download_if_missing "system-dev/wiki/decisions-summary.md" "$REPO_URL/system-dev/wiki/decisions-summary.md"
download_if_missing ".claude/wiki/.wikiignore" "$REPO_URL/.claude/wiki/.wikiignore" download_if_missing "system-dev/wiki/.wikiignore" "$REPO_URL/system-dev/wiki/.wikiignore"
# wiki 改寫產物（AI 自讀定稿卡片）的正式落點：由工具建好，不靠用戶自救。
create_dir "system-dev/wiki/cards"
[ -f "system-dev/wiki/cards/.gitkeep" ] || { : > "system-dev/wiki/cards/.gitkeep"; CREATED+=("system-dev/wiki/cards/.gitkeep"); }
download_if_missing ".claude/commands/wiki-init.md" "$REPO_URL/.claude/commands/wiki-init.md" download_if_missing ".claude/commands/wiki-init.md" "$REPO_URL/.claude/commands/wiki-init.md"
download_if_missing ".claude/commands/wiki-capture.md" "$REPO_URL/.claude/commands/wiki-capture.md" download_if_missing ".claude/commands/wiki-capture.md" "$REPO_URL/.claude/commands/wiki-capture.md"
@@ -250,20 +265,27 @@ if $WANT_WIKI; then
# Cowork（claude.ai）整理 wiki 用的 skill：與 CC 的 /wiki-init 共用同一套規則 # Cowork（claude.ai）整理 wiki 用的 skill：與 CC 的 /wiki-init 共用同一套規則
# （含 typed-edge、frontmatter 標籤、gloss）。沒這支 → claude.ai 來掃時身上沒規則。 # （含 typed-edge、frontmatter 標籤、gloss）。沒這支 → claude.ai 來掃時身上沒規則。
download_if_missing "docs/SKILL.md" "$REPO_URL/docs/SKILL.md" download_if_missing "system-dev/docs/SKILL.md" "$REPO_URL/system-dev/docs/SKILL.md"
fi fi
# ── SDD 模組 ────────────────────────────────────── # ── SDD 模組 ──────────────────────────────────────
if $WANT_SDD; then if $WANT_SDD; then
create_dir "docs/3-specs" create_dir "system-dev/docs/3-specs"
download_if_missing "docs/3-specs/TEMPLATE-sdd/design.md" "$REPO_URL/docs/3-specs/TEMPLATE-sdd/design.md" download_if_missing "system-dev/docs/3-specs/TEMPLATE-sdd/design.md" "$REPO_URL/system-dev/docs/3-specs/TEMPLATE-sdd/design.md"
download_if_missing "docs/3-specs/TEMPLATE-sdd/tasks.md" "$REPO_URL/docs/3-specs/TEMPLATE-sdd/tasks.md" download_if_missing "system-dev/docs/3-specs/TEMPLATE-sdd/tasks.md" "$REPO_URL/system-dev/docs/3-specs/TEMPLATE-sdd/tasks.md"
download_if_missing "docs/2-architecture/decisions/TEMPLATE-adr.md" "$REPO_URL/docs/2-architecture/decisions/TEMPLATE-adr.md" download_if_missing "system-dev/docs/2-architecture/decisions/TEMPLATE-adr.md" "$REPO_URL/system-dev/docs/2-architecture/decisions/TEMPLATE-adr.md"
download_if_missing ".claude/commands/sdd-check.md" "$REPO_URL/.claude/commands/sdd-check.md" download_if_missing ".claude/commands/sdd-check.md" "$REPO_URL/.claude/commands/sdd-check.md"
download_if_missing ".claude/hooks/sdd-guard.sh" "$REPO_URL/.claude/hooks/sdd-guard.sh" download_if_missing ".claude/hooks/sdd-guard.sh" "$REPO_URL/.claude/hooks/sdd-guard.sh"
fi fi
# ── 安裝/更新腳本：一開始就放進 system-dev/scripts/ ──
# 為什麼一開始就裝：之後要更新，用戶（或 CC）直接 `bash system-dev/scripts/update.sh`，
# 不必每次都記那串 curl。腳本來源在 main/scripts/（不在 template/）。
create_dir "system-dev/scripts"
download_if_missing "system-dev/scripts/install.sh" "$SCRIPTS_URL/install.sh"
download_if_missing "system-dev/scripts/update.sh" "$SCRIPTS_URL/update.sh"
# ── 共用 hook：專案自訂禁令骨架（預設停用）──────── # ── 共用 hook：專案自訂禁令骨架（預設停用）────────
download_if_missing ".claude/hooks/pre-write-guard.sh" "$REPO_URL/.claude/hooks/pre-write-guard.sh" download_if_missing ".claude/hooks/pre-write-guard.sh" "$REPO_URL/.claude/hooks/pre-write-guard.sh"
@@ -355,22 +377,22 @@ if [ -f "CLAUDE.md" ]; then
## Wiki 讀取順序 ## Wiki 讀取順序
| 檔案 | 時機 | 用途 | | 檔案 | 時機 | 用途 |
|------|------|------| |------|------|------|
| `.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` | 設計判斷時 | 架構決策 |
SNIP SNIP
else else
cat <<'SNIP' cat <<'SNIP'
## Wiki reading order ## Wiki reading order
| File | When | Purpose | | File | When | Purpose |
|------|------|---------| |------|------|---------|
| `.claude/wiki/status.md` | first thing at session start | current progress | | `system-dev/wiki/status.md` | first thing at session start | current progress |
| `.claude/wiki/mistakes.md` | before building a new feature | known misconceptions | | `system-dev/wiki/mistakes.md` | before building a new feature | known misconceptions |
| `.claude/wiki/decisions-summary.md` | when making design calls | architecture decisions | | `system-dev/wiki/decisions-summary.md` | when making design calls | architecture decisions |
SNIP SNIP
fi fi
fi fi
if $WANT_SDD && ! grep -q "docs/3-specs" CLAUDE.md; then if $WANT_SDD && ! grep -q "system-dev/docs/3-specs" CLAUDE.md; then
echo "" echo ""
t "📌 CLAUDE.md 已存在但缺少 SDD 鐵律，請手動加入：" \ t "📌 CLAUDE.md 已存在但缺少 SDD 鐵律，請手動加入：" \
"📌 CLAUDE.md exists but lacks the SDD iron rule — please add it manually:" "📌 CLAUDE.md exists but lacks the SDD iron rule — please add it manually:"
@@ -378,13 +400,13 @@ SNIP
if [ "$IS_ZH" = "yes" ]; then if [ "$IS_ZH" = "yes" ]; then
cat <<'SNIP' cat <<'SNIP'
## 絕對鐵律 ## 絕對鐵律
1. 任何 code 變動前必須有對應 SDD（docs/3-specs/[子系統]/design.md） 1. 任何 code 變動前必須有對應 SDD（system-dev/docs/3-specs/[子系統]/design.md）
找不到 → 停手問負責人，不要自行建立。 找不到 → 停手問負責人，不要自行建立。
SNIP SNIP
else else
cat <<'SNIP' cat <<'SNIP'
## Iron rule ## Iron rule
1. Every code change must have a matching SDD (docs/3-specs/[subsystem]/design.md). 1. Every code change must have a matching SDD (system-dev/docs/3-specs/[subsystem]/design.md).
Not found → stop and ask the owner; do not create one on your own. Not found → stop and ask the owner; do not create one on your own.
SNIP SNIP
fi fi
@@ -423,8 +445,8 @@ if $WANT_WIKI; then
" CC will scan your existing docs, apply .wikiignore, and build the wiki." " CC will scan your existing docs, apply .wikiignore, and build the wiki."
fi fi
if $WANT_SDD; then if $WANT_SDD; then
t " 動 code 前先在 docs/3-specs/[子系統]/ 建 design.md（可用 /sdd-check 協助）" \ t " 動 code 前先在 system-dev/docs/3-specs/[子系統]/ 建 design.md（可用 /sdd-check 協助）" \
" Before touching code, create design.md under docs/3-specs/[subsystem]/ (use /sdd-check to help)" " Before touching code, create design.md under system-dev/docs/3-specs/[subsystem]/ (use /sdd-check to help)"
fi fi
t " GitHub issue：CC 可直接 /issue-handle 讀回自己 repo 的 issue（禁自動輪詢）" \ t " GitHub issue：CC 可直接 /issue-handle 讀回自己 repo 的 issue（禁自動輪詢）" \
" GitHub issues: CC can use /issue-handle to read issues from its own repo (no auto-polling)" " GitHub issues: CC can use /issue-handle to read issues from its own repo (no auto-polling)"
scripts/update.sh
+83 -24
View File
@@ -30,11 +30,17 @@ UPDATED=()
KEPT=() KEPT=()
NEW=() NEW=()
TEMPLATED=() TEMPLATED=()
MIGRATED=()
# ── 版本比對：先看本機 vs 遠端，給使用者「值不值得更新」的判斷 ── # ── 版本比對：先看本機 vs 遠端，給使用者「值不值得更新」的判斷 ──
# VERSION 新位置在 system-dev/，舊位置在 .claude/（1.8.x 以前）。優先讀新、回退舊。
LOCAL_VER="$(tn '(未知)' '(unknown)')" LOCAL_VER="$(tn '(未知)' '(unknown)')"
[ -f ".claude/VERSION" ] && LOCAL_VER="$(tr -d '[:space:]' < .claude/VERSION)" if [ -f "system-dev/VERSION" ]; then
REMOTE_VER="$(curl -sSL "$TEMPLATE_URL/.claude/VERSION" 2>/dev/null | tr -d '[:space:]' || echo '')" LOCAL_VER="$(tr -d '[:space:]' < system-dev/VERSION)"
elif [ -f ".claude/VERSION" ]; then
LOCAL_VER="$(tr -d '[:space:]' < .claude/VERSION)"
fi
REMOTE_VER="$(curl -sSL "$TEMPLATE_URL/system-dev/VERSION" 2>/dev/null | tr -d '[:space:]' || echo '')"
echo "" echo ""
echo "🔄 system-dev-template updater" echo "🔄 system-dev-template updater"
@@ -58,6 +64,53 @@ if [ "$LOCAL_VER" = "$REMOTE_VER" ]; then
echo "" echo ""
fi fi
# ── 結構遷移（1.9.0）：舊版把 wiki/VERSION 放 .claude/、工具 docs 放根 docs/ ──
# 新版一律收進 system-dev/。這裡冪等遷移：偵測舊位置 → 搬到 system-dev/，已搬過則略過。
# 必須在「模組偵測」之前跑（偵測靠目錄存在與否判斷，搬完才看得到新位置）。
#
# 安全原則：
# - wiki 整包搬（含 cards/ 與可能的 wiki/.git），用 mv 保留內含 .git。
# - docs 只搬「工具自己鋪的白名單」子目錄；用戶自填在 docs/ 的其他內容一律不動。
# - 目的地已存在同名 → 不覆蓋（保留用戶在新位置的東西），略過該項。
migrate_dir() { # $1=舊路徑 $2=新路徑
local from="$1" to="$2"
[ -e "$from" ] || return 0 # 舊的不存在 → 無需遷移
if [ -e "$to" ]; then
return 0 # 新的已存在 → 冪等略過，不覆蓋
fi
mkdir -p "$(dirname "$to")"
if mv "$from" "$to" 2>/dev/null; then
MIGRATED+=("$from → $to")
fi
}
# 任一舊位置還在 → 需要遷移（遷移本身冪等：已搬的項目會被 migrate_dir 略過）。
NEEDS_MIGRATE="no"
if [ -d ".claude/wiki" ] || [ -f ".claude/VERSION" ] \
|| [ -d "docs/3-specs" ] || [ -f "docs/SKILL.md" ] || [ -f "docs/README.md" ]; then
NEEDS_MIGRATE="yes"
fi
if [ "$NEEDS_MIGRATE" = "yes" ]; then
t "🔧 偵測到舊版結構，遷移到 system-dev/ …" "🔧 Old layout detected — migrating into system-dev/ …"
mkdir -p system-dev
# wiki（含 cards/ 與內含的 .git）整包搬
migrate_dir ".claude/wiki" "system-dev/wiki"
# 工具版號
migrate_dir ".claude/VERSION" "system-dev/VERSION"
# 工具文件白名單（只搬工具鋪的，用戶自填的 docs 內容不動）
migrate_dir "docs/SKILL.md" "system-dev/docs/SKILL.md"
migrate_dir "docs/README.md" "system-dev/docs/README.md"
migrate_dir "docs/1-vision" "system-dev/docs/1-vision"
migrate_dir "docs/2-architecture" "system-dev/docs/2-architecture"
migrate_dir "docs/3-specs" "system-dev/docs/3-specs"
migrate_dir "docs/4-guides" "system-dev/docs/4-guides"
migrate_dir "docs/5-records" "system-dev/docs/5-records"
migrate_dir "docs/6-user" "system-dev/docs/6-user"
echo ""
fi
# ── 工具函式 ─────────────────────────────────────── # ── 工具函式 ───────────────────────────────────────
# 覆蓋更新：模板/邏輯檔，無條件抓最新版蓋掉。 # 覆蓋更新：模板/邏輯檔，無條件抓最新版蓋掉。
update_file() { update_file() {
@@ -114,10 +167,11 @@ keep_with_template() {
} }
# ── 偵測已安裝哪些模組（依現有檔案判斷，更新只動已裝的）── # ── 偵測已安裝哪些模組（依現有檔案判斷，更新只動已裝的）──
# 遷移已在上面跑完，這裡看新位置 system-dev/。
HAS_WIKI=false HAS_WIKI=false
HAS_SDD=false HAS_SDD=false
[ -d ".claude/wiki" ] && HAS_WIKI=true [ -d "system-dev/wiki" ] && HAS_WIKI=true
if [ -f ".claude/hooks/sdd-guard.sh" ] || [ -d "docs/3-specs/TEMPLATE-sdd" ]; then HAS_SDD=true; fi if [ -f ".claude/hooks/sdd-guard.sh" ] || [ -d "system-dev/docs/3-specs/TEMPLATE-sdd" ]; then HAS_SDD=true; fi
t "📦 偵測到已安裝模組：" "📦 Detected installed modules:" t "📦 偵測到已安裝模組：" "📦 Detected installed modules:"
$HAS_WIKI && echo " • LLM Wiki" $HAS_WIKI && echo " • LLM Wiki"
@@ -136,11 +190,11 @@ keep_with_template ".claude/hooks/pre-write-guard.sh" "$TEMPLATE_URL/.claude/hoo
# ── 模板/邏輯檔：覆蓋更新 ────────────────────────── # ── 模板/邏輯檔：覆蓋更新 ──────────────────────────
# 共用 hook 與指引 # 共用 hook 與指引
update_file ".claude/commands/issue-handle.md" "$TEMPLATE_URL/.claude/commands/issue-handle.md" update_file ".claude/commands/issue-handle.md" "$TEMPLATE_URL/.claude/commands/issue-handle.md"
update_file ".claude/VERSION" "$TEMPLATE_URL/.claude/VERSION" update_file "system-dev/VERSION" "$TEMPLATE_URL/system-dev/VERSION"
if $HAS_WIKI; then if $HAS_WIKI; then
# wiki 的「邏輯檔」：導航與 hooks，可覆蓋 # wiki 的「邏輯檔」：導航與 hooks，可覆蓋。wiki 資料在 system-dev/，hooks/commands 留 .claude/。
update_file ".claude/wiki/INDEX.md" "$TEMPLATE_URL/.claude/wiki/INDEX.md" update_file "system-dev/wiki/INDEX.md" "$TEMPLATE_URL/system-dev/wiki/INDEX.md"
update_file ".claude/hooks/session-start-recall.sh" "$TEMPLATE_URL/.claude/hooks/session-start-recall.sh" update_file ".claude/hooks/session-start-recall.sh" "$TEMPLATE_URL/.claude/hooks/session-start-recall.sh"
update_file ".claude/hooks/wiki-secret-scan.sh" "$TEMPLATE_URL/.claude/hooks/wiki-secret-scan.sh" update_file ".claude/hooks/wiki-secret-scan.sh" "$TEMPLATE_URL/.claude/hooks/wiki-secret-scan.sh"
update_file ".claude/commands/wiki-init.md" "$TEMPLATE_URL/.claude/commands/wiki-init.md" update_file ".claude/commands/wiki-init.md" "$TEMPLATE_URL/.claude/commands/wiki-init.md"
@@ -148,31 +202,31 @@ if $HAS_WIKI; then
update_file ".claude/commands/wiki-update.md" "$TEMPLATE_URL/.claude/commands/wiki-update.md" update_file ".claude/commands/wiki-update.md" "$TEMPLATE_URL/.claude/commands/wiki-update.md"
update_file ".claude/commands/wiki-recall.md" "$TEMPLATE_URL/.claude/commands/wiki-recall.md" update_file ".claude/commands/wiki-recall.md" "$TEMPLATE_URL/.claude/commands/wiki-recall.md"
# Cowork（claude.ai）的 wiki 整理 skill：規則檔，可覆蓋 # Cowork（claude.ai）的 wiki 整理 skill：規則檔，可覆蓋
update_file "docs/SKILL.md" "$TEMPLATE_URL/docs/SKILL.md" update_file "system-dev/docs/SKILL.md" "$TEMPLATE_URL/system-dev/docs/SKILL.md"
# wiki 的「使用者資料」：絕不碰 # wiki 的「使用者資料」：絕不碰
keep_file ".claude/wiki/status.md" keep_file "system-dev/wiki/status.md"
keep_file ".claude/wiki/mistakes.md" keep_file "system-dev/wiki/mistakes.md"
keep_file ".claude/wiki/decisions-summary.md" keep_file "system-dev/wiki/decisions-summary.md"
keep_file ".claude/wiki/TAXONOMY.md" keep_file "system-dev/wiki/TAXONOMY.md"
keep_file ".claude/wiki/.wikiignore" keep_file "system-dev/wiki/.wikiignore"
fi fi
if $HAS_SDD; then if $HAS_SDD; then
# SDD 範本與 hook：可覆蓋 # SDD 範本與 hook：可覆蓋
update_file "docs/3-specs/TEMPLATE-sdd/design.md" "$TEMPLATE_URL/docs/3-specs/TEMPLATE-sdd/design.md" update_file "system-dev/docs/3-specs/TEMPLATE-sdd/design.md" "$TEMPLATE_URL/system-dev/docs/3-specs/TEMPLATE-sdd/design.md"
update_file "docs/3-specs/TEMPLATE-sdd/tasks.md" "$TEMPLATE_URL/docs/3-specs/TEMPLATE-sdd/tasks.md" update_file "system-dev/docs/3-specs/TEMPLATE-sdd/tasks.md" "$TEMPLATE_URL/system-dev/docs/3-specs/TEMPLATE-sdd/tasks.md"
update_file "docs/2-architecture/decisions/TEMPLATE-adr.md" "$TEMPLATE_URL/docs/2-architecture/decisions/TEMPLATE-adr.md" update_file "system-dev/docs/2-architecture/decisions/TEMPLATE-adr.md" "$TEMPLATE_URL/system-dev/docs/2-architecture/decisions/TEMPLATE-adr.md"
update_file ".claude/commands/sdd-check.md" "$TEMPLATE_URL/.claude/commands/sdd-check.md" update_file ".claude/commands/sdd-check.md" "$TEMPLATE_URL/.claude/commands/sdd-check.md"
update_file ".claude/hooks/sdd-guard.sh" "$TEMPLATE_URL/.claude/hooks/sdd-guard.sh" update_file ".claude/hooks/sdd-guard.sh" "$TEMPLATE_URL/.claude/hooks/sdd-guard.sh"
fi fi
# ── 自我更新：把最新的 update.sh 也抓下來（含 install.sh）── # ── 自我更新：把最新的 update.sh / install.sh 抓到 system-dev/scripts/ ──
# 這兩支在 main/scripts/ 下，不在 template/。 # 這兩支在 main/scripts/ 下（不在 template/）；落地位置新版收進 system-dev/scripts/。
update_file "scripts/update.sh" "$REPO_RAW/scripts/update.sh" update_file "system-dev/scripts/update.sh" "$REPO_RAW/scripts/update.sh"
update_file "scripts/install.sh" "$REPO_RAW/scripts/install.sh" update_file "system-dev/scripts/install.sh" "$REPO_RAW/scripts/install.sh"
chmod +x .claude/hooks/*.sh scripts/*.sh 2>/dev/null || true chmod +x .claude/hooks/*.sh system-dev/scripts/*.sh 2>/dev/null || true
# ── 使用者資料檔：絕不碰，但提醒「設定可能有新欄位要手動補」── # ── 使用者資料檔：絕不碰，但提醒「設定可能有新欄位要手動補」──
keep_file ".claude/settings.json" keep_file ".claude/settings.json"
@@ -181,6 +235,11 @@ keep_file "CLAUDE.md"
# ── 結果輸出 ─────────────────────────────────────── # ── 結果輸出 ───────────────────────────────────────
echo "" echo ""
echo "─────────────────────────────────" echo "─────────────────────────────────"
if [ ${#MIGRATED[@]} -gt 0 ]; then
echo ""
t "📦 結構遷移（已收進 system-dev/）：" "📦 Layout migrated (moved into system-dev/):"
for f in "${MIGRATED[@]}"; do echo " ⇒ $f"; done
fi
if [ ${#NEW[@]} -gt 0 ]; then if [ ${#NEW[@]} -gt 0 ]; then
echo "" echo ""
t "🆕 新功能（舊版沒有，已加入）：" "🆕 New features (absent in the old version, now added):" t "🆕 新功能（舊版沒有，已加入）：" "🆕 New features (absent in the old version, now added):"
@@ -229,6 +288,6 @@ fi
echo "" echo ""
t "🚀 更新完成：${LOCAL_VER} → ${REMOTE_VER}" "🚀 Update complete: ${LOCAL_VER} → ${REMOTE_VER}" t "🚀 更新完成：${LOCAL_VER} → ${REMOTE_VER}" "🚀 Update complete: ${LOCAL_VER} → ${REMOTE_VER}"
t " 下次更新直接跑：bash scripts/update.sh" " Next time, just run: bash scripts/update.sh" t " 下次更新直接跑：bash system-dev/scripts/update.sh" " Next time, just run: bash system-dev/scripts/update.sh"
t " 改了什麼看：CHANGELOG.md" " See what changed: CHANGELOG.md" t " 改了什麼看：CHANGELOG.md" " See what changed: CHANGELOG.md"
echo "" echo ""
template/.claude/VERSION
-1
View File
@@ -1 +0,0 @@
1.8.2
template/.claude/commands/sdd-check.md
+3 -3
View File
@@ -15,7 +15,7 @@
### 第二步：尋找對應 SDD ### 第二步：尋找對應 SDD
在 `docs/3-specs/` 下尋找對應的子系統目錄，確認有沒有： 在 `system-dev/docs/3-specs/` 下尋找對應的子系統目錄，確認有沒有：
- `design.md`（設計文件） - `design.md`（設計文件）
- `tasks.md`（任務清單） - `tasks.md`（任務清單）
@@ -23,7 +23,7 @@
**情況 A：找到對應 SDD** **情況 A：找到對應 SDD**
``` ```
✅ 找到 SDD：docs/3-specs/[子系統]/ ✅ 找到 SDD：system-dev/docs/3-specs/[子系統]/
📋 design.md：[確認] 📋 design.md：[確認]
📋 tasks.md：[確認，列出相關 task] 📋 tasks.md：[確認，列出相關 task]
🎯 對應 task：[編號和描述] 🎯 對應 task：[編號和描述]
@@ -34,7 +34,7 @@
``` ```
⚠️ 找不到對應 SDD ⚠️ 找不到對應 SDD
任務：[描述] 任務：[描述]
建議在 docs/3-specs/[建議子系統名]/ 建立 SDD 建議在 system-dev/docs/3-specs/[建議子系統名]/ 建立 SDD
要我幫你起草 design.md 嗎？（需要你確認後才動手） 要我幫你起草 design.md 嗎？（需要你確認後才動手）
``` ```
template/.claude/commands/wiki-capture.md
+5 -5
View File
@@ -11,9 +11,9 @@
把任何內容寫進 wiki 前，先確認**不含**密碼 / API 金鑰 / 私鑰 / 連線字串帳密 / 個資（身分證、信用卡）。 把任何內容寫進 wiki 前，先確認**不含**密碼 / API 金鑰 / 私鑰 / 連線字串帳密 / 個資（身分證、信用卡）。
- 命中 → 不要記「值」，改記「位置」（例：「DB 密碼放 `.env`，不入 wiki」） - 命中 → 不要記「值」，改記「位置」（例：「DB 密碼放 `.env`，不入 wiki」）
- 來源整檔機敏 → 提醒使用者加進 `.claude/wiki/.wikiignore` - 來源整檔機敏 → 提醒使用者加進 `system-dev/wiki/.wikiignore`
- 真要保留示範格式 → 該行尾加 `wiki-secret-ok` 標記 - 真要保留示範格式 → 該行尾加 `wiki-secret-ok` 標記
> 這是協議層自律。最後一道 `wiki-secret-scan.sh` hook 會在寫入 `.claude/wiki/` 時機械攔截，但別依賴它兜底——當場就不要把機敏值帶進來。 > 這是協議層自律。最後一道 `wiki-secret-scan.sh` hook 會在寫入 `system-dev/wiki/` 時機械攔截，但別依賴它兜底——當場就不要把機敏值帶進來。
### 第一步：辨識對話中的可記錄內容 ### 第一步：辨識對話中的可記錄內容
@@ -21,7 +21,7 @@
| 類型 | 判斷標準 | 存到哪 | | 類型 | 判斷標準 | 存到哪 |
|------|---------|-------| |------|---------|-------|
| 架構決策 | 「為什麼選A不選B」「我們決定用X」 | `decisions-summary.md` + `docs/2-architecture/decisions/` | | 架構決策 | 「為什麼選A不選B」「我們決定用X」 | `decisions-summary.md` + `system-dev/docs/2-architecture/decisions/` |
| CC 的誤解被糾正 | CC 說了某件事，使用者說「不是，是...」 | `mistakes.md` | | CC 的誤解被糾正 | CC 說了某件事，使用者說「不是，是...」 | `mistakes.md` |
| 重要狀態更新 | 完成了某件事、阻擋了某件事 | `status.md` | | 重要狀態更新 | 完成了某件事、阻擋了某件事 | `status.md` |
| 技術發現 | 踩到坑、找到解法、重要行為確認 | `mistakes.md` 或對應 SDD | | 技術發現 | 踩到坑、找到解法、重要行為確認 | `mistakes.md` 或對應 SDD |
@@ -59,10 +59,10 @@
## [主題] — [YYYY-MM-DD] ## [主題] — [YYYY-MM-DD]
**結論**：[一句話] **結論**：[一句話]
**原因**：[簡短說明] **原因**：[簡短說明]
**詳細**：docs/2-architecture/decisions/[檔名] **詳細**：system-dev/docs/2-architecture/decisions/[檔名]
``` ```
重大決策同時在 `docs/2-architecture/decisions/` 建立 ADR 檔案。 重大決策同時在 `system-dev/docs/2-architecture/decisions/` 建立 ADR 檔案。
### 第四步：確認 ### 第四步：確認
template/.claude/commands/wiki-init.md
+11 -11
View File
@@ -19,7 +19,7 @@
唯一例外：原文是**不可改動的正式文件**（簽署過的規格、法規、合約），必須逐字讀原文——這種才在 wiki 裡用指針指回去，並註明「逐字依原文」。除此之外，一律改寫。 唯一例外：原文是**不可改動的正式文件**（簽署過的規格、法規、合約），必須逐字讀原文——這種才在 wiki 裡用指針指回去，並註明「逐字依原文」。除此之外，一律改寫。
**raw source 永遠唯讀**：所有產出只往 `.claude/wiki/` 寫，絕不改動、搬移、重新命名原文。 **raw source 永遠唯讀**：所有產出只往 `system-dev/wiki/` 寫，絕不改動、搬移、重新命名原文。
--- ---
@@ -28,7 +28,7 @@
### 第一步：偵測專案狀態 ### 第一步：偵測專案狀態
檢查以下項目，判斷是新專案還是已有專案： 檢查以下項目，判斷是新專案還是已有專案：
- 根目錄有沒有 `.claude/wiki/` - 根目錄有沒有 `system-dev/wiki/`
- 根目錄有沒有 `docs/`（或 vault 的 `pages/`、`journals/`、根目錄 `.md`） - 根目錄有沒有 `docs/`（或 vault 的 `pages/`、`journals/`、根目錄 `.md`）
- 有沒有散落的 `.md` 檔案 - 有沒有散落的 `.md` 檔案
@@ -43,7 +43,7 @@
### 第二步：已有專案的掃描（已有專案才執行） ### 第二步：已有專案的掃描（已有專案才執行）
1. 遞迴找出 raw source 裡所有 `.md` 檔案 1. 遞迴找出 raw source 裡所有 `.md` 檔案
2. **先套用 `.claude/wiki/.wikiignore`**：命中 pattern 的檔案整個排除，不讀不編入。 2. **先套用 `system-dev/wiki/.wikiignore`**：命中 pattern 的檔案整個排除，不讀不編入。
- 若 `.wikiignore` 不存在，從範本建立一份（預設排除 `.env`/`*.pem`/`*secret*` 等） - 若 `.wikiignore` 不存在，從範本建立一份（預設排除 `.env`/`*.pem`/`*secret*` 等）
- 被排除的檔案在清單裡標「🚫 .wikiignore 排除」，**不可被覆蓋** - 被排除的檔案在清單裡標「🚫 .wikiignore 排除」，**不可被覆蓋**
3. 對其餘檔案標注**改寫計畫**：會萃取成哪些 wiki 條目。一份原文可能拆成多個概念原子條目，多份相關原文也可能合併成一條。 3. 對其餘檔案標注**改寫計畫**：會萃取成哪些 wiki 條目。一份原文可能拆成多個概念原子條目，多份相關原文也可能合併成一條。
@@ -66,7 +66,7 @@
wiki 採**三層 + 標籤橫切**架構（183 卡實證，issue #8）： wiki 採**三層 + 標籤橫切**架構（183 卡實證，issue #8）：
``` ```
.claude/wiki/ system-dev/wiki/
├── INDEX.md ← 頂層：標籤視圖（不是資料夾列表） ├── INDEX.md ← 頂層：標籤視圖（不是資料夾列表）
├── TAXONOMY.md ← 標籤字典（分類骨架，受控擴充：先查重再登記） ├── TAXONOMY.md ← 標籤字典（分類骨架，受控擴充：先查重再登記）
├── status.md / mistakes.md / decisions-summary.md ├── status.md / mistakes.md / decisions-summary.md
@@ -80,16 +80,16 @@ wiki 採**三層 + 標籤橫切**架構（183 卡實證，issue #8）：
> **桶子索引固定叫 `00-INDEX.md`**（issue #6）：`00-` 前綴讓它排序最前、一眼可辨（像 README 之於資料夾），AI 載入任何 `cards/<bucket>/` 一律先讀它，不必猜。檔內 H1 仍寫主題名（如 `# PKM 知識管理`），語意不丟。 > **桶子索引固定叫 `00-INDEX.md`**（issue #6）：`00-` 前綴讓它排序最前、一眼可辨（像 README 之於資料夾），AI 載入任何 `cards/<bucket>/` 一律先讀它，不必猜。檔內 H1 仍寫主題名（如 `# PKM 知識管理`），語意不丟。
一般專案仍可同時建 `docs/` 分類樹（SDD 等）： 一般專案仍可同時建 `system-dev/docs/` 分類樹（SDD 等）：
``` ```
docs/{1-vision,2-architecture/decisions,3-specs,4-guides,5-records/{incidents,test-reports},6-user} system-dev/docs/{1-vision,2-architecture/decisions,3-specs,4-guides,5-records/{incidents,test-reports},6-user}
``` ```
（純 PKM vault 不需要 `docs/` 分類樹時，只建 `.claude/wiki/`。） （純 PKM vault 不需要 `system-dev/docs/` 分類樹時，只建 `system-dev/wiki/`。）
檔案（不存在才建）： 檔案（不存在才建）：
- `.claude/wiki/INDEX.md`、`TAXONOMY.md` - `system-dev/wiki/INDEX.md`、`TAXONOMY.md`
- `.claude/wiki/status.md`、`mistakes.md`、`decisions-summary.md` - `system-dev/wiki/status.md`、`mistakes.md`、`decisions-summary.md`
- `docs/README.md`（一般專案才需要） - `system-dev/docs/README.md`（一般專案才需要）
### 第四步：訪談（每次一個問題） ### 第四步：訪談（每次一個問題）
@@ -168,7 +168,7 @@ gloss: 一句話定義這個概念是什麼（給下游語義 normalize 用，
**INDEX.md 是標籤視圖**（非資料夾列表），`00-INDEX.md` 是桶內容器（只連不重寫，H2/H3 分節）。 **INDEX.md 是標籤視圖**（非資料夾列表），`00-INDEX.md` 是桶內容器（只連不重寫，H2/H3 分節）。
頂層索引指桶子索引帶路徑：`[[pkm/00-INDEX]]`。 頂層索引指桶子索引帶路徑：`[[pkm/00-INDEX]]`。
> 與 claude.ai Cowork 的 `docs/SKILL.md` 改寫邏輯一致，兩條路徑（CC / Cowork）產出同一種 wiki。 > 與 claude.ai Cowork 的 `system-dev/docs/SKILL.md` 改寫邏輯一致，兩條路徑（CC / Cowork）產出同一種 wiki。
### 第六步：完成報告 + 驗證 ### 第六步：完成報告 + 驗證
template/.claude/commands/wiki-recall.md
+3 -3
View File
@@ -17,18 +17,18 @@ init(建) → update(存，session 末) ↔ **recall(接，session 初)** → ca
### 第一步：讀 status.md（當前進度） ### 第一步：讀 status.md（當前進度）
讀 `.claude/wiki/status.md`，掌握： 讀 `system-dev/wiki/status.md`，掌握：
- 正在做什麼、阻擋點 - 正在做什麼、阻擋點
- 下次 session 第一件事 - 下次 session 第一件事
- 待負責人確認、已知問題 - 待負責人確認、已知問題
### 第二步：讀 decisions-summary.md（為什麼這樣做） ### 第二步：讀 decisions-summary.md（為什麼這樣做）
讀 `.claude/wiki/decisions-summary.md`，掌握相關的架構決策——避免重新討論已定案的事。 讀 `system-dev/wiki/decisions-summary.md`，掌握相關的架構決策——避免重新討論已定案的事。
### 第三步：讀 mistakes.md（別重犯） ### 第三步：讀 mistakes.md（別重犯）
讀 `.claude/wiki/mistakes.md`，掌握已知誤解 + 快速檢查清單。 讀 `system-dev/wiki/mistakes.md`，掌握已知誤解 + 快速檢查清單。
### 第四步：掃 wishlist / HANDOFF（如果有） ### 第四步：掃 wishlist / HANDOFF（如果有）
template/.claude/hooks/sdd-guard.sh
+8 -8
View File
@@ -4,7 +4,7 @@
# #
# 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。 # 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。
# stdin 收到 JSON：{ tool_name, tool_input: { file_path, ... } } # stdin 收到 JSON：{ tool_name, tool_input: { file_path, ... } }
# 行為：動到 code 檔（.ts/.go/...）但 docs/3-specs/ 下沒有任何 SDD → 警告（exit 2 擋）。 # 行為：動到 code 檔（.ts/.go/...）但 system-dev/docs/3-specs/ 下沒有任何 SDD → 警告（exit 2 擋）。
# #
# 誠實限制（抄 arcrun）：只擋語法層明顯違規（直接寫 code 檔）。 # 誠實限制（抄 arcrun）：只擋語法層明顯違規（直接寫 code 檔）。
# 藏在 helper 裡、用 bash 繞道的改動擋不到。 # 藏在 helper 裡、用 bash 繞道的改動擋不到。
@@ -32,25 +32,25 @@ esac
# 改 SDD 自己 / 測試檔 → 放行 # 改 SDD 自己 / 測試檔 → 放行
case "$FILE_PATH" in case "$FILE_PATH" in
*docs/3-specs/*) exit 0 ;; *system-dev/docs/3-specs/*) exit 0 ;;
*_test.*|*.test.*|*.spec.*|*/tests/*|*/test/*) exit 0 ;; *_test.*|*.test.*|*.spec.*|*/tests/*|*/test/*) exit 0 ;;
esac esac
# docs/3-specs/ 下完全沒有 design.md → 攔 # system-dev/docs/3-specs/ 下完全沒有 design.md → 攔
SDD_COUNT=0 SDD_COUNT=0
if [ -d "docs/3-specs" ]; then if [ -d "system-dev/docs/3-specs" ]; then
SDD_COUNT=$(find docs/3-specs -name 'design.md' -not -path '*TEMPLATE*' 2>/dev/null | wc -l | tr -d ' ') SDD_COUNT=$(find system-dev/docs/3-specs -name 'design.md' -not -path '*TEMPLATE*' 2>/dev/null | wc -l | tr -d ' ')
fi fi
if [ "$SDD_COUNT" -eq 0 ]; then if [ "$SDD_COUNT" -eq 0 ]; then
cat >&2 <<EOF cat >&2 <<EOF
🚫 SDD 協議攔截：要動 code 檔 ($FILE_PATH)，但 docs/3-specs/ 下找不到任何 SDD。 🚫 SDD 協議攔截：要動 code 檔 ($FILE_PATH)，但 system-dev/docs/3-specs/ 下找不到任何 SDD。
絕對鐵律：任何 code 變動前必須有對應 SDD（design.md）。 絕對鐵律：任何 code 變動前必須有對應 SDD（design.md）。
請先： 請先：
1. 確認這個改動屬於哪個子系統 1. 確認這個改動屬於哪個子系統
2. 在 docs/3-specs/[子系統]/ 建立 design.md（可用 /sdd-check 協助） 2. 在 system-dev/docs/3-specs/[子系統]/ 建立 design.md（可用 /sdd-check 協助）
3. 在回覆開頭宣告已讀 SDD + 對應 task 3. 在回覆開頭宣告已讀 SDD + 對應 task
小修改（修 bug、改文字）若確定豁免，請明確說明範圍後由人放行。 小修改（修 bug、改文字）若確定豁免，請明確說明範圍後由人放行。
@@ -59,5 +59,5 @@ EOF
fi fi
# 有 SDD：放行，但留痕提醒要宣告（stderr 警告，不擋） # 有 SDD：放行，但留痕提醒要宣告（stderr 警告，不擋）
echo "📋 提醒：docs/3-specs/ 下有 SDD。動手前請確認已讀對應 design.md 並在回覆宣告。" >&2 echo "📋 提醒：system-dev/docs/3-specs/ 下有 SDD。動手前請確認已讀對應 design.md 並在回覆宣告。" >&2
exit 0 exit 0
template/.claude/hooks/session-start-recall.sh
+13 -1
View File
@@ -10,7 +10,19 @@
set -euo pipefail set -euo pipefail
STATUS_FILE=".claude/wiki/status.md" STATUS_FILE="system-dev/wiki/status.md"
# ── 舊結構防呆（1.9.0 遷移第 2 層保險）──
# 新版 wiki 收進 system-dev/。若偵測到舊位置 .claude/wiki/ 還在、但新位置沒 status，
# 代表使用者升級了規則卻沒跑遷移（low-code 使用者常見）→ 出聲提示，讓 CC 當場可代為遷移，
# 不要默默用不到新結構而出錯。
if [ -d ".claude/wiki" ] && [ ! -f "$STATUS_FILE" ]; then
echo "⚠️ 偵測到舊版 wiki 結構（.claude/wiki/），尚未遷移到 system-dev/wiki/。"
echo " 請跑：bash system-dev/scripts/update.sh"
echo " 或直接叫我（CC）：「幫我把 wiki 遷移到 system-dev/」——我可以代為搬移。"
echo " （未遷移時接關與 /wiki-init 會找錯位置。）"
exit 0
fi
# 沒有 wiki 就安靜退出（exit 0），不干擾還沒 /wiki-init 的專案 # 沒有 wiki 就安靜退出（exit 0），不干擾還沒 /wiki-init 的專案
if [ ! -f "$STATUS_FILE" ]; then if [ ! -f "$STATUS_FILE" ]; then
template/.claude/hooks/wiki-secret-scan.sh
+4 -4
View File
@@ -3,11 +3,11 @@
# #
# 為什麼存在：wiki 的 ignore 規則（.wikiignore + 行內標記）是「協議層」，靠 CC 遵守。 # 為什麼存在：wiki 的 ignore 規則（.wikiignore + 行內標記）是「協議層」，靠 CC 遵守。
# 但密碼/金鑰/個資外洩是「不可逆」後果——只靠口頭約束太危險。 # 但密碼/金鑰/個資外洩是「不可逆」後果——只靠口頭約束太危險。
# 這支 hook 是機械式底線：CC 真的把機敏資訊寫進 .claude/wiki/ 的那一刻 → exit 2 擋下。 # 這支 hook 是機械式底線：CC 真的把機敏資訊寫進 system-dev/wiki/ 的那一刻 → exit 2 擋下。
# #
# 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。 # 掛在 settings.json 的 PreToolUse（matcher: Write|Edit）。
# stdin 收到 JSON：{ tool_name, tool_input: { file_path, content?, new_string? } } # stdin 收到 JSON：{ tool_name, tool_input: { file_path, content?, new_string? } }
# 行為：只在目標路徑是 .claude/wiki/** 時啟動，掃要寫入的內容，命中機敏特徵 → exit 2。 # 行為：只在目標路徑是 system-dev/wiki/** 時啟動，掃要寫入的內容，命中機敏特徵 → exit 2。
# #
# 誠實限制（抄 sdd-guard）：regex 偵測有偽陰/偽陽。 # 誠實限制（抄 sdd-guard）：regex 偵測有偽陰/偽陽。
# 擋的是「明顯特徵的機敏字串被自動抄進 wiki」，擋不了刻意混淆/編碼的繞道。 # 擋的是「明顯特徵的機敏字串被自動抄進 wiki」，擋不了刻意混淆/編碼的繞道。
@@ -33,7 +33,7 @@ fi
# 只管寫進 wiki 的動作。其他路徑放行（這支專責 wiki 洩漏，不是全域 secret scanner） # 只管寫進 wiki 的動作。其他路徑放行（這支專責 wiki 洩漏，不是全域 secret scanner）
case "$FILE_PATH" in case "$FILE_PATH" in
*.claude/wiki/*) ;; *system-dev/wiki/*) ;;
*) exit 0 ;; *) exit 0 ;;
esac esac
@@ -102,7 +102,7 @@ wiki 是會被 CC 反覆讀取、可能進版控的記憶空間。
請改成下列任一做法： 請改成下列任一做法：
1. 不要把機敏值寫進 wiki，改記「位置」（例：「DB 密碼放 1Password / .env，不入 wiki」） 1. 不要把機敏值寫進 wiki，改記「位置」（例：「DB 密碼放 1Password / .env，不入 wiki」）
2. 確定是誤判（例：在示範格式）→ 該行尾加註記 wiki-secret-ok 後重寫 2. 確定是誤判（例：在示範格式）→ 該行尾加註記 wiki-secret-ok 後重寫
3. 整個來源檔本就機敏 → 加進 .claude/wiki/.wikiignore，別讓它被編入 3. 整個來源檔本就機敏 → 加進 system-dev/wiki/.wikiignore，別讓它被編入
誠實限制：本掃描靠特徵比對，有偽陽/偽陰，是「意外外洩的機械底線」而非保險箱。 誠實限制：本掃描靠特徵比對，有偽陽/偽陰，是「意外外洩的機械底線」而非保險箱。
真正的密鑰本就不該進版控。 真正的密鑰本就不該進版控。
template/CLAUDE.md
+16 -16
View File
@@ -7,7 +7,7 @@
## 絕對鐵律（違反 = 停手） ## 絕對鐵律（違反 = 停手）
1. **任何 code 變動前必須有對應 SDD**（`docs/3-specs/[子系統]/design.md`） 1. **任何 code 變動前必須有對應 SDD**（`system-dev/docs/3-specs/[子系統]/design.md`）
2. [技術棧限制，例如：前端只用 React，不引入其他框架] 2. [技術棧限制，例如：前端只用 React，不引入其他框架]
3. [其他專案特定限制] 3. [其他專案特定限制]
@@ -19,15 +19,15 @@
開始任一任務，按順序： 開始任一任務，按順序：
1. 讀 `.claude/wiki/status.md`（3 分鐘，了解當前狀態） 1. 讀 `system-dev/wiki/status.md`（3 分鐘，了解當前狀態）
2. 確認有對應 SDD（`docs/3-specs/`） 2. 確認有對應 SDD（`system-dev/docs/3-specs/`）
3. 在回覆開頭宣告： 3. 在回覆開頭宣告：
``` ```
📋 已讀 SDD：<路徑> 📋 已讀 SDD：<路徑>
🎯 對應 task：<編號> 🎯 對應 task：<編號>
🚧 執行範圍：<會動哪些檔案> 🚧 執行範圍：<會動哪些檔案>
``` ```
4. 完成後更新 `.claude/wiki/status.md` 4. 完成後更新 `system-dev/wiki/status.md`
--- ---
@@ -35,9 +35,9 @@
| 檔案 | 時機 | 用途 | | 檔案 | 時機 | 用途 |
|------|------|------| |------|------|------|
| `.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` | 遇到設計判斷時 | 架構決策快速查 |
> 開 session 由 `SessionStart` hook 自動注入 status 重點。沒自動接關 → 打 `/wiki-recall`。 > 開 session 由 `SessionStart` hook 自動注入 status 重點。沒自動接關 → 打 `/wiki-recall`。
> status/wiki 是 **快照非即時狀態**：讀快照 **+ 核實快照**，不盲信。 > status/wiki 是 **快照非即時狀態**：讀快照 **+ 核實快照**，不盲信。
@@ -52,7 +52,7 @@
| 由誰整理 | 規則檔（採集當下必讀） | | 由誰整理 | 規則檔（採集當下必讀） |
|----------|------------------------| |----------|------------------------|
| **Claude Code（CC）** | `/wiki-init`（初始化／採集）、`/wiki-capture`（存結論），規則寫在指令內文 | | **Claude Code（CC）** | `/wiki-init`（初始化／採集）、`/wiki-capture`（存結論），規則寫在指令內文 |
| **Claude.ai（Cowork）** | `docs/SKILL.md`（skill `wiki-cowork-scan`），與 CC 共用同一套規則 | | **Claude.ai（Cowork）** | `system-dev/docs/SKILL.md`（skill `wiki-cowork-scan`），與 CC 共用同一套規則 |
兩條路徑**輸出格式相同、規則一致**：gloss、typed-edge、標籤的寫法在兩份裡都有，任一方整理過另一方不覆蓋。 兩條路徑**輸出格式相同、規則一致**：gloss、typed-edge、標籤的寫法在兩份裡都有，任一方整理過另一方不覆蓋。
@@ -62,9 +62,9 @@
| 檔案 | 內容 | | 檔案 | 內容 |
|------|------| |------|------|
| `docs/README.md` | 文件分類規則 | | `system-dev/docs/README.md` | 文件分類規則 |
| `docs/3-specs/` | 所有 SDD | | `system-dev/docs/3-specs/` | 所有 SDD |
| `docs/2-architecture/decisions/` | 架構決策記錄 | | `system-dev/docs/2-architecture/decisions/` | 架構決策記錄 |
--- ---
@@ -72,8 +72,8 @@
| 類別 | 位置 | | 類別 | 位置 |
|------|------| |------|------|
| 架構決策 | `docs/2-architecture/decisions/` | | 架構決策 | `system-dev/docs/2-architecture/decisions/` |
| SDD | `docs/3-specs/[子系統]/` | | SDD | `system-dev/docs/3-specs/[子系統]/` |
| 操作手冊 | `docs/4-guides/` | | 操作手冊 | `system-dev/docs/4-guides/` |
| 事件記錄 | `docs/5-records/incidents/` | | 事件記錄 | `system-dev/docs/5-records/incidents/` |
| 測試報告 | `docs/5-records/test-reports/` | | 測試報告 | `system-dev/docs/5-records/test-reports/` |
template/system-dev/VERSION
+1
View File
@@ -0,0 +1 @@
1.9.0
template/docs/2-architecture/decisions/TEMPLATE-adr.md → template/system-dev/docs/2-architecture/decisions/TEMPLATE-adr.md
View File
template/docs/3-specs/TEMPLATE-sdd/design.md → template/system-dev/docs/3-specs/TEMPLATE-sdd/design.md
View File
template/docs/3-specs/TEMPLATE-sdd/tasks.md → template/system-dev/docs/3-specs/TEMPLATE-sdd/tasks.md
View File
template/docs/README.md → template/system-dev/docs/README.md
View File
template/docs/SKILL.md → template/system-dev/docs/SKILL.md
+8 -8
View File
@@ -12,7 +12,7 @@ description: "掃描本機 Documents 下所有裝了 system-dev-template 的資
| 層 | 規則 | | 層 | 規則 |
|------------|-------------------------------------------| |------------|-------------------------------------------|
| raw source | 只讀，不動 | | raw source | 只讀，不動 |
| `.claude/wiki/` | 唯一輸出地點，只增不覆 | | `system-dev/wiki/` | 唯一輸出地點，只增不覆 |
| `CLAUDE.md` | 不動 | | `CLAUDE.md` | 不動 |
| `logseq/`、`.obsidian/`、`assets/` | 絕對不動 | | `logseq/`、`.obsidian/`、`assets/` | 絕對不動 |
@@ -22,12 +22,12 @@ description: "掃描本機 Documents 下所有裝了 system-dev-template 的資
## 第一步：發現所有目標資料夾 ## 第一步：發現所有目標資料夾
掃描 `~/Documents`（遞迴深度 3 層），找出所有含 `.claude/wiki/` 的資料夾。 掃描 `~/Documents`（遞迴深度 3 層），找出所有含 `system-dev/wiki/` 的資料夾。
``` ```
~/Documents/ ~/Documents/
project-a/.claude/wiki/ ← ✅ 目標 project-a/system-dev/wiki/ ← ✅ 目標
Logseq/.claude/wiki/ ← ✅ 目標 Logseq/system-dev/wiki/ ← ✅ 目標
其他資料夾/ ← ❌ 跳過 其他資料夾/ ← ❌ 跳過
``` ```
@@ -37,7 +37,7 @@ description: "掃描本機 Documents 下所有裝了 system-dev-template 的資
## 第二步：對每個資料夾偵測 vault 類型 ## 第二步：對每個資料夾偵測 vault 類型
進入每個目標資料夾的**根目錄**（`.claude/wiki/` 的上兩層），依序判斷： 進入每個目標資料夾的**根目錄**（`system-dev/wiki/` 的上兩層），依序判斷：
### 判斷順序（與 install.sh 一致） ### 判斷順序（與 install.sh 一致）
@@ -60,7 +60,7 @@ else
## 第三步：讀取現有 wiki 狀態 ## 第三步：讀取現有 wiki 狀態
進入 `.claude/wiki/`，讀取： 進入 `system-dev/wiki/`，讀取：
- `INDEX.md`：目前已有哪些 wiki 頁面 - `INDEX.md`：目前已有哪些 wiki 頁面
- `status.md`：上次整理時間、進度 - `status.md`：上次整理時間、進度
@@ -228,6 +228,6 @@ cards/<bucket>/
- ❌ 修改任何 raw source 檔案 - ❌ 修改任何 raw source 檔案
- ❌ 修改 `CLAUDE.md` - ❌ 修改 `CLAUDE.md`
- ❌ 動 `logseq/`、`.obsidian/`、`assets/` 資料夾 - ❌ 動 `logseq/`、`.obsidian/`、`assets/` 資料夾
- ❌ 刪除 `.claude/wiki/` 裡已有的頁面（只增補，不刪除） - ❌ 刪除 `system-dev/wiki/` 裡已有的頁面（只增補，不刪除）
- ❌ 把機敏資訊（密碼、金鑰、個資）寫進 wiki（遇到跳過並記錄） - ❌ 把機敏資訊（密碼、金鑰、個資）寫進 wiki（遇到跳過並記錄）
- ❌ 整理沒有 `.claude/wiki/` 的資料夾（那不是這個 skill 的目標） - ❌ 整理沒有 `system-dev/wiki/` 的資料夾（那不是這個 skill 的目標）
template/.claude/wiki/.wikiignore → template/system-dev/wiki/.wikiignore
View File
template/.claude/wiki/INDEX.md → template/system-dev/wiki/INDEX.md
+2 -2
View File
@@ -1,4 +1,4 @@
# .claude/wiki/ — LLM 記憶系統 # system-dev/wiki/ — LLM 記憶系統
> 新 session 開始時從這裡導航。 > 新 session 開始時從這裡導航。
> 目的：讓 CC 不需要重新學習已知的事。 > 目的：讓 CC 不需要重新學習已知的事。
@@ -21,7 +21,7 @@
1. 只增不刪——記錄 append，決策改了加新條目說明「舊決策已更新」 1. 只增不刪——記錄 append，決策改了加新條目說明「舊決策已更新」
2. status.md 每次 session 結束更新 2. status.md 每次 session 結束更新
3. mistakes.md 每次被糾正後 append 3. mistakes.md 每次被糾正後 append
4. 發現新的重要決策 → 同時更新 decisions-summary.md 和 docs/2-architecture/decisions/ 4. 發現新的重要決策 → 同時更新 decisions-summary.md 和 system-dev/docs/2-architecture/decisions/
--- ---
template/.claude/wiki/TAXONOMY.md → template/system-dev/wiki/TAXONOMY.md
View File
template/.claude/wiki/decisions-summary.md → template/system-dev/wiki/decisions-summary.md
+2 -2
View File
@@ -1,7 +1,7 @@
# 架構決策摘要 # 架構決策摘要
> 遇到設計判斷時查這裡。 > 遇到設計判斷時查這裡。
> 完整脈絡在 docs/2-architecture/decisions/。 > 完整脈絡在 system-dev/docs/2-architecture/decisions/。
--- ---
@@ -11,4 +11,4 @@
## [主題] — [YYYY-MM-DD] ## [主題] — [YYYY-MM-DD]
**結論**：[一句話] **結論**：[一句話]
**原因**：[簡短說明] **原因**：[簡短說明]
**詳細**：docs/2-architecture/decisions/[對應檔案] **詳細**：system-dev/docs/2-architecture/decisions/[對應檔案]
template/.claude/wiki/mistakes.md → template/system-dev/wiki/mistakes.md
View File
template/.claude/wiki/status.md → template/system-dev/wiki/status.md
View File