Communitygithub.com

Xavier189/dig-skill

Dig (探骊) — Sokratische Anforderungsexkavation für Codierungsagenten: hypothesieren, fragen was zählt, schleifen bis sauber, Klarheitsvermerk bestätigen lassen bevor die Arbeit beginnt. Claude Code first-class, kompatibel mit Agent Skills.

Was ist dig-skill?

Dig (探骊) ist eine strukturierte, sokratische Methode zur Anforderungsexkavation, die speziell für KI-Codierungsagenten wie Claude Code, Cursor, Codex oder andere Agent Skills Plattformen entwickelt wurde. Ihr Kernziel ist es, Missverständnisse und Fehlimplementierungen zu vermeiden, indem sie den Benutzer systematisch dazu bringt, seine tatsächlichen Anforderungen, versteckten Absichten, unausgesprochenen Randbedingungen und Entscheidungen, die stillschweigend delegiert werden, zu offenbaren, bevor mit der Implementierung begonnen wird. Der Prozess besteht aus fünf Schritten: Kontext absorbieren, Hypothesen bilden (mit Überprüfung aus sechs Blickwinkeln), Fragen in Batches stellen (maximal 4 pro Runde), die Antworten in einer Schleife verarbeiten, bis Konvergenz erreicht ist, das Ergebnis in einem Klarheitsvermerk mit fünf Abschnitten (Ziel, Entscheidungen, Grenzen, Erfolgskriterien, offene Punkte) synthetisieren und abschließend langlebige Informationen im Gedächtnis des Agenten oder in globalen Konfigurationsdateien speichern. Die Methode betont Tiefe statt Oberflächlichkeit: Sie zwingt den Agenten, bei jeder Frage sicherzustellen, dass unterschiedliche Antworten zu unterschiedlichen Handlungsweisen führen, und sie lehnt es ab, Lösungen, die als Anforderungen getarnt sind, einfach zu akzeptieren. Dadurch ist das Skill besonders geeignet für komplexe Aufgaben mit vielen versteckten Fallstricken, bei denen eine frühzeitige Klärung große Zeit- und Qualitätsverluste verhindert.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add Xavier189/dig-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

Dig — Sokratische Anforderungsexkavation

Hole an die Oberfläche, was der Benutzer wirklich will, bevor mit der Arbeit begonnen wird. Die formulierte Anfrage ist ein erster Anhaltspunkt, nicht die Anforderung. Versteckte Absichten, unausgesprochene Randbedingungen und Entscheidungen, die stillschweigend an Sie delegiert werden, sind die Stellen, an denen die gelieferte Arbeit schiefgeht.

Passen Sie sich der Sprache des Benutzers an; bewahren Sie technische Begriffe in ihrer ursprünglichen Form.

Die Messlatte, die jede Frage überspringen muss

Fragen Sie nur das, was ändern würde, was Sie bauen. Bevor Sie etwas fragen, nennen Sie zwei realistische Antworten, die zu unterschiedlichen Ansätzen führen würden; wenn jede wahrscheinliche Antwort zur gleichen Aktion führt, wissen Sie bereits genug – fragen Sie nicht. Diese Messlatte hat Vorrang vor jedem Schritt unten: Ein Schritt, der ohne sie ausgeführt wird, ist Theater.

Prozess

0. KONTEXT – absorbieren vor dem Hypothesenbilden

Lesen Sie, was relevant ist: Dateien, die die Aufgabe berührt, Projektdokumente und – falls Ihre Plattform dauerhaften Speicher hat – gespeicherte langfristige Ziele und wiederkehrende Präferenzen. Suchen Sie nach dem größeren Bild des Benutzers – ein Liefergegenstand, der technisch korrekt, aber nicht auf die langfristigen Pläne des Benutzers abgestimmt ist, ist immer noch ein Fehlschlag.

1. HYPOTHESE AUFSTELLEN – sich auf eine Interpretation festlegen, die der Benutzer angreifen kann

Stellen Sie, bevor Sie etwas fragen, eine Arbeitshypothese in drei Teilen vor. Schreiben Sie jeden Teil so, dass der Benutzer auf eine Zeile zeigen und sagen kann „nein – das ist falsch". Selbsttest: Wenn ein Satz unverändert in der Hypothese einer anderen Aufgabe überleben würde, ist er Füllstoff – löschen Sie ihn.

  1. Was Sie eigentlich wollen – das Ergebnis hinter der formulierten Anfrage, in ein oder zwei Sätzen. Wenn die Anfrage eine Lösung ist („einen Redis-Cache hinzufügen"), nennen Sie das Problem, von dem Sie glauben, dass es gelöst werden soll („die Listenseite ist zur Spitzenzeit langsam") – die Lücke zwischen diesen beiden ist es, wo sich Digs auszahlen.
  2. Wo das schiefgehen könnte – die ein oder zwei Stellen, an denen DIESE Aufgabe am wahrscheinlichsten fehlschlägt oder falsch verstanden wird: eine benannte Falle („paginiert gefilterte Listen sind der schlechteste Fall für Caching – Key-Explosion, niedrige Trefferquote"), niemals ein allgemeines Risiko („der Umfang könnte sich ausdehnen").
  3. Wenn ich jetzt gezwungen wäre zu beginnen, würde ich… – eine konkrete Skizze, eine Entscheidung pro Zeile, jede Zeile markiert mit:
    • ✅ explizit – der Benutzer hat es bereits gesagt
    • 🔍 delegiert – Sie würden standardmäßig X tun, aber der Benutzer sollte es ratifizieren (Technologiewahl, Struktur, Abwägungen, alles schwer Umkehrbare); empfehlen, niemals stillschweigend entscheiden
    • ❓ mehrdeutig – Sie können nicht einmal eine Standardeinstellung wählen

Halten Sie die gesamte Hypothese unter ~15 Zeilen – sie muss auf einen Blick korrigierbar sein. Die Skizze ist Köder: Ein konkreter Plan zieht Korrekturen an, die eine abstrakte Liste von Unbekannten niemals hervorrufen würde.

Bevor Sie sie zeigen, testen Sie sie aus sechs Blickwinkeln: echtes Ziel (ist die Aufforderung ein Mittel zu etwas Ungesagtem?), Umfang (was nimmt der Benutzer als in- oder out-of-scope an, was Sie nicht tun?), Erfolgskriterien (wären Sie sich beide einig, dass es funktioniert hat?), Fehler (was bricht zuerst, und wer merkt es?), Abhängigkeiten und Randbedingungen (was muss existieren oder darf sich nicht ändern?), langfristige Passung (kämpft die Skizze gegen das größere Bild des Benutzers?). Dies sind Angriffswinkel, keine auszufüllenden Abschnitte – schreiben Sie niemals eine Zeile pro Winkel. Die meisten Winkel werden nicht beißen; die zwei oder drei, die Teil 1 umwerfen oder Teil 3 umleiten könnten, sind genau die Stellen, aus denen Ihre Fragen kommen.

Wenn der Stresstest mehr als ~8 ungelöste Verzweigungen hinterlässt, ist die Aufgabe zu groß für ein einziges Dig – schlagen Sie vor, sie in Unteraufgaben aufzuteilen, anstatt zu verhören.

2. FRAGEN – gebündelte Fragen, die aus den schwächsten Punkten erwachsen

Präsentieren Sie die Hypothese und fragen Sie dann – über AskUserQuestion in Claude Code oder als nummerierte Liste in einer einzigen Nachricht auf Plattformen ohne strukturiertes Fragewerkzeug: bis zu 4 Fragen pro Stapel, geordnet nach Auswirkung, jede mit konkreten Optionen und einer Empfehlung. Geben Sie niemals eine Frage pro Zug tröpfchenweise. Fragen Sie alles, von dem Sie bereits wissen, dass es offen ist – die unten stehende Schleife existiert für Fragen, die aus Antworten entstehen, nicht für das Rationieren von bekannten.

Jede Frage muss:

  • benennen, was sie testet – welchen Teil der Hypothese, welche 🔍/❓ Verzweigung. Eine Frage, die Sie nicht mit der Hypothese verbinden können (einschließlich Füllfragen wie „gibt es noch etwas, das ich wissen sollte?"), ist ein Checklistenreflex: streichen Sie sie.
  • die obige Messlatte überspringen – eine realistische Antwort muss den Ansatz ändern.
  • Lösungen ablehnen, die als Anforderungen getarnt sind – führen Sie „Cache hinzufügen" auf die Langsamkeit zurück, die es beheben soll, bevor Sie den Cache entwerfen.

Wenn der Stresstest keine 🔍 oder ❓ übrig lässt, sagen Sie das und gehen Sie direkt zum Vermerk – ein Dig mit null Fragen ist ein legitimes Ergebnis, kein Versäumnis.

Kalibrieren Sie jeden Stapel anhand von Oberflächlich vs. Tiefgehend am Ende dieser Datei.

3. SCHLEIFE – graben, bis Antworten die Hypothese nicht mehr bewegen

Jede Antwort kann eine Verzweigung offenlegen, die vor ihr unsichtbar war. Eine Schleife von Stapeln ist kein Tröpfeln: Eine neue Runde ist nur durch neue Informationen aus der letzten Runde gerechtfertigt. Nach jedem Stapel:

  1. Aktualisieren Sie die Hypothese laut, nur das Delta – „Ihre Antwort zu X ändert die Skizze: …". Wiederholen Sie niemals, was sich nicht bewegt hat.
  2. Zulassungstor für Folgefragen – eine neue Frage verdient ihren Platz nur, wenn sie in sich selbst (a) angibt, welche Antwort sie geöffnet hat – zitieren oder paraphrasieren Sie die Worte des Benutzers genau – und (b) welche Verzweigung sie entscheidet. Form: "Sie sagten, Schreibvorgänge müssen sofort sichtbar sein – das schließt einfaches TTL aus, also: bei Schreibzugriff ungültig machen oder Caching für diese Abfrage ganz lassen?" Wenn Sie beide Slots nicht füllen können, führen Sie eine Checkliste erneut aus, keinem roten Faden folgen: Lassen Sie es weg.
  3. Konvergieren Sie, wenn die Antworten einer Runde keine zulässigen Folgefragen eröffnen und jede 🔍/❓ aufgelöst oder explizit aufgeschoben ist. Sagen Sie, dass Sie konvergiert sind, und gehen Sie zum Vermerk – polieren Sie niemals eine letzte Runde auf, um gründlich zu wirken. Es gibt keine Rundenzahl-Obergrenze und kein Rundenzahl-Kontingent: Eine Runde reicht oft; das Tor entscheidet, nicht der Ehrgeiz.
  4. Zu groß? Wenn zwei aufeinanderfolgende Runden jeweils so viele neue Verzweigungen öffnen, wie sie schließen, hören Sie auf zu verhören – die Anfrage ist eine Aufgabe in mehreren Aufgaben, die einen Satz trägt. Schlagen Sie eine Aufteilung vor und graben Sie nur die erste Unteraufgabe.
  5. Notausstieg – wenn der Benutzer „开工", „start", „leg los" oder gleichwertig sagt, fragen Sie sofort nicht weiter: Falten Sie jedes ungelöste Element in die Offenen Punkte des Vermerks mit der Standardeinstellung, die Sie anwenden werden, und legen Sie den Vermerk zur üblichen Bestätigung vor.

4. SYNTHESE – der Klarheitsvermerk

Legen Sie einen Vermerk vor, den der Benutzer in ~10 Sekunden überprüfen kann, genau fünf Abschnitte:

  1. Ziel(真实目标) – das tatsächliche Ziel, ein oder zwei Sätze
  2. Entscheidungen(已拍板) – jede bestätigte Entscheidung, eine Zeile pro Entscheidung
  3. Grenzen(明确不做) – explizite Ausschlüsse
  4. Erfolgskriterien(成功标准)
  5. Offene Punkte(开放项) – aufgeschobene Fragen, Risiken, verbleibende Annahmen

Holen Sie eine explizite Bestätigung ein. Dann übergeben Sie: in den Planmodus für große Bauten oder direkt zur Implementierung für überschaubare Arbeiten. Der Vermerk ist die nachgelagerte Eingabe.

5. SICHERN – bewahren, was die Aufgabe überdauert

  • Nur langlebige Informationen: aufgabenübergreifende Ziele (z.B. ein laufendes Nebenprojekt, das diese Aufgabe bedient), wiederkehrende Präferenzen, Domänenhintergrund. Nichts Aufgabenspezifisches.
  • Höchstens 1-2 Speicherschreibvorgänge pro Dig; überprüfen Sie zuerst bestehende Speicher und bevorzugen Sie Aktualisierungen gegenüber Neuerstellungen. Kein dauerhafter Speicher auf Ihrer Plattform? Lassen Sie die Schreibvorgänge weg.
  • Eindeutig projektübergreifende Fakten: Schlagen Sie dem Benutzer vor, sie in die globale Anweisungsdatei (CLAUDE.md, AGENTS.md oder das Äquivalent Ihrer Plattform) aufzunehmen – bearbeiten Sie keine globale Konfiguration selbst.
  • Vermerk-Speicherung ist STANDARDMÄSSIG AUS. Wenn der Benutzer um Speicherung bittet (oder eine Harness-Integration sie anfordert), schreiben Sie nach docs/clarity/YYYY-MM-DD-<slug>.md mit Frontmatter task/date/status und den fünf Vermerksabschnitten als festen Überschriften – diese Struktur ist der maschinenlesbare Vertrag.

Oberflächlich vs. tiefgehend – hier kalibrieren

Benutzeranfrage: "Unsere Benutzerlistenseite benötigt zur Spitzenzeit 3-4 Sekunden. Fügen Sie einen Redis-Cache dafür hinzu – geben Sie mir einen Implementierungsplan."

Oberflächlich – jedes sieht professionell aus; keines ändert, ob Caching überhaupt der richtige Schritt ist:

  • „Redis oder Caffeine?"
  • „Welches TTL – 5 Minuten oder 30?"
  • „Die gesamte Seitenantwort cachen oder die Einträge pro Benutzer?"

Diese wählen Parameter auf einem ungeprüften Plan aus; sie akzeptieren die getarnte Lösung als Anforderung.

Tiefgehend – jedes benennt die Verzweigung, die es entscheidet:

  • „Ist die Seite nur zur Spitzenzeit langsam oder immer?" – immer-langsam deutet auf die Abfrage selbst hin, wo ein Index sie direkt beheben könnte; nur-spitze deutet auf Pool/Parallelität, wo Cache kaum hilft. Entscheidet, ob Redis überhaupt das richtige Projekt ist.
  • „Nachdem jemand einen Benutzer bearbeitet hat, wie veraltet darf die Liste sein?" – „muss sofort frisch sein" macht Ungültigmachung zum eigentlichen Projekt und die Abfrageoptimierung wahrscheinlich billiger; „Minuten sind in Ordnung" macht einfaches TTL verwendbar. Entscheidet die Form – oder die Existenz – des Cache-Designs.
  • „Hat jemand gemessen, wo die 3-4 Sekunden hingehen?" – falls nicht, beginnt die Skizze mit EXPLAIN und Pool-Metriken, nicht mit Redis; ein 30-Minuten-Index schlägt eine dauerhafte Konsistenzsteuer. Entscheidet Schritt 1 der Arbeit.

Ein legitimes Round-2-Folgefrage, in der zulässigen Form:

  • „Sie sagten, es ist nur zur Spitzenzeit langsam und der Verbindungspool ist ausgelastet – das verschiebt die Diagnose von ‚langsame Abfrage' zu ‚Verbindungsverhungerung', also: den Pool erhöhen oder zuerst finden, was die Verbindungen blockiert?"

Kopieren Sie die Bewegungen, niemals den Inhalt. Die tiefgehenden Moves sind: die Absicht zurückverfolgen, die Konsequenz bepreisen, die eigene Skizze angreifen. Verwenden Sie diese wörtlichen Fragen niemals wieder für eine Aufgabe, die nicht diese Aufgabe ist.

Verwandte Skills