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
- 識別當前工作單元:
- 工作在
projects/<name>/下 -> 該專案。 - 工作在
research/<name>/下 -> 該研究領域,除非子模組有自己的Handoff.md。 - 知識庫治理或跨知識庫規則 -> 根目錄下的
Handoff.md和global/llm-wiki/。
- 工作在
- 在聲明當前專案狀態前,先讀取當前單元的
Handoff.md。如果單元不明確,則讀取根目錄下的Handoff.md作為活躍專案索引;若仍不明確,則提出一個簡潔的問題。 - 判斷是否有任何實際變更:
- 恢復點已變更 -> 更新當前單元的
Handoff.md。 - 產生了另一個執行緒應長期知道的穩定結論 -> 更新匹配的現有
llm-wiki/頁面。 - 既無恢復點變更,也無長期變更 -> 不寫入任何內容,並說明原因。
- 恢復點已變更 -> 更新當前單元的
- 在寫入之前,根據重用範圍路由每個穩定結論:
- 自問:這個結論在明天一個做類似任務的不同專案中,是否仍然成立且有用?是 -> 將通用事實寫入匹配的
global/llm-wiki/<topic>.md頁面,並僅在專案 wiki 中保留專案特定的應用細節和一個 wiki 連結指標。不確定 -> 保持在專案層級(預設向下)。 - 二二法則:如果本次工作階段使用或改寫了存在於另一個專案 wiki 中的結論,則立即將其提升為全域主題頁面。
- 先讀後寫:先讀取目標主題頁面,如果存在相同主題的條目則合併;切勿盲目附加。僅在沒有現有主題匹配時才建立新主題頁面,並在同一輪中更新
global/llm-wiki/index.md中的## Triggers部分。
- 自問:這個結論在明天一個做類似任務的不同專案中,是否仍然成立且有用?是 -> 將通用事實寫入匹配的
- 僅寫入正確的層級:
Handoff.md記錄當前狀態、活躍檔案、未解決問題、下一步行動和恢復上下文。llm-wiki/記錄穩定的決策、方法、陷阱、記憶、實體/概念或證據條目。log.md僅用於真正重大的知識操作,而非例行性的結晶。- 工具私有記憶、過程重放和代理快取永遠不會成為知識庫的權威。
- 如果
Handoff.md包含## Tracks,則在最終確定前掃描所有活躍的追蹤。保留非焦點追蹤,除非工作明確關閉了它們。 - 在報告完成前執行以下審查清單。
指令:distill
僅在使用者明確說出 distill、蒸馏,或要求將具體來源轉換為可追溯的證據時使用。
輸入:
- 來源:檔案路徑、貼上的文字、擷取的 URL 內容、筆記、PDF 或對話摘錄。
- 目標單元:從來源路徑或當前任務推斷;如果不明確,則提出一個簡潔的問題。
- 目的地:目標單元的
llm-wiki/evidence-log.md。
工作流程:
- 讀取目標單元的
Handoff.md。 - 讀取
global/agent-rules/llm-wiki-protocol.md中的## Evidence Log和## Pending Contradictions章節。 - 將來源按順序分割為編號區塊
B1、B2、B3...。將原始的長篇來源保留在sources/或notes/中;僅將指標和簡潔的證據放入llm-wiki/。 - 區分證據與推斷。證據聲明引用
(src: Bn)。推斷需列出其所依賴的來源區塊。 - 為每個結論指定信心等級:
high、medium、low或unverified。 - 如果新證據與現有
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 / 验证于。 |