Skip to content

GodModeAI2025/SkillSafe / wissenstresor

wissenstresor

Flagged

Lokaler, evidenzgebundener Wissensspeicher als portabler purer Skill (Profil oksv-lite über Google OKF v0.1/v0.2). Beantwortet Fragen AUSSCHLIESSLICH aus kuratierten Claims: deterministisches Hybrid-Retrieval aus Begriffswelten, Wortformen und einem Graph-Hop meldet, wie gut es die Frage verstanden hat; die Bedeutungssuche ist eine Vollsichtung aller Claims mit Quittung — ohne Cloud, Vektorstore oder Embeddings. Bindet Bilder, Scans und PDFs über geprüfte Regionen an Claims. Belegt fremdes Material satzweise über Anker auf aufgeführte externe Quellen, mit Live-Nachschlagen im Fallback. Meldet ungedecktes Wissen als "Nicht im Bestand", nie aus Modellwissen ergänzt. IMMER verwenden bei: Wissenstresor, SkillSafe, Knowledge Vault, "frag den Tresor", "steht das im Bestand", Bedeutungssuche, semantische Suche, Vollsichtung, Begriffswelt, Synonym, Hybrid Retrieval, RAG-ähnliche Suche, Bild oder PDF in den Tresor, Quelle einlesen, Bestand prüfen, externe Quelle, Satzanker, fremdes Repo, OKF, Quellenregister.

references/export-okf.md

View on GitHub
# Workflow: Als OKF-v0.2-Bundle exportieren

Ziel: den freigegebenen Bestand so ausgeben, dass ein fremder
OKF-v0.2-Konsument ihn lesen kann, ohne dass sich am internen Datenvertrag
etwas ändert.

Dieser Workflow ist **kein Automatismus**. Er steht bewusst nicht in der
Workflow-Tabelle von `SKILL.md`: kein Antworten-, Befüllen- oder
Lint-Durchlauf ruft ihn auf. Ein Export gibt Wissen aus der Hand, und diese
Entscheidung trifft ein Mensch, nicht ein Trigger.

## Kommando

```bash
python3 scripts/vault.py export --okf --out <zielordner> [--with-sources]
```

## Sechs Regeln

1. **Menschenakt.** Der Export läuft nur, wenn jemand ihn aufruft. Wird er in
   einem Skript verkettet, gehört an diese Stelle ein Kommentar, warum.
2. **Kein Skill-Ladeort.** Ein Ziel mit dem Pfadsegment `.claude` oder
   `.codex` bricht fail-closed ab, sowohl buchstäblich als auch nach
   Auflösung von Symlinks. Grund: ein exportiertes Bundle hat keine Engine,
   kein Manifest und keine Regeln. Landet es in einem Skill-Ordner, lädt ein
   Agent es als Wissensquelle ohne jede Absicherung, und die Trennung aus
   AD-06 ist aufgehoben.
3. **Kein Ziel im Tresor und kein Fremdinhalt.** Das Ziel muss außerhalb von
   `ROOT` liegen und entweder nicht existieren, leer sein oder ein früherer
   Export sein. Erkannt wird ein früherer Export am `okf_version` im
   Wurzel-`index.md` (§12). Ein Verzeichnis mit fremdem Inhalt wird nie
   angefasst.
4. **Nur ein freigegebener Release.** `validate` muss grün sein und der Stand
   dem Manifest entsprechen. Ein Zwischenstand wird nicht exportiert, sonst
   entstünde ein Bundle, das zu keinem Release gehört.
5. **Rohquellen nur mit `--with-sources`.** Ohne das Flag bleibt
   `sources[].resource` ein nicht folgbarer Deskriptor, was §5.1
   ausdrücklich erlaubt. Die Rechte-Spalte des Registers ist Freitext; ob
   eine Ablage weitergegeben werden darf, kann kein Script entscheiden. Wer
   das Flag setzt, bestätigt damit, die Rechte geprüft zu haben.
6. **Einbahnstraße.** Es gibt kein `import-okf`. Fremdes OKF-Wissen kommt
   denselben Weg wie jede andere Quelle: Quarantäne, lokaler Abzug,
   Registrierung, Claim-Extraktion (`references/befuellen.md`).

## Was der Export abbildet

| intern | im Bundle |
|---|---|
| `status: aktiv` / `veraltet` / `in-pruefung` | `status: stable` / `deprecated` / `draft` (§5.4) |
| `sources: [S-nnnn]` plus Registerzeile | `sources`-Liste mit `id`, `resource`, `title`, `last_modified` (§5.1) |
| `externe_quellen: [X-nnnn]` plus Zeile aus `sources/EXTERN.md` | derselbe `sources`-Block; `resource` ist das registrierte https-Präfix, sonst ein nicht folgbarer Deskriptor. Dazu `oksv_external_kind` |
| Trust `T1`/`T2`/`T3` | `oksv_trust` pro Quelleneintrag, ausdrücklich kein v0.2-Feld |
| `geprueft_von` / `geprueft_am` | `verified: { by, at }` mit `mensch:` zu `human:`, `prozess:` zu `process:`, `agent:x/y` zu `x/y` (§5.2, §7) |
| Claim-Zeile | unverändert plus Fußnote `[^S-nnnn]` bzw. `[^X-nnnn]`; das Label ist die Quellen-ID, weil §5.1 sie als Join-Key nennt |
| Satzanker `A-nnnn` | in der Fußnote als „Dokument Satz n" hinter dem Quellentitel |
| `relations` | Abschnitt „Beziehungen" mit bundle-relativen Links, führender Slash (§6.1) |
| erster Satz der Kurzfassung | `description` (§4.1) |
| `confidence`, `domain`, `version`, `stand`, `concepts` | `oksv_`-Zusatzschlüssel, nach §4.1 erlaubt |
| Vorzugsbegriffe der `concepts` | `oksv_concept_labels` im Frontmatter, nicht im Rumpf |
| `INDEX.md` (Tabelle) | `index.md` pro Verzeichnis als Bullet-Liste (§8), Wurzel mit `okf_version` (§12) |
| `log.md` (grep-barer Präfix) | `log.md` datumsgruppiert, neueste zuerst (§9) |

## Ersetzen statt ergänzen

Der Export schreibt zuerst vollständig in ein frisches Staging-Verzeichnis
neben dem Ziel und ersetzt das Ziel danach in einem Zug. Das hat drei Gründe.
Das Staging enthält keine Symlinks, also kann kein vorbereiteter Link im
Zielordner den Schreibvorgang aus dem Ziel heraustragen. Ein Abbruch
hinterlässt keinen Halbstand, das Ziel bleibt unverändert. Und ein früherer
Export wird ersetzt, nicht übermischt: eine Seite, die es im Bestand nicht
mehr gibt, bleibt sonst als vollständig konformes Dokument im Bundle stehen
und ist von echtem Inhalt nicht zu unterscheiden.

Wer ein Bundle behalten will, kopiert es weg, bevor er neu exportiert.

## Was der Export bewusst nicht kann

* **`generated`.** Der Tresor weiß, wer geprüft hat, nicht wer geschrieben
  hat. Das Feld bleibt leer statt einen Aktor zu erfinden.
* **`sources[].author`.** Das Register hat keine Urheberspalte. Eine achte
  Spalte wäre nachrüstbar, ist aber eine eigene Entscheidung.
* **`usage_count` und `usage_window`.** Ein lokaler Tresor ohne Telemetrie
  hat diese Zahlen nicht.
* **`last_modified` bei nicht-datumsförmigem Stand.** Steht in der Spalte
  „Stand/Version" etwas wie `v0.2 / 2026-07-24`, bleibt das Feld weg. Ein
  Datum daraus zu raten wäre genau die Art Vermutung, die Regel 4 verbietet.
* **`stale_after`.** Der interne Vertrag kennt kein Verfallsdatum. Kommt es,
  wandert es hier mit.
* **Der zitierte Satzwortlaut externer Quellen.** Ein Satzanker trägt den
  Wortlaut im Tresor (`sources/derived/X-nnnn__anchors.json`), aber die
  Ankerdatei wandert nicht ins Bundle. Der Export gibt nur den Zeiger aus:
  Quelle, Dokument und Satzposition in der Fußnote. Ein Bundle ist gegenüber
  externen Quellen deshalb **nicht selbsttragend** — wer den Wortlaut
  nachlesen will, braucht Zugang zur aufgeführten Quelle. Das ist die
  Kehrseite davon, fremdes Material nicht einzufrieren, und keine Lücke, die
  sich durch Mitkopieren schließen ließe: dann wäre es wieder eingefroren.
* **Der Bindungspfad.** `.vault-extern.json` ist host-lokal und verlässt den
  Tresor nie — weder als `resource` noch sonstwo. Ein absoluter Pfad hat
  außerhalb dieser Maschine keine Bedeutung und wäre eine Preisgabe der
  lokalen Ablagestruktur. Eigener Test.
* **`Attested Computation`.** Bewusst abgelehnt, siehe AD-09 in
  `KONZEPT.md`.
* **Das Trust-Tier.** Es wird nicht geschrieben. Das Profil sagt zu, dass es
  nur abgeleitet und nie gespeichert wird, und ein Konsument leitet es nach
  §5.3 ohnehin selbst aus `verified` ab.
* **§11-Konformanz mit `--with-sources`.** Die kopierten Rohquellen sind
  byteidentisch zum Original, damit ihr Hash gegen das Register prüfbar
  bleibt. Markdown-Rohquellen tragen deshalb weiterhin ihr eigenes
  Frontmatter mit dem Schlüssel `typ` statt `type` und sind damit keine
  OKF-Konzeptdokumente. Ein Bundle mit `--with-sources` erfüllt §11
  Bedingung 2 also bewusst nicht. Wer strikte Konformanz braucht, exportiert
  ohne das Flag; wer die Evidenz braucht, nimmt die Abweichung in Kauf. Einen
  konformen Kopf voranzustellen wäre der dritte Weg und scheidet aus, weil er
  die Byte-Identität und damit die Hash-Prüfbarkeit zerstört.

## Nach dem Export

Der Export schreibt nichts im Tresor und ist kein Release-Ziel. `VERSION`,
`MANIFEST.sha256` und `log.md` bleiben unberührt. Zwei Exporte desselben
Stands sind byteidentisch; wer das prüfen will, vergleicht die Hashes der
Zielbäume.

Das Ergebnis ist eine Momentaufnahme, kein zweiter Tresor. Es trägt keine
Prüfsummen und keine Regeln, und es wird nicht mitgepflegt. Wer es weitergibt,
gibt einen Stand weiter, nicht ein System.
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall