Ask Matt
Sie erinnern sich nicht an jeden Skill – also fragen Sie.
Ein Ablauf ist ein Pfad durch die Skills. Die meisten Pfade verlaufen entlang eines Hauptablaufs, und zwei Auffahrrampen münden in ihn ein. Alles andere ist eigenständig oder eine Vokabularschicht, die darunter liegt.
Der Hauptablauf: Idee → Auslieferung
Die Route, die die meiste Arbeit nimmt. Sie haben eine Idee und möchten sie umgesetzt haben.
-
/grill-with-docs– die Idee durch ein Interview schärfen. Starten Sie hier, wenn Sie eine Codebasis haben: es ist zustandsbehaftet und behält das Gelernte inCONTEXT.mdund ADRs. (Keine Codebasis? Verwenden Sie/grill-me– siehe Eigenständig. Beide nutzen dasselbe/grilling-Primitiv;grill-with-docsist dasjenige, das eine Papierspur hinterlässt.) -
Verzweigung – können Sie jede Frage im Gespräch klären? Wenn eine Frage eine ausführbare Antwort erfordert (Zustand, Geschäftslogik, eine UI, die Sie sehen müssen), machen Sie einen Umweg über einen Prototyp, überbrückt durch
/handoffin beide Richtungen (siehe Sitzungswechsel):/handoffraus, dann eine neue Sitzung für diese Datei öffnen,/prototypeum die Frage mit Wegwerfcode zu beantworten,/handoffzurück, was Sie gelernt haben, und darauf im ursprünglichen Ideen-Thread verweisen.
-
Verzweigung – Ist das ein Multi-Sitzungs-Build?
- Ja →
/to-prd** (den Thread in ein PRD verwandeln) → **/to-issues** (das PRD in unabhängig greifbare Issues aufteilen). Da die Issues unabhängig sind, **Kontext zwischen jedem klar trennen**: eine neue Sitzung pro Issue starten und **/implement` starten, indem Sie ihm das PRD und das einzelne Issue zum Bearbeiten übergeben. - Nein →
/implementdirekt hier, im selben Kontextfenster.
In beiden Fällen baut
/implementjedes Issue, indem es intern/tddantreibt – jeweils einen Rot-Grün-Slice nach dem anderen – und schließt ab, indem es/code-reviewausführt, eine zweiachsige Überprüfung (Standards + Spezifikation) des Diffs, bevor es committet. Greifen Sie zu/tddallein, wenn Sie einfach ein konkretes Verhalten test-first ohne vollständige Spezifikation bauen möchten, und/code-reviewallein, wenn Sie einen Branch oder PR gegen einen fixen Punkt überprüfen möchten. - Ja →
Kontexthygiene
Halten Sie Schritte 1–3 in einem ununterbrochenen Kontextfenster – komprimieren oder löschen Sie erst nach /to-issues – damit das Grilling, PRD und Issues alle auf demselben Denken aufbauen. Jedes /implement startet dann frisch und arbeitet vom Issue aus.
Die Grenze dafür ist die smart zone: das Fenster (~120k Tokens bei modernen Modellen), in dem das Modell noch klar denkt. Wenn eine Sitzung sich dieser Grenze vor /to-issues nähert, machen Sie nicht mit verschlechterter Qualität weiter – /handoff und in einem neuen Thread fortsetzen.
Auffahrrampen
Eine Startsituation, die Arbeit generiert und dann in den Hauptablauf mündet.
-
Bugs und Anfragen häufen sich →
/triage. Es bewegt Issues durch Triage-Rollen und erzeugt agentenfertige Issues, die/implementspäter aufnimmt.Triage ist nur für Issues, die Sie nicht erstellt haben – Fehlermeldungen, eingehende Feature-Anfragen, alles, was roh ankommt. Issues, die
/to-issueserzeugt hat, sind bereits agentenfertig, also triage Sie sie nicht. -
Etwas ist kaputt →
/diagnosing-bugs. Für die harten Fälle: der Bug, der einem ersten Blick widersteht, der intermittierende Flake, die Regression, die zwischen zwei bekannten guten Zuständen eingeschlichen ist. Es weigert sich zu theoretisieren, bis es eine enge Rückkopplungsschleife hat – ein Befehl, der bereits auf diesen Bug rot geht – und behebt ihn dann mit einem Regressionstest. Seine Nachbesprechung reicht an/improve-codebase-architectureweiter, wenn die eigentliche Erkenntnis ist, dass es keine gute Nahtstelle gibt, um den Bug festzunageln.
Codebase-Gesundheit
Keine Feature-Arbeit – Instandhaltung.
/improve-codebase-architecture– führen Sie es aus, wann immer Sie einen freien Moment haben, um die Codebasis für Agenten nutzbar zu halten. Es zeigt Vertiefungsmöglichkeiten auf; wenn Sie eine auswählen, wird eine Idee generiert, die Sie in den Hauptablauf bei/grill-with-docsmitnehmen können. Es ist die Übersicht, die die Kandidaten findet;/codebase-design(unten) ist die Werkbank, auf der Sie den Ausgewählten entwerfen.
Vokabular darunter
Zwei modellaufgerufene Referenzen, die unterhalb der anderen Skills laufen – jede die einzige Quelle der Wahrheit für ihr Vokabular. Greifen Sie direkt darauf zu, wenn die Wörter, nicht der Prozess, das Problem sind; oder lassen Sie die obigen Skills sie einziehen.
/domain-modeling– schärft die Domänensprache des Projekts: einen unscharfen Begriff hinterfragen, ein überladenes Wort auflösen („Konto“ mit drei Aufgaben), eine schwer umkehrbare Entscheidung als ADR festhalten. Es ist die aktive Disziplin, die/grill-with-docsantreibt, umCONTEXT.mdals sauberes Glossar zu erhalten./codebase-design– das Tiefenmodul-Vokabular (Modul, Schnittstelle, Tiefe, Nahtstelle, Adapter, Hebelwirkung, Lokalität) zum Entwerfen der Form eines Moduls: viel Verhalten hinter einer kleinen Schnittstelle an einer sauberen Nahtstelle./tddund/improve-codebase-architecturesprechen beide dieses Vokabular.
Sitzungswechsel
/handoff– wenn ein Thread voll ist oder Sie abzweigen müssen (z.B. in eine/prototype-Sitzung), komprimiert dies die Konversation in eine Markdown-Datei. Sie machen nicht an Ort und Stelle weiter – Sie öffnen eine neue Sitzung und referenzieren diese Datei, um den Kontext zu übertragen. Es ist die Brücke zwischen Kontextfenstern in beide Richtungen. Verwenden Sie es, wenn Sie eine frische Sitzung wünschen, aber die aktuelle Konversation erhalten müssen./compact(eingebaut) – bleiben Sie in der gleichen Konversation und lassen Sie die früheren Wendungen zusammenfassen. Verwenden Sie es an bewussten Pausen zwischen Phasen, wenn es Ihnen nichts ausmacht, die wörtliche Historie zu verlieren. Komprimieren Sie nicht mitten in einer Phase – der Agent kann die Orientierung verlieren./handoffverzweigt;/compactsetzt fort.
Eigenständig
Vollständig außerhalb des Hauptablaufs.
/grill-me– das gleiche unerbittliche Interview wie/grill-with-docs, aber für den Fall, dass Sie keine Codebasis haben. Zustandslos: es speichert nichts lokal, erstellt keineCONTEXT.md. Greifen Sie darauf zu, um jeden Plan oder Entwurf zu schärfen, der nicht in einem Repository lebt./prototype– ein kleines Wegwerfprogramm, das eine Entwurfsfrage beantwortet: fühlt sich dieses Zustandsmodell richtig an oder wie sollte diese UI aussehen. Von Anfang an Wegwerf – behalten Sie die Antwort, löschen Sie den Code. Es ist der Umweg in Schritt 2 des Hauptablaufs, aber greifen Sie jederzeit darauf zu, wenn eine Entwurfsfrage auf dem Papier schwer zu klären ist./research– delegieren Sie Lesearbeit an einen Hintergrundagenten: er untersucht eine Frage anhand von Primärquellen und hinterlässt dann eine zitierte Markdown-Datei im Repository. Arbeiten Sie weiter, während er liest. Die Datei, die er erzeugt, wird in den Hauptablauf bei/grill-with-docseingebracht – Recherche befruchtet das Denken, ersetzt es nicht./teach– lernen Sie ein Konzept über mehrere Sitzungen hinweg, wobei das aktuelle Verzeichnis als zustandsbehafteter Arbeitsbereich dient./writing-great-skills– Referenz zum guten Schreiben und Bearbeiten von Skills.
Vorbedingung
/setup-matt-pocock-skills – führen Sie es vor Ihrem ersten Engineering-Ablauf aus, um den Issue-Tracker, Triage-Labels und das Dokumentenlayout zu konfigurieren, das die anderen Skills erwarten. Benutzerdefinierte Issue-Tracker funktionieren ebenfalls.