Community寫作與編輯github.com

Vault Crystallize

Claude/代理技能,用於將進度檢查點寫入 Handoff.md,並將來源資料提煉成附有引用和信心評級的證據日誌,存放在由代理管理的知識庫中。

Vault Crystallize 是什麼?

Vault Crystallize 是一個專為 AI 代理設計的技能,用於管理結構化的知識庫。它定義了兩個核心指令:`crystallize`(結晶)和 `distill`(蒸餾)。`crystallize` 會將當前工作階段的可恢復狀態與長期穩定的結論,分別寫入對應工作單元的 `Handoff.md` 文件或 `llm-wiki/` 知識庫中,並自動判斷結論的適用範圍(專案級或全域級)。`distill` 則將具體的來源(如檔案、對話片段)轉換為附有區塊引用和信心評級(高/中/低/未驗證)的結構化證據條目。該技能支援 Claude Code、Cursor、Codex 等平台,並要求嚴格遵循 `handoff-protocol.md` 與 `llm-wiki-protocol.md` 等資料合約來確保文件格式與健康度。透過提供明確的觸發關鍵字(如「結晶」、「crystallize」)與詳細的審查清單,它能有效防止代理在未經明確要求時執行不相關的任務(如整理文件或同步記憶),從而維持知識庫的精確性與一致性。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add WIHATN/vault-crystallize

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Vault Crystallize 是做什麼的?

此技能是知識庫中 crystallize(結晶)和 distill(蒸餾)的行為權威。知識庫協定是資料合約:

  • AGENTS.md 定義工作區邊界、啟動層級和寫入所有權。
  • global/agent-rules/handoff-protocol.md 定義 Handoff.md 的格式。
  • global/agent-rules/llm-wiki-protocol.md 定義 llm-wiki/ 頁面結構、證據、矛盾、整合與健康檢查。
  • global/agent-rules/llm-wiki-format.md 定義頁面模板(若存在)。

請勿在協定中尋找 ## Crystallize 章節。如果舊版知識庫中存在該章節,請優先使用此技能來決定行為,並僅將協定用於資料合約。

邊界

專用觸發關鍵字:

  • 结晶, 结晶一下, crystallize -> 僅在恢復狀態或長期知識有變更時,檢查點化恢復狀態並固化長期知識。
  • 蒸馏, distill -> 將具體來源轉換為附有引用和信心評級的證據條目。

請勿將此技能用於 neat-freak、深度審計、大規模文件清理、記憶同步,或用於生成精緻的「結晶版」摘要,除非使用者明確要求該獨立任務。單純的 收尾、"wrap up"、"整理一下" 和 "sync my notes" 都不是結晶的觸發條件。

尚未安裝此技能的代理屬於安裝/更新問題,而非將結晶行為複製回知識庫協定的理由。請勿建立 .claude/skills、.agents/skills、聯結點或每個代理的安裝路徑,除非使用者明確要求進行安裝工作。

原生指令包裝器位於 commands/ 和 commands/<agent>/ 目錄下。共享的通用別名技能位於 skills/ 下;請勿在平台專用目錄下新增重複的別名 SKILL.md 檔案,因為 Codex 可能會遞迴發現它們兩次。將所有這些視為明確的呼叫轉接器;更新時請保持 SKILL.md 作為行為權威。

語言預設

預設使用中文撰寫 Handoff.md 和 llm-wiki/ 的內容。穩定的技術識別碼(包括程式碼、指令、變數名稱、路徑、API 名稱、套件名稱以及需要保留原始標題的重要來源標題)請保留英文。

僅在使用者明確要求、引用原始資料時,或當現有專案規則對該單元有更具體的規定時,才使用其他語言。

指令:crystallize

  1. 識別當前工作單元:
    • 工作在 projects/<name>/ 下 -> 該專案。
    • 工作在 research/<name>/ 下 -> 該研究領域,除非子模組有自己的 Handoff.md。
    • 知識庫治理或跨知識庫規則 -> 根目錄下的 Handoff.md 和 global/llm-wiki/。
  2. 在聲明當前專案狀態前,先讀取當前單元的 Handoff.md。如果單元不明確,則讀取根目錄下的 Handoff.md 作為活躍專案索引;若仍不明確,則提出一個簡潔的問題。
  3. 判斷是否有任何實際變更:
    • 恢復點已變更 -> 更新當前單元的 Handoff.md。
    • 產生了另一個執行緒應長期知道的穩定結論 -> 更新匹配的現有 llm-wiki/ 頁面。
    • 既無恢復點變更,也無長期變更 -> 不寫入任何內容,並說明原因。
  4. 在寫入之前,根據重用範圍路由每個穩定結論:
    • 自問:這個結論在明天一個做類似任務的不同專案中,是否仍然成立且有用?是 -> 將通用事實寫入匹配的 global/llm-wiki/<topic>.md 頁面,並僅在專案 wiki 中保留專案特定的應用細節和一個 wiki 連結指標。不確定 -> 保持在專案層級(預設向下)。
    • 二二法則:如果本次工作階段使用或改寫了存在於另一個專案 wiki 中的結論,則立即將其提升為全域主題頁面。
    • 先讀後寫:先讀取目標主題頁面,如果存在相同主題的條目則合併;切勿盲目附加。僅在沒有現有主題匹配時才建立新主題頁面,並在同一輪中更新 global/llm-wiki/index.md 中的 ## Triggers 部分。
  5. 僅寫入正確的層級:
    • Handoff.md 記錄當前狀態、活躍檔案、未解決問題、下一步行動和恢復上下文。
    • llm-wiki/ 記錄穩定的決策、方法、陷阱、記憶、實體/概念或證據條目。
    • log.md 僅用於真正重大的知識操作,而非例行性的結晶。
    • 工具私有記憶、過程重放和代理快取永遠不會成為知識庫的權威。
  6. 如果 Handoff.md 包含 ## Tracks,則在最終確定前掃描所有活躍的追蹤。保留非焦點追蹤,除非工作明確關閉了它們。
  7. 在報告完成前執行以下審查清單。

指令:distill

僅在使用者明確說出 distill、蒸馏,或要求將具體來源轉換為可追溯的證據時使用。

輸入:

  • 來源:檔案路徑、貼上的文字、擷取的 URL 內容、筆記、PDF 或對話摘錄。
  • 目標單元:從來源路徑或當前任務推斷;如果不明確,則提出一個簡潔的問題。
  • 目的地:目標單元的 llm-wiki/evidence-log.md。

工作流程:

  1. 讀取目標單元的 Handoff.md。
  2. 讀取 global/agent-rules/llm-wiki-protocol.md 中的 ## Evidence Log 和 ## Pending Contradictions 章節。
  3. 將來源按順序分割為編號區塊 B1、B2、B3 ...。將原始的長篇來源保留在 sources/ 或 notes/ 中;僅將指標和簡潔的證據放入 llm-wiki/。
  4. 區分證據與推斷。證據聲明引用 (src: Bn)。推斷需列出其所依賴的來源區塊。
  5. 為每個結論指定信心等級:high、medium、low 或 unverified。
  6. 如果新證據與現有 llm-wiki/ 中的內容矛盾,請遵循 ## Pending Contradictions 的處理方式;切勿靜默覆蓋。

證據條目格式:

### YYYY-MM-DD · <source title>
- **来源:** [[relative/source-or-note]]
- **原文块:**
  - B1: <short source locator or excerpt summary>
  - B2: <short source locator or excerpt summary>
- **证据结论:**
  - <claim> (src: B1) - confidence: <high|medium|low|unverified>
- **推断:**
  - <inference> (from: B1+B2) - confidence: <high|medium|low|unverified>
- **待验证:** <specific verification need, or `无`>

審查清單

Handoff 審查:

  • 完全包含 handoff-protocol.md 要求的章節;## Tracks 僅在存在平行活躍追蹤時為可選項。
  • 如果存在 ## Tracks,則恰好有一個追蹤標記為 [focus]。
  • ## Last Done 最多 4 個條目,按時間倒序排列,每個條目以日期結尾。
  • ## Next Actions 最多包含 3 個具體的複選框項目。
  • ## Active Files 解釋每個檔案為何處於活躍狀態,而非該檔案是什麼。
  • ## Decisions 包含指向 [[llm-wiki/decisions]] 的 wiki 連結或一個決策區塊 ID,否則寫 None。
  • ## Resume 告訴下一個代理應該讀取什麼以及保持什麼心智模型。

LLM wiki 審查:

  • 新增或顯著變更的頁面具有 llm-wiki-protocol.md 所需的前置資料。
  • 頁面類型與內容匹配:決策、方法、陷阱、記憶、證據、實體、概念、詞彙表或操作日誌。
  • 新頁面已從本地 llm-wiki/index.md 中連結。
  • 聲明附有信心等級;證據聲明指向來源。
  • 未解決的矛盾記錄在指定位置,而非隱藏。
  • 跨專案可重用的結論被導向 global/llm-wiki/ 的主題頁面;事實不會在層級間重複(專案保留應用細節和一個指標)。
  • 條目標題和欄位集合與該頁面類型的 llm-wiki-format.md 模板相符:聲明頁面(方法 / 陷阱 / 主題)以穩定的主題名稱作為鍵值,事件頁面(決策 / 證據 / 日誌)以日期作為鍵值。
  • Markdown 表格中不出現別名 wiki 連結。

行為審查:

  • 除非明確要求,否則不執行或呼叫 neat-freak。
  • 不擴展為文件清理、記憶同步或格式調整。
  • 除非明確要求,否則不管理代理本機的技能安裝。
  • 如果沒有任何變更,則不寫入任何內容;報告「無變更」是一個有效的結果。

驗證

當檔案被建立、移動、重新命名,或使用者正在切換執行緒/代理時,從知識庫根目錄執行唯讀健康檢查套件:

pwsh -NoProfile -File global/tools/vault-health.ps1
pwsh -NoProfile -File global/tools/vault-meta.ps1 -Audit
pwsh -NoProfile -File global/tools/vault-links.ps1

對於僅內容編輯,執行最小相關檢查並報告跳過了哪些檢查。

常見失敗模式

失敗修正措施
"其他沒有此技能的代理將無法結晶。"安裝/更新分發可以解決此問題。請勿將行為複製到協定中。
讀取 llm-wiki-protocol.md ## Crystallize。停止;此技能擁有結晶行為的所有權。協定僅定義格式和健康檢查。
將 收尾 或 "cleanup docs" 視為結晶。除非出現專用詞彙或明確的證據意圖,否則不要觸發。
將程序日誌寫入 llm-wiki/。只有穩定的結論才屬於那裡。
附加到過時的 Handoff 列表中。在文件規定的上限內重寫滑動視窗。
為聲明頁面(方法 / 陷阱 / 主題)附加新的日期條目,而非合併。聲明頁面以主題為鍵值:找到現有條目,就地重寫它,並更新 updated / 验证于。

相關技能