uncle6me-web
558e80b4da
wiki 已初始化過（push 檔活躍維護），本次補從沒建的 pull 層 + arcrun 化範本： - cards/decisions/ 14 張決策原子卡（含 gloss/實體/typed-edge 三元組）： 從 decisions-summary 全量改寫 13 + 新增「薄殼規則晚於實作-MCP漂移是歷史債」1 - TAXONOMY 從 PKM 範本換成 arcrun 軸（子系統 零件架構/cypher/credential/recipe/kbdb/ 薄殼/部署/平台原則 + 形態 架構決策/踩坑/機制說明/禁令/案例經驗） - principles 填 13 條跨全局原則（從 rules/ + mindset 蒸餾） - INDEX 真實視圖（子系統角度 + 決策角度，指向 cards） - system-dev/scripts/ + scripts/ install/update 安裝腳本（template 接入） 純基建/文檔，無業務 code（功能 code 見前一 commit）。 raw source（docs/）0 異動、wiki 卡際連結無斷鏈。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
50 lines
3.1 KiB
Markdown
50 lines
3.1 KiB
Markdown
# TAXONOMY.md — 標籤字典（arcrun repo 專屬）
|
||
|
||
> wiki 卡片的 frontmatter `tags:` **只能用這裡列出的標籤**。
|
||
> 這不是凍結——字典**可以擴充**，只是**禁止繞過字典在卡片裡直接冒新標籤**。
|
||
> 維護者：CC（由 /wiki-init 初始化、隨 wiki 演進受控擴充）。
|
||
>
|
||
> **遇到現有軸都裝不下的內容時，照這個流程（先查、後擴、登記）**：
|
||
> 1. **先查既有**：現有標籤真的都不合，還是只是同義詞？（`零件` vs `component` vs `WASM零件` 是同一軸，別重造）
|
||
> 2. **確實是新軸** → 把新標籤加進本檔（附一句定義），再用。不必停下來問人，但「先登記再使用」這道查核不能省。
|
||
> 3. 自由增生才是要防的——同義標籤散開會讓同類卡片分散、下游聚類失準。受控擴充（先查重、再登記）不會。
|
||
>
|
||
> **字典是每個 repo 各自的**：arcrun 是開發 repo，軸是「子系統／層級／決策類型」，與知識型 vault 的「知識管理／學習認知」本來就不同。
|
||
|
||
---
|
||
|
||
## 分類採雙軸（一張卡可多重歸屬）
|
||
|
||
分類由 **frontmatter `tags:`** 承載，不靠資料夾、不靠行內 `#tag`。
|
||
一張卡同時掛「子系統 1-3 個 + 形態 0-2 個」，可從任一軸過濾。
|
||
|
||
### 子系統 / 領域（主軸，每卡 1-3 個）
|
||
|
||
> arcrun 的架構分層。卡講「哪一塊」就掛對應標籤。
|
||
|
||
- `零件架構` — WASM 零件、component worker、registry、部署模式
|
||
- `cypher` — cypher-executor、workflow 執行、host functions、graph executor
|
||
- `credential` — auth primitive、加解密、JWT、recipe auth、credential 注入
|
||
- `recipe` — recipe schema、UUID 市場模型、投稿、信任機制
|
||
- `kbdb` — KBDB 資料層、三表、proxy、租戶隔離、embedding/vectorize
|
||
- `薄殼` — CLI / MCP / SDK 介面層、能力下沉 API、帳號統一
|
||
- `部署` — wrangler、local-deploy、self-hosted、CI 邊界、account override
|
||
- `平台原則` — 跨子系統的世界觀（工作流 vs 零件、誠實不假綠、AI→工具）
|
||
|
||
### 形態（副軸，每卡 0-2 個）
|
||
|
||
- `架構決策` — 一次性的設計選擇 + trade-off（取代舊 decisions-summary 視圖）
|
||
- `踩坑` — 事件復盤、被糾正的誤解（與 mistakes.md 互補：mistakes 是 push 摘要，card 是全文）
|
||
- `機制說明` — 某個能力「怎麼運作」的自包含解釋
|
||
- `禁令` — hook 強制的硬規則背後的 why
|
||
- `案例經驗` — 壓測、dogfood、實證落地的具體記錄
|
||
|
||
---
|
||
|
||
## 規則
|
||
|
||
1. **先查重、再登記、才使用**：禁止繞過字典在卡片直接冒新標籤；新標籤先確認非現有同義詞，加進本檔（附定義）再用。
|
||
2. **子系統 vs 形態分開**：子系統是「講哪一塊」，形態是「以什麼形式呈現」，不要混。
|
||
3. **頂層 INDEX.md 的標籤視圖依本字典的軸聚類**——字典改了，INDEX 視圖跟著更新。
|
||
4. **新增子系統軸要慎**：子系統是檢索骨架，動它影響全庫聚類；形態軸（呈現形式）擴充較安全。不確定就先用現有最接近的，並在卡片或本檔註記「待人類複核此分類」。
|