Was macht Concept Forge?
Concept Forge verwandelt eine beiläufige Frage eines Benutzers in ein dauerhaftes Konzept-Asset: eine prägnante Antwort, eine strukturierte Wissenskarte, einen Quarkdown-Leseentwurf, eine Slidev-Präsentationsvorlage und eine eigenständige interaktive HTML-Erklärung.
Das Ziel ist nicht, eine einmalige Antwort zu liefern. Das Ziel ist es, das Konzept leichter merkbar zu machen und eine wiederverwendbare lokale Wissens-/HTML-Bibliothek im Laufe der Zeit aufzubauen.
Kernablauf
Halte dich immer an diese Reihenfolge:
- Normalisiere die Frage: identifiziere das Kernkonzept, Aliasse, Vergleichsziele und die Benutzerabsicht.
- Suche zuerst nach vorhandenen Einträgen mit
scripts/concept_forge.py lookup. - Plane die Tiefe mit
scripts/concept_forge.py planoder der Recherche-Methode: wähle Schnell, Standard oder Tief. - Wiederverwenden vor Neuerstellung: wenn eine gute Übereinstimmung existiert, gib die vorhandene direkte Antwort und den HTML-Pfad zurück. Aktualisiere nur, wenn der Benutzer darum bittet, der Eintrag veraltet ist oder das Konzept zeitkritisch ist.
- Recherchiere in der gewählten Tiefe, wenn kein brauchbarer Eintrag existiert: verwende die folgende Concept Lens und führe eine Websuche durch, wenn sich das Thema geändert haben könnte oder genaue Quellenangaben wichtig sind.
- Schmiede den Konzeptdatensatz als strukturiertes JSON unter Verwendung von
references/concept-schema.md. - Rendere und speichere mit
scripts/concept_forge.py upsert; dies muss JSON-, Quarkdown-, Markdown-, HTML- und Slidev-Quell-Artefakte erstellen. - Überprüfe den Auslieferungszweig mit
scripts/concept_forge.py bootstrap "<ursprüngliche Anfrage>", wenn der Benutzer nach formalem Lesen, PDF, Folien, Vortrag, Vorschau, Build oder Export gefragt hat. - Validiere den gespeicherten Eintrag und die generierten Artefakte mit
scripts/concept_forge.py validate. - Berichte auf Chinesisch: gib zuerst immer die Antwort, dann den lokalen HTML-Pfad. Vermeide Implementierungsdetails, es sei denn, danach wird gefragt.
Antwortformat für den Benutzer
Jede abgeschlossene Anfrage muss zwei Dinge in dieser Reihenfolge zurückgeben:
- Direkte Antwort: 1-3 kurze chinesische Sätze, die die Frage des Benutzers sofort beantworten. Bevorzuge eine anschauliche Analogie, wenn sie das Verständnis fördert. Diese sollte für sich allein stehen können, auch wenn Benutzer keine Zeit haben, das HTML zu öffnen.
- Interaktives HTML: ein lokaler Pfad oder Link zur generierten/wiederverwendeten HTML-Erklärseite.
Verwende ein kompaktes Format wie:
一句话说,Skill 像给 AI 准备的一本小手册:Prompt 是这次怎么做,Skill 是以后遇到同类任务都按这套做。
互动页:<path/to/html>
Zwinge den Benutzer nicht, das HTML zu öffnen, um die grundlegende Antwort zu erhalten.
Arbeitsbereich
Standard-Arbeitsbereich:
<aktuelles Arbeitsverzeichnis>/concept-forge-workspace
Wenn der Benutzer einen anderen Speicherort angibt, verwende diesen. Initialisiere vor der ersten Verwendung:
python <skill>/scripts/concept_forge.py init --workspace <Arbeitsbereich>
Der Arbeitsbereich enthält:
knowledge/index.json
knowledge/concepts/<slug>/concept.json
knowledge/concepts/<slug>/concept.qd
knowledge/concepts/<slug>/concept.md
knowledge/concepts/<slug>/sources.json
html/<slug>.html
slidev/<slug>/slides.md
slidev/<slug>/package.json
quarkdown/
assets/
config.json
Concept Lens (Konzeptionslinse)
Entlehne den Geist der hv-Analyse, aber halte es leicht und konzeptgroß.
Für jedes neue oder aktualisierte Konzept beantworte diese Ebenen:
- Einzeilige Eselsbrücke: die kürzeste sinnvolle Definition.
- Direkte Antwort: eine chat-taugliche Erklärung, normalerweise ein kurzer Absatz, optional mit einer Metapher.
- Was es ist: Erklärung in einfacher Sprache.
- Warum es existiert: welches Problem, welche Verwirrung, welcher Arbeitsablauf oder historischer Wandel die Notwendigkeit dafür geschaffen hat.
- Wie es funktioniert: der minimale Mechanismus, der zum Verständnis nötig ist.
- Was es nicht ist: häufige Missverständnisse und Abgrenzungen.
- Horizontaler Vergleich: ähnliche Konzepte, Werkzeuge, Prompts, Arbeitsabläufe oder Begriffe, mit denen es oft verwechselt wird.
- Verwandte Karte: übergeordnete Konzepte, verwandte Konzepte, untergeordnete Konzepte, Voraussetzungen und nächste Fragen.
- Beispiel: ein konkretes alltägliches Szenario.
- Eselsbrücke: Metapher, Satz oder visueller Anker, der das Konzept einprägsam macht.
- Mini-Quiz: 2-3 leichte Fragen zur Vertiefung des Verständnisses.
Nutze Internet-Recherche, wenn Fakten aktuell, nischenhaft, umstritten, produktspezifisch oder quellensensitiv sein könnten. Bevorzuge offizielle Dokumentationen und Primärquellen. Wenn nicht recherchiert wird, kennzeichne die Quellen im Datensatz ehrlich als „modellbasiert / benutzerbereitgestellt / lokaler Kontext".
Ausgabemodi
Zweigauswahl
Es gibt drei Produktzweige. Unterscheide sie genau.
- Normaler Konzept-Zweig: Der Benutzer fragt „Was ist X", „Was ist der Unterschied zwischen X und Y", „Hilf mir, dieses Konzept zu verstehen/merken/ordnen" oder gibt ein Stichwort. Generiere direkte Antwort, Quarkdown-Quelle, Slidev-Quelle, HTML und Index. Fordere nicht zur Installation von Quarkdown oder Slidev auf.
- Formeller Lese-Zweig: Der Benutzer fragt nach „正式阅读", „langem Dokument", „Bericht", „PDF", „Dokument", „Drucken", „Kompilieren", „Exportieren", „Ausliefern" oder nennt explizit Quarkdown. Führe
bootstrapvor dem Kompilieren aus. Wenn Quarkdown fehlt, stoppe vor dem Kompilieren/Exportieren und zeige Installationsanleitung. - Formeller Präsentations-Zweig: Der Benutzer fragt nach „Präsentation", „öffentlichem Vortrag", „Unterrichtsmaterial", „Folien", „PPT", „slides", „deck", „presentation", „Vorschau", „Build", „Exportieren" oder nennt explizit Slidev. Führe
bootstrapvor der Vorschau/dem Build/dem Export aus. Wenn Node/npm oder Slidev-Projektabhängigkeiten fehlen, stoppe vor der Vorschau/dem Build/dem Export und zeige Einrichtungsanleitung.
Wenn der Benutzer sowohl nach Lesen als auch nach Präsentation fragt, verwende Quarkdown als Mutterentwurf und Slidev als abgeleiteten Vortragsentwurf und überprüfe dann beide Zweige.
Hilfsbefehle für Zweige:
python <skill>/scripts/concept_forge.py --workspace <Arbeitsbereich> plan "<ursprüngliche Anfrage>"
python <skill>/scripts/concept_forge.py --workspace <Arbeitsbereich> bootstrap "<ursprüngliche Anfrage>"
python <skill>/scripts/concept_forge.py --workspace <Arbeitsbereich> bootstrap --intent quarkdown
python <skill>/scripts/concept_forge.py --workspace <Arbeitsbereich> bootstrap --intent slidev
python <skill>/scripts/concept_forge.py --workspace <Arbeitsbereich> bootstrap --intent all
Vorhandener Eintrag
Wenn die Suche einen starken vorhandenen Eintrag findet:
- Sage, dass er bereits existiert.
- Gib die kurze Antwort aus
direct_answer, falls vorhanden, sonst verwendesummaryplusmemory_hook. - Verlinke die lokale HTML-Seite.
- Biete an, was nur dann aktualisiert werden kann, wenn es sinnvoll ist; baue nicht standardmäßig neu auf.
Neuer Eintrag
Für ein neues Konzept:
- Erstelle einen JSON-Datensatz gemäß
references/concept-schema.md. - Enthalte mindestens: Titel, Aliasse, Tiefe, direkte Antwort, Zusammenfassung, was, warum, nicht, Vergleiche, verwandte, Eselsbrücke, Quiz, Quellen.
- Führe aus:
python <skill>/scripts/concept_forge.py upsert --workspace <Arbeitsbereich> --input <concept.json>
python <skill>/scripts/concept_forge.py validate --workspace <Arbeitsbereich> --slug <slug>
- Gib zuerst die direkte Antwort zurück, dann den generierten HTML-Pfad. Erwähne Quarkdown- oder Slidev-Pfade nur, wenn der Benutzer nach Dateien, Leseentwürfen, Vorträgen, Exporten oder Debugging fragt.
Aktualisierung
Aktualisiere nur, wenn:
- der Benutzer um Aktualisierung / Wiederholung / Erweiterung bittet;
- das Alter des Eintrags
refresh_policy.daysüberschreitet; - das Thema aktuell oder schnelllebig ist;
- Quellen schwach oder nicht vorhanden sind;
- der Benutzer eine spezifischere Anschlussfrage stellt, die die Konzeptgrenzen verschiebt.
Beim Aktualisieren behalte vorhandene Aliasse und verwandte Links bei, es sei denn, sie sind eindeutig falsch.
HTML-Anforderungen
Verwende references/html-explainer.md für die genaue Produktform.
Die generierte Seite muss eigenständig sein und muss enthalten:
- Helden-Definition;
- Abschnitte „Was / Warum / Nicht";
- Vergleichskarten;
- Verwandte Konzeptkarte;
- Zeitleiste oder Ursprungsleiste, wenn nützlich;
- Interaktive Aufdeckkarten;
- Mini-Quiz;
- „Drei Dinge zum Merken";
- Quellen-/Aktualisierungsfußzeile.
Die Seite sollte auch ohne das Chat-Transkript verständlich sein.
Erstklassige Quarkdown- und Slidev-Unterstützung
Quarkdown und Slidev sind Teil der Produktform.
- Erzeuge immer
concept.qdals Quarkdown-Mutterentwurf. Es ist das kanonische Lesedokument für die Wissensdatenbank. - Erzeuge immer
slidev/<slug>/slides.mdals Präsentationsentwurf. Er wird aus dem Konzeptdatensatz und dem Mutterentwurf extrahiert. - Erzeuge immer
html/<slug>.htmlals schnelle interaktive Gedächtnisoberfläche. - Verwende dynamische Tiefe, um zu entscheiden, wie viel Recherche, Quellenarbeit und Verfeinerung hinzugefügt wird:
- Schnell: stabiles kleines Konzept; generiere alle Quell-Artefakte, überspringe normalerweise Kompilierung/Export.
- Standard: Standard für Werkzeuge, Methoden, Vergleiche und „Was ist X"; generiere alle Artefakte und überprüfe die Struktur.
- Tief: Der Benutzer fragt nach Recherche oder das Thema ist aktuell/komplex; verstärke Quellen, Geschichte, horizontalen Vergleich und Vortragsstruktur.
- Kompiliere Quarkdown oder erstelle/exportiere Slidev nur, wenn die Anfrage in einen formellen Zweig eintritt. Die Quellgenerierung darf nicht von der Installation der CLIs abhängen.
- Verwende
scripts/concept_forge.py doctorbei der ersten Verwendung für eine allgemeine Umgebungsprüfung. - Verwende
scripts/concept_forge.py bootstrap "<ursprüngliche Anfrage>"vor dem formellen Kompilieren/Exportieren, um zu entscheiden, ob eine Installationsanleitung angezeigt werden soll. - Für formelles Quarkdown-Lesen ist
quarkdownerforderlich. Wenn es unter Windows fehlt, zeige:irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.ps1 | iex, überprüfe dann mitquarkdown doctor get install-dir. - Für die Quarkdown-Kompilierung führe
quarkdown c <concept.qd> --strict --out <verify-dir>aus, wennquarkdownverfügbar ist. - Für formelle Slidev-Präsentationen sind Node sowie npm oder pnpm erforderlich. Führe in
slidev/<slug>npm installoderpnpm installaus, dann bei Bedarfnpm run dev,npm run buildodernpm run export. - Für den Slidev-PDF/PPTX-Export installiere zuerst
playwright-chromiumim generierten Folienprojekt:npm i -D playwright-chromium.
Qualitätssicherung
Bevor du den Abschluss meldest, überprüfe:
- Die Suche wurde vor der Erstellung durchgeführt;
- Die endgültige Antwort enthält sowohl eine direkte Antwort als auch einen HTML-Pfad;
- Das Konzept hat eine klare einzeilige Eselsbrücke;
- Ähnliche Konzepte und Missverständnisse werden abgedeckt;
- HTML existiert und ist nicht leer;
- Der Quarkdown-Mutterentwurf existiert;
- Die Slidev-Quelle existiert;
- Formelle Zweige haben
bootstrapvor dem Kompilieren/Exportieren ausgeführt; - Fehlende formelle Werkzeuge wurden gemeldet, bevor der Kompilierungs-/Exportversuch unternommen wurde;
- Die Validierung (
validate) ist bestanden; - Der Index enthält Titel, Aliasse, Slug, direkte Antwort, Zusammenfassung, Quarkdown-Pfad, Slidev-Pfad und HTML-Pfad;
- Die endgültige Antwort ist kurz, auf Chinesisch und für den Benutzer bestimmt.
Referenzen
references/concept-schema.md: JSON- und Markdown-Datensatzformat.references/research-method.md: leichte hv-Analyse-Anpassung.references/html-explainer.md: Spezifikation für das interaktive HTML-Produkt.