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>
3.3 KiB
system-dev/wiki/ — LLM 記憶系統
新 session 開始時從這裡導航。 目的:讓 CC 不需要重新學習已知的事。 維護者:CC(人不手動編輯這裡)
push 檔(session 開始由 hook 主動注入,CC 行動前必看見)
| 檔案 | 注入形態 | 內容 |
|---|---|---|
status.md |
全文 | 當前進度、下一步(時態狀態) |
principles.md |
全文(一行一條) | 跨全局設計原則,行動前必服從 |
mistakes.md |
標題+一行症狀,全文按需展開 | 踩過的坑、被糾正的誤解(防不自覺盲區) |
為什麼這三個 push 而非 pull:它們是「CC 不會主動查、但不看就出事」的盲區。詳見
/wiki-init的「push vs pull」。
pull:cards/(CC 按需檢索)
一切知識內容——原文摘要、AI 筆記、決策、概念知識——都寫成 cards/<bucket>/ 的概念原子卡。
decisions-summary.md 已降級為 cards(決策=知識內容);既有的保留為相容。
維護規則
- 只增不刪——記錄 append,內容改了加新條目說明「舊的已更新」
- status.md 每次 session 結束更新;mistakes/principles 一發現就 append
- principles 一行一條、≤15 條(超過代表該合併或下放成 card)
- 新增一個檢索角度 = 在下方「多角度視圖」加一節,不開新實體檔、不問用戶
多角度視圖(由 /wiki-init、/wiki-capture 填入)
INDEX 是所有檢索角度的入口,不只標籤。原文是唯讀 SSoT,wiki 是改寫過的記憶。 新增角度只要在這裡加一節(如「決策角度」「原則角度」),指向對應 cards 或 push 檔——不必新增實體特殊檔。
子系統角度(按 TAXONOMY.md 的軸聚類,指向桶子索引)
架構決策(跨子系統)
- decisions/00-INDEX — arcrun 架構決策(13 卡,已從 decisions-summary 全量改寫成原子卡)
子系統卡桶(零件架構 / cypher / credential / recipe / kbdb / 薄殼 / 部署)尚未獨立建—— 決策卡已用 frontmatter
tags:掛子系統軸,可從 INDEX 標籤過濾;純子系統知識卡由 /wiki-capture 依需開桶。
決策角度(取代舊 decisions-summary.md 的視圖)
decisions-summary.md(全文)保留為相容;13 條決策已逐條改寫成cards/decisions/原子卡,入口見 decisions/00-INDEX。 按子系統分群的清單在桶子索引內,這裡只放跨子系統最常查的:
- 工作流是default零件是例外 — 自用→工作流,全生態重用→才零件(mindset §1)
- 薄殼原則-能力長在API — 能力只實作一次放 API,介面全薄殼(rule 07)
- 自力救濟階梯-缺能力怎麼補 — 缺能力分流:自家補API/第三方 workflow 補丁(issue #4)
- service-binding-vs-cypher-binding — 零件串接走 HTTP URL,禁 service binding(rule 03)
結構:INDEX(多角度入口)→
cards/<bucket>/00-INDEX.md(桶子索引,固定名)→ 概念原子卡。 指00-INDEX一律帶路徑[[bucket/00-INDEX]](固定名跨桶撞名);卡片間用裸[[卡名]]。 分類由卡片 frontmattertags:承載,標籤字典見TAXONOMY.md。詳見/wiki-init規範。