Communitygithub.com

소크라틱 — 가르치고, 묻고, 채점하며 판다

Persönliche Agenten-Fähigkeitsbibliothek (Agent Skills Spezifikation · Claude Code Plugin · installierbar in Codex, Cursor, Gemini CLI…) — Design-Varianten-Runden, sokratisch, Orchestrierungsschleife, Orca-Handoff

Was ist 소크라틱 — 가르치고, 묻고, 채점하며 판다?

Die Fähigkeit 'jihkyuo/skills' ist eine persönliche, modulare Bibliothek für KI-Agenten-Fähigkeiten, die nach der Agent Skills Spezifikation aufgebaut ist und als Plugin für Claude Code, Codex, Cursor und Gemini CLI installiert werden kann. Sie enthält mehrere spezialisierte Modi: 'socratic' verwandelt mehrdeutige Materialien durch eine strukturierte Frage-Antwort-Schleife (Beschreibung → Quiz → Antwort → Bewertung → Rückfrage) in ein klares Verständnis und eine Liste von Wissenslücken, wobei der Fortschritt in einer 'Verständniskarte' und einer 'Entdeckungstabelle' festgehalten wird, die in jeder Runde aktualisiert werden. 'design-variant-rounds' unterstützt iterative Designentscheidungen, 'orchestration-loop' orchestriert mehrschrittige Arbeitsabläufe und 'orca-handoff' ermöglicht die Übergabe zwischen verschiedenen Agentenkontexten. Der sokratische Modus erzwingt eine vollständige Materialaufnahme vor der ersten Frage (geprüft durch eine Aufnahmetabelle), stellt sicher, dass alle Referenzen innerhalb derselben Runde selbst-erklärend sind (Selbst-Dekodierungs-Invariante) und wechselt explizit zu Entscheidungs- oder Rubrik-Runden, wenn das Verständnis abgeschlossen ist.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add jihkyuo/skills

In Ihrer bevorzugten KI fragen

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

Dokumentation

Sokratisch — Lehren, Fragen, Bewerten und Verkaufen

Ein wechselseitiger Frage-und-Antwort-Prozess (Beschreibung → Quiz → Antwort → Bewertung → Rückfrage), der mehrdeutige Materialien in strukturiertes Verständnis und eine Liste von Wissenslücken verwandelt. Das Verständnis bleibt nicht nur im Kopf, sondern wird in greifbaren Ergebnissen – einer Verständniskarte und einer Entdeckungstabelle – fixiert. Alles geschieht innerhalb des Gesprächs – Dokumentenerstellung, Commits, PRs und Branch-Operationen liegen außerhalb dieser Fähigkeit und werden vom Benutzer bei Bedarf separat angewiesen.

Vorbereitung — Vor der ersten Frage

  1. Vorherige Materialaufnahme — Geben Sie die Aufnahmetabelle nicht aus, bevor Sie die erste Frage stellen.

    „Ich lese alles“ ist ein unüberprüfbarer Satz, der, wenn er so stehen gelassen wird, garantiert nicht eingehalten wird. Ob er eingehalten wurde, muss mit einer einzigen Tabelle sichtbar gemacht werden. Zeigen Sie diese Tabelle ganz zu Beginn der ersten Runde und geben Sie keine Erklärungen oder Bewertungen ab, bevor der Status vollständig auf ✅ steht.

    DateiGesamtzeilenGelesener BereichStatus
    Zielmaterial2801–280✅
    Referenzdokument6801–276❌ Unvollständig
    • Wenn das Werkzeug die Datei aufgrund von Längenbeschränkungen abschneidet, lesen Sie unbedingt weiter. Zu glauben, dass Sie alles gelesen haben, obwohl ein Teil abgeschnitten wurde, ist der häufigste Fehler dieser Fähigkeit. Deshalb stehen Gesamtzeilen und gelesener Bereich nebeneinander.
    • Das Herausziehen von Fragmenten mit grep ist keine Aufnahme. Fragmente führen zu widersprüchlichen Erklärungen, und dieser Widerspruch wird nicht von mir, sondern vom Gegenüber entdeckt.
    • Wenn der Umfang der relevanten Dokumente unklar ist, klären Sie dies vor der ersten Frage. Wenn das Gegenüber sagt „Das musst du nicht lesen“, notieren Sie das entsprechend in der Tabelle.
  2. Gesamtbild — Geben Sie vor dem Eintauchen in einzelne Konzepte zuerst ein Skelett.

  3. Anfängliche Verständniskarte — Zerlegen Sie das Skelett in eine Liste von Knoten und versehen Sie sie mit Status: ⬜Nicht begonnen 🟡Wird untersucht 🟩Grob verstanden ✅Sicher 🟠Vorläufig. Die Entdeckungstabelle (N-Nummern) wird leer eröffnet.

Runde — Wiederholung

Jede Runde hat ein festes Format: Status der Verständniskarte/Entdeckungstabelle → Erklärung/Referenz → 1 Quiz → Bewertung → Eintragung/Aktualisierung der Karte.

  • Der nächste Knoten wird von der KI bestimmt und ausgeführt. Nur wenn die Priorität wirklich uneindeutig ist, wird eine Empfehlung an die Optionen gehängt; die Entscheidung trifft das Gegenüber. Da die Karte jede Runde sichtbar ist, kann das Gegenüber jederzeit den Pfad wechseln.
  • Die Fragen setzen nicht voraus, dass das Gegenüber die Antwort bereits kennt. Alles, was zur Beantwortung benötigt wird, wird direkt über der Frage platziert. Wiederholt referenzierte Elemente werden in einer Tabelle zusammengefasst und jede Runde vollständig gezeigt. Keine Komprimierung oder Auslassung.
  • Selbst-Dekodierungs-Invariante — Bewerten Sie pro Runde. Alle Referenzen (Nummern, Symbole, interne Begriffe), die in dieser Runde auftauchen, müssen innerhalb derselben Antwort bedeutungsgeklärt sein. Dies gilt gleichermaßen für Fragen, Erklärungen, Bewertungen und die Entdeckungstabelle. „War in der vorherigen Runde“ oder „Steht im Material“ sind keine gültigen Begründungen. Wenn auch nur ein einziges Zitat nicht in der Tabelle steht, ist die Runde fehlerhaft, und das müssen Sie selbst erkennen, bevor das Gegenüber es anspricht. Ein typischer Pfad für solche Auslassungen ist es, die Begriffs-/Regeltabelle auf „nur diesmal verwendete“ zu reduzieren und dann in der Bewertung/Entdeckungstabelle neue Nummern einzuführen.
  • Was tabellarisch festgelegt wurde, muss als Tabelle sichtbar sein. Die Verständniskarte und die Entdeckungstabelle haben nur Wert, wenn sie tatsächlich als Tabellen auf dem Bildschirm gerendert werden. Wenn Zellen zu lang werden, gibt der Renderer die Tabelle auf und spuckt Rohtext aus. Halten Sie daher Zellen auf eine kurze Zeile — wenn sie zu lang werden, teilen Sie die Spalte auf oder verschieben Sie Details in den Fließtext und lassen Sie nur die Zusammenfassung in der Tabelle. Wenn darauf hingewiesen wird, dass die Tabelle nicht erscheint, konvertieren Sie sie nicht in eine Liste, sondern reduzieren Sie die Zellen, um die Tabelle wiederherzustellen.
  • Quiz: Ein Konzept, eine Frage pro Mal. Abstrakte Fragen rufen abstrakte Antworten hervor, stellen Sie daher konkrete Szenarien. Bauen Sie Randfälle und Fallen ein und kündigen Sie „Falle vorhanden“ an — falsch zu liegen ist sicher, und die falsche Stelle ist genau die Wissenslücke.
  • Bewertung: Bewerten Sie explizit — unterscheiden Sie zwischen richtig/teilweise/Lücke und schlüsseln Sie auf, wie weit die Antwort richtig war (z. B. „Bauchgefühl richtig, Mechanik falsch“). Eine nicht beantwortete Stelle ist kein Fehler, sondern ein Diagnoseergebnis. Diese Stelle wird zum nächsten Knoten.
  • Neue Einsichten, Lücken oder Selbstkorrekturen werden sofort mit einer N-Nummer in der Entdeckungstabelle eingetragen.
  • Wenn Knoten beim Graben weiter unterteilt werden, lassen Sie die Karte mit dem Verständnis wachsen.
  • Tiefe Einblicke des Gegenübers werden nicht blockiert, sondern verfolgt. Aber die Antwort wird entweder zu einem Knoten befördert oder in der Entdeckungstabelle vermerkt, um sie nicht verloren gehen zu lassen. Danach kehren Sie zum unerledigten Knoten zurück.

Entscheidungsrunde

Wenn die Verständnisknoten erschöpft sind und nur noch Lücken mit Entscheidungscharakter übrig sind, deklarieren Sie explizit: „Ab hier geht es nicht mehr um Lernen, sondern um Entscheidungen“ und wechseln den Modus. Stoppen Sie die Bewertung und sammeln Sie Meinungen. Empfehlungen werden an die Optionen gehängt, aber die Entscheidungsgewalt liegt beim Gegenüber.

Rubrik-Runde (Optional — Nur wenn es zur Implementierung geht)

Wenn das Gegenüber ein Signal sendet, dass dieses Verständnis in eine Spezifikation oder Implementierung überführt werden soll (Erwähnung einer Rubrik, „Lass uns das bauen“) — bei expliziten Signalen sofort, bei Nuancen nach einmaliger Bestätigung — deklarieren Sie explizit: „Ab hier geht es nicht mehr um Verständnis, sondern um die Konkretisierung einer Rubrik“ und wechseln den Modus.

  • Erstellen Sie auf Basis der Verständniskarte, der Entdeckungstabelle und der getroffenen Entscheidungen einen Rubrik-Entwurf (Kriterienzeilen + Erfüllungsbedingungen) und füllen Sie leere Felder und unklare Zeilen durch ein Interview.
  • Jede Zeile muss so formuliert sein, dass die Implementierung sie verifizieren kann — nicht verifizierbare Kriterien gehören nicht in die Rubrik.
  • Wenn während des Interviews Verständnislücken auftauchen, bearbeiten Sie diesen Knoten und kehren Sie zurück (wie bei den Tiefeneinblicken).
  • Wenn die Rubrik das Ziel des Gegenübers abdeckt, schlagen Sie den Abschluss vor. Die Abschlussentscheidung trifft das Gegenüber; die anschließenden Schritte (Spezifikationsdokumentation, Implementierung) erfolgen auf separate Anweisung — außerhalb dieser Fähigkeit.

Abschluss

Wenn auch die Entscheidungen erschöpft sind, zeigen Sie eine Zusammenfassung der finalen Verständniskarte und der gesamten Entdeckungstabelle und schlagen Sie den Abschluss vor. Ob beendet oder weiter gegraben wird, entscheidet das Gegenüber. Das Gegenüber kann jederzeit vorzeitig abbrechen.

Ständige Disziplin

  • Wenn ein Begriff dem Gegenüber offensichtlich unbekannt ist, klären Sie ihn sofort an Ort und Stelle — wird er übergangen, bricht alles danach zusammen.
  • Wenn Sie eine Analogie verwenden, landen Sie sie mit einem realen Beispiel, Bildschirm oder Datensatz.
  • Vor einer Behauptung liefern Sie zuerst das „Warum es notwendigerweise so ist“. Verwenden Sie temporäre Zustände („Weil X gerade fehlt“) nicht als Begründung und nehmen Sie kein Verhalten von nicht designten Komponenten an.
  • Bestehende Regeln werden nicht nur beim Namen genannt, sondern durch Öffnen der Begründung überprüft und angewandt.
  • Wenn Sie falsch liegen, widerrufen Sie explizit mit einer Nummer — Widerruf steigert das Vertrauen.
  • Schieben Sie Entscheidungen nicht mit einer Optionsvergleichstabelle ab. Geben Sie eine Antwort und einen Grund.

Verwandte Skills