CommunityRecherche & Datenanalysegithub.com

Concept Forge

Allgemeine KI-Agenten-Fähigkeit: Verwandelt beiläufig gefragte Konzepte, Begriffe und „Was ist der Unterschied zwischen X und Y“ in eine prägnante Erklärung, ein Quarkdown-Wissensroh-Manuskript, eine interaktive HTML-Seite und eine Slidev-Präsentationsvorlage – und baut so eine wiederverwendbare persönliche Wissensdatenbank auf. Kompatibel mit Codex / Claude Code / Miaoclaw und anderen Assistenten, die SKILL.md unterstützen, auch eigenständig über die CLI nutzbar.

Was ist Concept Forge?

Concept Forge ist eine KI-Agenten-Fähigkeit (Skill), die entwickelt wurde, um flüchtige Fragen in dauerhafte Konzept-Assets zu verwandeln. Sie nimmt eine ungeordnete Frage eines Benutzers zu einem Konzept, einem Begriff oder einem Vergleich und erzeugt daraus eine strukturierte Antwort, eine interaktive HTML-Erklärseite, ein Quarkdown-Dokument als Mutterentwurf und eine Slidev-Präsentationsvorlage. Das Ziel ist nicht eine einmalige Antwort, sondern die Schaffung eines wiederverwendbaren Eintrags in einer lokalen Wissensdatenbank, der das Verständnis und das spätere Abrufen erleichtert. Der Skill folgt einem strengen Kernablauf: Normalisierung der Frage, Suche nach vorhandenen Einträgen, Planung der Recherchetiefe (Schnell, Standard, Tief), Wiederverwendung bestehender Einträge, gezielte Recherche, Erstellung eines strukturierten JSON-Datensatzes, Generierung aller Artefakte (JSON, Quarkdown, Markdown, HTML, Slidev-Quellen), Validierung und schließlich Ausgabe einer kurzen, direkten Antwort auf Chinesisch zusammen mit dem Pfad zur interaktiven HTML-Seite. Der Skill unterstützt drei Hauptausgabe-Zweige: den normalen Konzept-Zweig, den formellen Lese-Zweig (für Quarkdown-Exporte) und den formellen Präsentations-Zweig (für Slidev-Exporte). Er enthält auch eine „Concept Lens“ (Konzeptionslinse) für eine tiefgehende, mehrschichtige Analyse eines Konzepts, einschließlich einzeiliger Eselsbrücke, direkter Antwort, Definition, Zweck, Funktionsweise, Abgrenzung und mehr.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add FeixueCode/concept-forge

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

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:

  1. Normalisiere die Frage: identifiziere das Kernkonzept, Aliasse, Vergleichsziele und die Benutzerabsicht.
  2. Suche zuerst nach vorhandenen Einträgen mit scripts/concept_forge.py lookup.
  3. Plane die Tiefe mit scripts/concept_forge.py plan oder der Recherche-Methode: wähle Schnell, Standard oder Tief.
  4. 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.
  5. 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.
  6. Schmiede den Konzeptdatensatz als strukturiertes JSON unter Verwendung von references/concept-schema.md.
  7. Rendere und speichere mit scripts/concept_forge.py upsert; dies muss JSON-, Quarkdown-, Markdown-, HTML- und Slidev-Quell-Artefakte erstellen.
  8. Ü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.
  9. Validiere den gespeicherten Eintrag und die generierten Artefakte mit scripts/concept_forge.py validate.
  10. 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:

  1. 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.
  2. 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.

  1. 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.
  2. Formeller Lese-Zweig: Der Benutzer fragt nach „正式阅读", „langem Dokument", „Bericht", „PDF", „Dokument", „Drucken", „Kompilieren", „Exportieren", „Ausliefern" oder nennt explizit Quarkdown. Führe bootstrap vor dem Kompilieren aus. Wenn Quarkdown fehlt, stoppe vor dem Kompilieren/Exportieren und zeige Installationsanleitung.
  3. 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 bootstrap vor 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 verwende summary plus memory_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:

  1. Erstelle einen JSON-Datensatz gemäß references/concept-schema.md.
  2. Enthalte mindestens: Titel, Aliasse, Tiefe, direkte Antwort, Zusammenfassung, was, warum, nicht, Vergleiche, verwandte, Eselsbrücke, Quiz, Quellen.
  3. 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>
  1. 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.qd als Quarkdown-Mutterentwurf. Es ist das kanonische Lesedokument für die Wissensdatenbank.
  • Erzeuge immer slidev/<slug>/slides.md als Präsentationsentwurf. Er wird aus dem Konzeptdatensatz und dem Mutterentwurf extrahiert.
  • Erzeuge immer html/<slug>.html als 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 doctor bei 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 quarkdown erforderlich. Wenn es unter Windows fehlt, zeige: irm https://raw.githubusercontent.com/quarkdown-labs/get-quarkdown/refs/heads/main/install.ps1 | iex, überprüfe dann mit quarkdown doctor get install-dir.
  • Für die Quarkdown-Kompilierung führe quarkdown c <concept.qd> --strict --out <verify-dir> aus, wenn quarkdown verfügbar ist.
  • Für formelle Slidev-Präsentationen sind Node sowie npm oder pnpm erforderlich. Führe in slidev/<slug> npm install oder pnpm install aus, dann bei Bedarf npm run dev, npm run build oder npm run export.
  • Für den Slidev-PDF/PPTX-Export installiere zuerst playwright-chromium im 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 bootstrap vor 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.

Verwandte Skills