Communitygithub.com

robcsaszar/socratic

Eine sieben Fragen umfassende Retrospective nach dem Ausliefern für Claude Code, aufgebaut um Vertrauen, blinde Flecken und Verfall.

Was ist socratic?

Das Socratic-Skill ist ein spezialisiertes Tool für Claude Code, das nach dem Versand einer Änderung eine strukturierte, sokratische Befragung durchführt. Es ist kein Code-Review, sondern eine tiefgehende Untersuchung der eigenen Arbeit, die sich auf die Bereiche Selbstvertrauen, blinde Flecken und zukünftigen Verfall konzentriert. Das Skill unterstützt Features, Änderungssätze (Pull Requests, Branches, Commits) oder das gesamte Repository und arbeitet in einer streng definierten Abfolge: Zuerst wird das Ziel benannt, dann werden parallele „Explore“-Subagenten gestartet, die auf den tatsächlichen Änderungen basieren (z. B. `gh pr diff`), und schließlich werden sieben spezifische Fragen in einer festgelegten Reihenfolge beantwortet. Die Antworten müssen durch Datei-, Zeilen- oder Commit-Zitate belegt sein; das Erfinden von Antworten ist verboten. Abschließend werden bis zu drei konkrete Folgemaßnahmen sowie die Frage genannt, die am meisten „gebrannt“ hat. Das Skill zwingt den Entwickler, sowohl als Bauherr als auch als Skeptiker zu antworten, und vermeidet ausweichende Antworten wie „es kommt darauf an“.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add robcsaszar/socratic

In Ihrer bevorzugten KI fragen

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

Dokumentation

Sokratisch

Zētein — suchen. Kein Code-Review: eine Untersuchung, die nach der Auslieferung stattfindet. Antworte sowohl als Bauherr als auch als Skeptiker; eine Antwort, die schmeichelt, ist wertlos.

Methode

  1. Nenne das Ziel. Das Argument benennt es — ein Feature („Emotes“), einen Änderungssatz („PR #754“, einen Branch, einen Commit-Bereich) oder das gesamte Repository. Kein Argument — nimm den letzten gemergten PR. Wenn das Ziel nicht aufgelöst werden kann (kein Treffer, keine gemergten PRs), stoppe und frage. Gib es in einer Zeile an, bevor irgendetwas anderes passiert.
  2. Entsende die Sucher. Starte parallele Explore-Subagenten — immer mehrere, einen pro Bereich — und antworte erst, wenn alle zurück sind. Feature oder Änderungssatz: Implementierung, Tests, Docs/Flows — verankert im Diff (gh pr diff <n> für PRs, git diff <Bereich> für Bereiche). Repository: Architektur, Schnittstellen zwischen Modulen, Abweichung zwischen Code und Docs. Jeder Sucher gibt Ergebnisse mit Datei:Zeilen-Zitaten zurück; Antworten stützen sich nur auf das, was die Sucher zurückgeben, plus die Sitzung selbst.
  3. Stelle die sieben Fragen, der Reihe nach. Eine nach der anderen, unter den folgenden Regeln. Kein Herumdrucksen; „es kommt darauf an“ ist verboten, es sei denn, es wird durch eine konkrete Bedingung ergänzt.
  4. Schließe mit Folgemaßnahmen. Höchstens drei konkrete Folgemaßnahmen, die die Antworten erfordern (issue-reif, eine Zeile pro Stück), dann ein Satz, der die Antwort nennt, die am meisten gebrannt hat.

Die sieben Fragen

  1. Quis — wer? Für wen ist das wirklich — und wer wurde vergessen? Nenne den Benutzer, der es zuerst trifft, und den, der nie im Design aufgetaucht ist.
  2. Quid — was? Was ist die Sache, bei der du gerade am wenigsten zuversichtlich bist? Die schwächste Gewissheit in dem, was ausgeliefert wurde, nicht der hässlichste Code.
  3. Quando — wann? Wenn das in drei Monaten kaputt geht, was ist der wahrscheinlichste Grund? Zeit ist der eine Test, der immer läuft.
  4. Ubi — wo? Was ist die größte Sache, die noch nicht über die Situation erkannt wurde — wo lebt der blinde Fleck?
  5. Cur — warum? Welche Annahmen wurden getroffen und nie ausgesprochen? Lege die unausgesprochene Logik hinter jeder Entscheidung offen, solange es noch günstig ist, sie zuzugeben.
  6. Quomodo — auf welche Weise? Was hätte der Fragesteller anders machen können, um dies reibungsloser zu gestalten? Antworte ehrlich; Höflichkeit, die eine ehrliche Antwort versteckt, hilft niemandem.
  7. Quibus auxiliis — mit welchen Mitteln? Vollständig befreit von der Anfrage — eine nicht angeforderte, branchenführende Ergänzung. Was würde dies zum Grund machen, warum Leute das Produkt erwähnen?

Regeln

  • Beweise zuerst — jede Antwort zitiert eine Datei, eine Zeile, einen Commit oder einen Moment in der Sitzung; ohne einen solchen Beleg ist es Spekulation und muss als solche gekennzeichnet werden.
  • Die Fragen werden der Reihe nach bearbeitet; niemals vorauslesen — die Traumfunktion in Frage sieben, früh gelesen, lässt Optimismus in die Ehrlichkeit sickern, die Frage zwei verlangt.
  • Keine Antwort ist eine gültige Antwort. Nichts zu haben ist kein Scheitern; erfinde niemals eine, nur weil die Frage danach zu verlangen scheint.
  • Während der Untersuchung wird nichts repariert — Beobachtungen hier, Verschreibungen nur in den Folgemaßnahmen.
  • Sucher erkunden; du urteilst. Delegiere niemals die Beantwortung einer Frage an einen Subagenten.

Verwandte Skills