alfredzhang98/research-obsidian-skill

AI-Wiki – Inhalt in die Wissensdatenbank einpflegen (leichtgewichtig, Standard)

Wandelt „Schreib das auf“ in eine korrekt benannte, korrekt verlinkte Notiz im KI-verwalteten Ordner um.

Dieser Befehl erstellt keine Themen. Er erzeugt eine Notiz und benötigt mindestens einen [[Wikilink]] zu einer vorhandenen Notiz. Um eine Notiz unter einem Themen-Hub mit reziproken Links zu platzieren, verwende /ai-wiki-full.

Warum Themen standardmäßig deaktiviert sind: Wenn jedes Paper seinen eigenen Hub bekommt, organisiert der Hub nichts – er gibt dem Paper nur einen längeren Namen. Ein Thema ist eine Forschungsrichtung, nicht der Gegenstand eines Papers. Der Test steht in references/note-specs.md unter „Was qualifiziert als Thema“.

Wohin die Ausgabe geht

Alles, was diese Fähigkeit ablegt, landet im KI-verwalteten Ordner.

Zone	Wie damit umgehen
KI-verwalteter Ordner (<AI_WIKI>/**)	Erstellen / Bearbeiten / Verschieben / Umbenennen / Löschen – freie Hand
Die eigenen Notizordner des Benutzers	Frei lesen und durchsuchen; additive Änderungen in Ordnung; vor Löschen, Umbenennen, Verschieben oder Überschreiben fragen
.claude/rules/, CLAUDE.md	Statische Konfiguration – nur bearbeiten, wenn der Benutzer darum bittet, Claudes Verhalten zu ändern; updated: erhöhen. Die einzige dynamische Ausnahme ist .claude/rules/active.md
.obsidian/, .trash/	Erreichbar, aber finger weg – die Bearbeitung der Obsidian-Konfiguration kann den Vault beschädigen

Nichts ist auf Berechtigungsebene blockiert, daher ist die obige Zurückhaltung eine Frage des Urteilsvermögens. Ein Vault ist normalerweise kein Git-Repo; ein schlechtes Überschreiben einer handschriftlichen Notiz ist nur über die Dateisynchronisations-Versionsgeschichte wiederherstellbar.

Aus diesen Zonen zu lesen und eine Zusammenfassung in den KI-verwalteten Ordner abzulegen, ist genau das, wofür diese Fähigkeit da ist.

Referenzdateien – lies die benötigte, nicht alle vier

Datei	Lies sie, wenn
references/vault-guide.md	du dich für welchen Ordner entscheidest – Routing-Tabelle, Beispiel-Benutzerformulierungen, das Tags/Wikilinks-Modell
references/note-specs.md	du eine Paper-Notiz, Lernnotiz oder Themenplanung schreibst – Dateinamen, Frontmatter, Abschnittsspezifikationen, Formulierungsregeln
references/figures-diagrams.md	die Notiz Abbildungen benötigt – Extraktionsbefehl, Einbettungsformat, Mermaid-Regeln
references/tools.md	du entscheidest, welche Fähigkeit oder CLI die Eingabe verarbeitet, plus die End-to-End-Workflows

Routinemäßiges Ablegen (ein offensichtlicher Ordner, keine Abbildungen) benötigt keine davon – das folgende Verfahren reicht aus.

Verfahren

1. Klassifizieren – wähle genau einen Zielordner aus der Routing-Tabelle in references/vault-guide.md. Ein Inhalt, ein Ordner; alles Querschnittliche wird über tags: und [[Wikilinks]] abgebildet, niemals durch eine doppelte Kopie.
   • Unverbindliche, explorative oder Batch-Treffer kommen in Inbox/, nicht in einen echten Ordner.
   • Wirklich mehrdeutig zwischen zwei Ordnern: frage, rate nicht und verdoppele nicht.
2. Benennen – gemäß references/note-specs.md (lowercase-kebab-case):
   • Paper → Research/papers/<erster-autor-nachname>-<jahr>-<2-3-schlagwort-slug>.md (dieser Befehl erstellt kein Thema, daher liegt die Notiz im Stammverzeichnis von papers/; /ai-wiki-full platziert sie in papers/<topic-slug>/)
   • Lernen → Research/learning/<topic-slug>-<YYYYMMDD>.md
3. Zuerst nach einer vorhandenen Notiz suchen – Glob den Zielordner, bevor geschrieben wird (für Paper Research/papers/**/*.md verwenden; beachte die themenspezifischen Unterordner). Die richtige Notiz zu aktualisieren ist besser, als eine fast identische zu erstellen; wenn bereits eine existiert, füge sie zusammen und teile dies mit.
4. Befüllen – Read das passende Skelett in Templates/ (paper-note.md / learning-note.md) und fülle es an Ort und Stelle aus; baue die Struktur niemals aus dem Gedächtnis neu auf. Die Abschnittsanleitung steht in references/note-specs.md, nicht in den {{...}}-Prompts des Skeletts.
   • Die > [!callout]-Blöcke sind das Betonungssystem – behalte sie bei, füge keine neuen Typen hinzu.
   • Die Kurzkarte oben wird zuletzt geschrieben: Sie komprimiert die fertige Notiz. Wenn ihre sechs Zeilen nicht gefüllt werden können, ist die Notiz darunter nicht fertig.
   • S0 „Was dieses Paper tut, in einfacher Sprache“ ist obligatorisch: 3-5 Sätze für jemanden, der die Grundlagen des Fachgebiets kennt, aber dieses Paper nicht gelesen hat. Reihenfolge: die Situation, der sie gegenüberstehen, was sie gebaut haben, warum es funktioniert, was sie erreicht haben. Wenn du diesen Abschnitt nicht schreiben kannst, hast du das Paper nicht verstanden – halte an und lies es noch einmal, anstatt fortzufahren.
   • Eine Paper-Notiz beantwortet in dieser Reihenfolge: S0 einfache Sprache → S1 Hintergrund → S2 was frühere Arbeiten nicht konnten → S3-S4 Methode und Mathematik → S5 was durchgeführt wurde → S6 was herauskam → S7 Einschränkungen und die zukünftige Arbeit der Autoren → S8 meine Analyse und Forschungschancen.
   • S2 und S8 sind der Grund, warum die Notiz existiert – keiner darf mit generischer Prosa gefüllt werden. S4s Mathematik muss aus der Notiz rekonstruierbar sein, nicht nur erkennbar.
   • Jede S8-Chance trägt alle vier Zeilen (Chance → warum noch ungelöst → erstes Experiment → unter welchem Thema es abgelegt wird). „Keine erwägenswerte Chance – “ ist gültig; eine erfundene nicht.
   • Professionelle Formulierung: keine metaphorischen Bezeichnungen („dieser Schnitt des Papers“, „das Urteil“, „stärkste Zahl“). Siehe die Formulierungstabelle in references/note-specs.md. Jedes Urteil muss auf spezifischen Belegen beruhen.
   • Lies das Paper, bevor du schreibst. Fülle niemals einen Abschnitt aus der Zusammenfassung; wenn der PDF-Text für einen Abschnitt nicht verfügbar ist, schreibe {{nicht in der Quelle verfügbar}} anstelle von plausiblen Fülltext.
5. Abbildungen – gemäß references/figures-diagrams.md: Paper-Abbildungen über die paper-figures-Fähigkeit in _attachments/paper-figures/<paper-slug>/ (der Anhangsbaum bleibt flach, niemals in Themenordner gespiegelt), eingebettet in dem Abschnitt, in dem jede Abbildung ihre Arbeit tut.
   • Das Einbettungspräfix hängt von der Tiefe der Notiz ab: ../../_attachments/... im Stammverzeichnis von papers/, ../../../_attachments/... innerhalb von papers/<topic-slug>/. Dies ist das eine, das stillschweigend fehlschlägt, wenn eine Notiz verschoben wird – überprüfe ein Bild stichprobenartig.
   • Verfasste Diagramme verwenden einen Mermaid-Fence. ASCII-Kunst ist verboten.
6. Verlinken (obligatorisch, mindestens einer) – die Notiz muss mindestens einen [[Wikilink]] zu einer vorhandenen Notiz tragen: einem Hub in Research/topics/, einer anderen Paper-Notiz oder einer Lernnotiz.
   • Glob zuerst Research/topics/ und Research/papers/, wähle das nächstgelegene Ziel aus und gib die Beziehung in einem Satz an, anstatt einen bloßen Link fallen zu lassen.
   • Dieser Befehl erstellt keine Themen. Wenn es wirklich nichts zum Verlinken gibt, vermerke in .claude/rules/active.md, dass dies ein neues Gebiet eröffnet, und teile dem Benutzer mit, dass /ai-wiki-full der Befehl ist, der einen Hub erstellt.
   • Wenn die Notiz in ein vorhandenes Thema passt, füge den Vorwärtslink zur S6-Liste dieses Themas hinzu – reziproke Links lassen den Graphen clustern.
7. Registrieren – wenn dies eine neue Richtung eröffnet oder eine laufende Arbeit ist, füge einen einzeiligen Zeiger zu .claude/rules/active.md hinzu und erhöhe dessen updated:. Spiegele dort keinen Zustand wider. active.md ist die einzige Regeln-Datei, die dieser Workflow ohne explizite Aufforderung zur Konfigurationsänderung berührt.

Selbstprüfung vor dem Abschluss

• Jeder geschriebene Pfad befindet sich im KI-verwalteten Ordner
• Dateiname entspricht der Spezifikation für seinen Notiztyp; eine Paper-Notiz liegt im Stammverzeichnis von papers/ (dieser Befehl erstellt kein Thema)
• Einbettungspräfix passt zur Tiefe der Notiz, und mindestens ein Bild wurde stichprobenartig überprüft
• Frontmatter vollständig (tags: vorhanden und spezifisch, nicht nur research/)
• Mindestens ein [[Wikilink]] zu einer vorhandenen Notiz, mit angegebener Beziehung
• Aus der tatsächlichen Vorlagendatei erstellt, Abschnittsreihenfolge und Callouts intakt
• S0 allgemeinverständliche Zusammenfassung ausgefüllt, ohne Jargon-Überfrachtung
• Kurzkarte zuletzt geschrieben; alle sechs Zeilen sind konkrete Aussagen und sie steht für sich
• Kein {{Platzhalter}} in der ausgelieferten Notiz hinterlassen
• Keine metaphorischen Bezeichnungen
• Abbildungen inline eingebettet, nicht am Ende abgeladen
• Paper-Notiz: S2 nennt tatsächliche frühere Methoden und deren spezifisches Versagen; S7 trennt Autoren-angaben / meine / deren zukünftige Arbeit; S8s Schlussfolgerung zitiert Belege und jede Chance hat alle vier Zeilen
• Lernnotiz: S1 ist die Frage des Benutzers wörtlich; S5 hat ein echtes numerisches Beispiel
• Dem Benutzer die genauen geschriebenen Pfade mitgeteilt

Verwandtes

Um einen Themen-Hub mit reziproken Links zu erstellen oder zu finden, verwende /ai-wiki-full. Werkzeugauswahl nach Eingabetyp: references/tools.md. Zonenregeln vollständig: .claude/rules/permissions.md.