CommunitySchreiben & Editierengithub.com

WIHATN/vault-crystallize

Claude/Agent-Fähigkeit zum Speichern von Fortschritten in Handoff.md und zum Destillieren von Quellen in ein zitiertes, vertrauensbewertetes Erkenntnisprotokoll innerhalb eines von Agenten verwalteten Wissensarchivs.

Was ist vault-crystallize?

Diese Fähigkeit (Skill) definiert das autoritative Verhalten für die Operationen 'crystallize' (Kristallisieren) und 'distill' (Destillieren) in einem Wissensarchiv (Vault), das von KI-Agenten wie Claude Code, Cursor oder Codex verwaltet wird. Bei 'crystallize' wird der aktuelle Arbeitskontext in einer `Handoff.md` gespeichert, um den Fortschritt zu checkpointen, und stabile, dauerhafte Erkenntnisse werden in strukturierten `llm-wiki/`-Seiten mit Vertrauensbewertungen archiviert. Der Befehl 'distill' extrahiert aus konkreten Quellen (Dateien, Texte, URLs) belegte Evidenzeinträge und unterscheidet dabei strikt zwischen nachweisbaren Behauptungen und Inferenzen. Die Fähigkeit setzt auf einem definierten Datenvertrag auf, der in `AGENTS.md` und globalen Protokollen (`handoff-protocol.md`, `llm-wiki-protocol.md`) beschrieben ist. Sie vermeidet das Duplizieren von Verhalten in andere Protokolle und verhindert typische Fehlermodi wie das unbeabsichtigte Auslösen durch vage Befehle oder das Überschreiben von Evidenz. Die Standardsprache für Inhalte ist Chinesisch, während technische Bezeichner auf Englisch bleiben.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add WIHATN/vault-crystallize

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Vault Crystallize

Diese Fähigkeit ist die Verhaltensautorität für crystallize und distill in einem Wissensarchiv (Vault). Vault-Protokolle sind Datenverträge:

  • AGENTS.md definiert Arbeitsbereichsgrenzen, Startstufen und Schreibberechtigungen.
  • global/agent-rules/handoff-protocol.md definiert das Format von Handoff.md.
  • global/agent-rules/llm-wiki-protocol.md definiert das Schema, Evidenzen, Widersprüche, Integration und Gesundheitschecks von llm-wiki/-Seiten.
  • global/agent-rules/llm-wiki-format.md definiert Seitenvorlagen, wenn diese vorhanden sind.

Suche nicht nach einem ## Crystallize-Abschnitt im Protokoll. Falls ein solcher in einem alten Vault existiert, bevorzuge diese Fähigkeit für das Verhalten und verwende das Protokoll nur für die Datenverträge.

Abgrenzung

Dedizierte Auslöser:

  • 结晶, 结晶一下, crystallize -> Wiederherstellungspunkt des aktuellen Stands und stabiles, langfristiges Wissen nur dann speichern, wenn es sich geändert hat.
  • 蒸馏, distill -> Eine konkrete Quelle in zitierte, vertrauensbewertete Evidenzeinträge umwandeln.

Verwende diese Fähigkeit nicht für neat-freak, tiefgehende Audits, umfassende Dokumentenbereinigung, Speichersynchronisation oder eine polierte "结晶版"-Zusammenfassung, es sei denn, der Benutzer fordert diese separate Aufgabe explizit an. Bloßes 收尾, "wrap up", "整理一下" und "sync my notes" sind keine Crystallize-Auslöser.

Agenten, die diese Fähigkeit nicht installiert haben, sind ein Installations-/Aktualisierungsproblem, kein Grund, das Crystallize-Verhalten zurück in die Vault-Protokolle zu duplizieren. Erstelle keine .claude/skills, .agents/skills, Junctions oder installationspfadspezifische Agentenverzeichnisse, es sei denn, der Benutzer fordert explizit Installationsarbeit an.

Native Befehls-Wrapper befinden sich in commands/ und commands/<agent>/. Allgemeine Alias-Fähigkeiten (Skills) befinden sich unter skills/; füge keine doppelten SKILL.md-Dateien unter plattformspezifischen Verzeichnissen hinzu, da Codex diese möglicherweise zweimal rekursiv entdeckt. Behandle alle als explizite Aufruf-Adapter; behalte SKILL.md als Verhaltensautorität bei Aktualisierungen.

Spracheinstellungen

Schreibe den Inhalt von Handoff.md und llm-wiki/ standardmäßig auf Chinesisch. Behalte stabile, technische Bezeichner auf Englisch, einschließlich Code, Befehle, Variablennamen, Pfade, API-Namen, Paketnamen und Quelltitel, wenn die Beibehaltung des Originaltitels wichtig ist.

Verwende eine andere Sprache nur, wenn der Benutzer es explizit verlangt, beim Zitieren von Quellmaterial oder wenn eine bestehende Projektregel für diese Einheit spezifischer ist.

Befehl: crystallize

  1. Identifiziere die aktuelle Einheit:
    • Arbeit unter projects/<name>/ -> dieses Projekt.
    • Arbeit unter research/<name>/ -> dieser Forschungsbereich, es sei denn, ein Untermodul hat eine eigene Handoff.md.
    • Vault-Verwaltung oder vaultübergreifende Regeln -> Handoff.md des Wurzelverzeichnisses und global/llm-wiki.
  2. Lese vor der Behauptung des aktuellen Projektstatus die Handoff.md der aktuellen Einheit. Falls die Einheit unklar ist, lies die Handoff.md des Wurzelverzeichnisses als Index der aktiven Projekte; falls immer noch unklar, stelle eine präzise Frage.
  3. Entscheide, ob sich tatsächlich etwas geändert hat:
    • Wiederherstellungspunkt geändert -> aktualisiere die Handoff.md der aktuellen Einheit.
    • Stabile Schlussfolgerung, die ein anderer Thread langfristig wissen sollte -> aktualisiere die passende, vorhandene llm-wiki/-Seite.
    • Keine Wiederherstellungs- oder Langzeitänderung -> schreibe nichts und erkläre warum.
  4. Leite jede stabile Schlussfolgerung anhand des Wiederverwendungsbereichs weiter, bevor du schreibst:
    • Frage: Würde diese Schlussfolgerung auch in einem anderen Projekt, das morgen eine ähnliche Aufgabe durchführt, wahr und nützlich sein? Ja -> schreibe die allgemeine Tatsache in die passende global/llm-wiki/<topic>.md-Seite und behalte nur projektspezifische Anwendungsdetails sowie einen Wiki-Link-Verweis im Projekt-Wiki. Unsicher -> belasse es auf Projektebene (Standard: niedrige Ebene).
    • Regel von zwei: Wenn diese Sitzung eine Schlussfolgerung verwendet oder neu geschrieben hat, die im Wiki eines anderen Projekts lebt, befördere sie jetzt auf eine globale Themenseite.
    • Erst lesen, dann schreiben: Lese die Ziel-Themenseite zuerst und führe sie mit einem vorhandenen Eintrag zum selben Thema zusammen, falls einer existiert; füge niemals blind an. Erstelle eine neue Themenseite nur, wenn kein vorhandenes Thema passt, und aktualisiere im selben Durchlauf ## Triggers in global/llm-wiki/index.md.
  5. Schreibe nur die richtige Ebene:
    • Handoff.md erhält aktuellen Status, aktive Dateien, offene Fragen, nächste Aktionen und Wiederaufnahmekontext.
    • llm-wiki/ erhält stabile Entscheidungen, Methoden, Fallstricke, Erinnerungen, Entitäts-/Konzept- oder Evidenzeinträge.
    • log.md ist nur für wirklich bedeutende Wissensoperationen vorgesehen, nicht für routinemäßiges Crystallize.
    • Werkzeugprivater Speicher, Prozesswiedergabe und Agenten-Caches werden niemals zur Vault-Autorität.
  6. Wenn Handoff.md ## Tracks enthält, durchlaufe alle aktiven Tracks vor dem Abschluss. Erhalte nicht im Fokus stehende Tracks, es sei denn, die Arbeit hat sie explizit abgeschlossen.
  7. Führe die unten stehende Überprüfungsliste vor der Meldung des Abschlusses aus.

Befehl: distill

Verwende diesen Befehl nur, wenn der Benutzer explizit distill, 蒸馏 sagt oder darum bittet, eine konkrete Quelle in nachverfolgbare Evidenz umzuwandeln.

Eingaben:

  • Quelle: ein Dateipfad, eingefügter Text, abgerufener URL-Inhalt, Notiz, PDF oder Gesprächsauszug.
  • Zieleinheit: aus Quellpfad oder aktueller Aufgabe ableiten; falls mehrdeutig, stelle eine präzise Frage.
  • Ziel: llm-wiki/evidence-log.md der Zieleinheit.

Arbeitsablauf:

  1. Lese die Handoff.md der Zieleinheit.
  2. Lese die Abschnitte ## Evidence Log und ## Pending Contradictions von global/agent-rules/llm-wiki-protocol.md.
  3. Teile die Quelle in nummerierte Blöcke B1, B2, B3, ... in der Quellreihenfolge auf. Behalte rohe, lange Quellen in sources/ oder notes/; füge nur Verweise und präzise Evidenz in llm-wiki/ ein.
  4. Trenne Evidenz von Inferenz. Evidenzbehauptungen zitieren (src: Bn). Inferenzen nennen die Quellblöcke, von denen sie abhängen.
  5. Weise jeder Schlussfolgerung eine Vertrauensbewertung zu: high, medium, low oder unverified.
  6. Wenn neue Evidenz bestehenden llm-wiki/-Einträgen widerspricht, folge ## Pending Contradictions; überschreibe nicht stillschweigend.

Form eines Evidenzeintrags:

### YYYY-MM-DD · <Quelltitel>
- **来源:** [[relative/source-or-note]]
- **原文块:**
  - B1: <kurzer Quell-Locator oder Auszugszusammenfassung>
  - B2: <kurzer Quell-Locator oder Auszugszusammenfassung>
- **证据结论:**
  - <Behauptung> (src: B1) - confidence: <high|medium|low|unverified>
- **推断:**
  - <Inferenz> (from: B1+B2) - confidence: <high|medium|low|unverified>
- **待验证:** <spezifischer Verifikationsbedarf, oder `无`>

Überprüfungsliste

Handoff-Überprüfung:

  • Genau die erforderlichen Abschnitte aus handoff-protocol.md; ## Tracks ist optional nur für parallele, aktive Tracks.
  • Wenn ## Tracks existiert, hat genau ein Track [focus].
  • ## Last Done hat höchstens 4 Einträge, rückchronologisch, jeder endet mit einem Datum.
  • ## Next Actions hat höchstens 3 konkrete Kontrollkästchen-Elemente.
  • ## Active Files erklärt, warum jede Datei jetzt aktiv ist, nicht, was die Datei ist.
  • ## Decisions enthält einen Wiki-Link zu [[llm-wiki/decisions]] oder eine Entscheidungsblock-ID, oder sagt None.
  • ## Resume teilt dem nächsten Agenten mit, was zu lesen ist und welches mentale Modell beibehalten werden soll.

LLM-Wiki-Überprüfung:

  • Neue oder wesentlich geänderte Seiten haben das von llm-wiki-protocol.md erforderliche Frontmatter.
  • Der Seitentyp passt zum Inhalt: Entscheidung, Methode, Fallstrick, Erinnerung, Evidenz, Entität, Konzept, Glossar oder Betriebsprotokoll.
  • Neue Seiten sind vom lokalen llm-wiki/index.md aus verlinkt.
  • Behauptungen haben Vertrauensbewertungen; Evidenzbehauptungen verweisen auf Quellen.
  • Ungelöste Widersprüche werden an der dafür vorgesehenen Stelle aufgezeichnet, nicht versteckt.
  • Projektübergreifend wiederverwendbare Schlussfolgerungen werden an global/llm-wiki/-Themenseiten weitergeleitet; keine Tatsache wird über Ebenen hinweg dupliziert (Projekt behält Anwendungsdetails plus einen Verweis).
  • Eintragsüberschriften und Feldsets entsprechen der llm-wiki-format.md-Vorlage für den Seitentyp: Behauptungsseiten (Methode / Fallstrick / Thema) verwenden als Schlüssel den stabilen Betreffnamen, Ereignisseiten (Entscheidungen / Evidenz / Protokoll) verwenden als Schlüssel das Datum.
  • Keine aliasierten Wiki-Links erscheinen innerhalb von Markdown-Tabellen.

Verhaltensüberprüfung:

  • Führe neat-freak nicht aus oder rufe es nicht auf, es sei denn, es wurde explizit angefordert.
  • Weite nicht auf Dokumentenbereinigung, Speichersynchronisation oder Formatierungsänderungen aus.
  • Verwalte keine agentenlokale Skill-Installation, es sei denn, es wurde explizit angefordert.
  • Schreibe nicht, wenn sich nichts geändert hat; die Meldung "nichts geändert" ist ein gültiges Ergebnis.

Validierung

Wenn Dateien erstellt, verschoben, umbenannt wurden oder der Benutzer Threads/Agenten wechselt, führe die schreibgeschützte Health-Suite vom Vault-Stammverzeichnis aus:

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

Für reine Inhaltsbearbeitungen führe die kleinste relevante Prüfung aus und berichte, was übersprungen wurde.

Häufige Fehlermodi

FehlerKorrektur
"Andere Agenten ohne diese Fähigkeit werden nicht kristallisieren."Installations-/Aktualisierungsverteilung löst das. Dupliziere Verhalten nicht in Protokolle.
Liest llm-wiki-protocol.md ## Crystallize.Stopp; diese Fähigkeit besitzt das Crystallize-Verhalten. Protokolle definieren nur Formate und Gesundheitschecks.
Behandelt 收尾 oder "cleanup docs" als Crystallize.Nur bei dedizierten Wörtern oder expliziter Evidenzabsicht auslösen.
Schreibt Prozessprotokolle in llm-wiki/.Nur stabile Schlussfolgerungen gehören dorthin.
Hängt an veraltete Handoff-Listen an.Schreibe gleitende Fenster innerhalb der dokumentierten Grenzen neu.
Hängt einen neuen, datierten Eintrag an eine Behauptungsseite (Methoden / Fallstricke / Thema) an, anstatt zusammenzuführen.Behauptungsseiten verwenden als Schlüssel das Subjekt: Finde den vorhandenen Eintrag, schreibe ihn direkt um, aktualisiere updated / 验证于.

Verwandte Skills