AgentSkillsCN

clarify

在正式开工前,先提出澄清性问题。您可以输入“/clarify”、“先问我”或“反向提示”,让一切准备就绪。

SKILL.md
--- frontmatter
name: clarify
description: "Stellt klärende Fragen bevor Arbeit beginnt. Run '/clarify', 'frag mich erst', oder 'reverse prompt'."

Clarify Skill (Reverse Prompting)

Stellt gezielte klärende Fragen bevor mit der eigentlichen Arbeit begonnen wird. Basiert auf Anthropic's "Reverse Prompting" Best Practice.

Wann ausfuehren

  • Vor komplexen oder mehrdeutigen Aufgaben
  • Wenn User sagt "frag mich erst", "clarify", oder "/clarify"
  • Bei Aufgaben mit vielen moeglichen Interpretationen
  • Wenn der Scope unklar ist

Workflow

1. Aufgabenbeschreibung analysieren

Lies die Aufgabenbeschreibung des Users aufmerksam und identifiziere:

  • Was ist explizit gesagt?
  • Was ist implizit angenommen?
  • Welche Luecken gibt es?

2. Genau 5 klärende Fragen stellen

Verwende das AskUserQuestion Tool um alle 5 Fragen auf einmal zu stellen:

Frage 1: Kontext/Hintergrund

  • Warum wird diese Aufgabe benoetigt?
  • Was ist der groessere Zusammenhang?
  • Gibt es Vorgaben oder Einschraenkungen?

Frage 2: Gewuenschtes Ergebnis

  • Wie soll das Endergebnis konkret aussehen?
  • Welches Format/Output wird erwartet?
  • Gibt es Beispiele oder Referenzen?

Frage 3: Einschraenkungen/Constraints

  • Welche Technologien muessen/duerfen verwendet werden?
  • Gibt es zeitliche Einschraenkungen?
  • Budget oder Ressourcenlimits?

Frage 4: Prioritaeten

  • Was ist am wichtigsten?
  • Was kann weggelassen werden wenn noetig?
  • Qualitaet vs. Geschwindigkeit?

Frage 5: Erfolgskriterien

  • Woran erkennen wir, dass die Aufgabe erfolgreich ist?
  • Wer nimmt das Ergebnis ab?
  • Gibt es Tests oder Validierung?

3. AskUserQuestion Aufruf

code
Verwende AskUserQuestion mit 4 Fragen (Maximum des Tools).
Die 5. Frage stelle als Freitext-Option bei einer der Fragen.

Beispiel-Struktur:

json
{
  "questions": [
    {
      "question": "Was ist der Kontext/Hintergrund dieser Aufgabe?",
      "header": "Kontext",
      "options": [
        { "label": "Neues Feature", "description": "Funktionalitaet die es noch nicht gibt" },
        { "label": "Bug Fix", "description": "Bestehendes Problem beheben" },
        { "label": "Refactoring", "description": "Code verbessern ohne Funktionsaenderung" },
        { "label": "Optimierung", "description": "Performance oder UX verbessern" }
      ],
      "multiSelect": false
    },
    {
      "question": "Was ist am wichtigsten bei dieser Aufgabe?",
      "header": "Prioritaet",
      "options": [
        { "label": "Funktionalitaet", "description": "Es muss funktionieren, Rest ist zweitrangig" },
        { "label": "Code-Qualitaet", "description": "Sauber, wartbar, gut dokumentiert" },
        { "label": "Performance", "description": "Schnell und effizient" },
        { "label": "UX/Design", "description": "Nutzerfreundlich und ansprechend" }
      ],
      "multiSelect": true
    },
    {
      "question": "Welche Einschraenkungen gibt es?",
      "header": "Constraints",
      "options": [
        { "label": "Bestehende Architektur", "description": "Muss in vorhandene Struktur passen" },
        { "label": "Keine neuen Dependencies", "description": "Nur vorhandene Packages nutzen" },
        { "label": "Rueckwaertskompatibel", "description": "Darf nichts Bestehendes brechen" },
        { "label": "Keine Einschraenkungen", "description": "Freie Wahl der Implementierung" }
      ],
      "multiSelect": true
    },
    {
      "question": "Wie sieht Erfolg aus? (Erfolgskriterien + gewuenschtes Ergebnis)",
      "header": "Erfolg",
      "options": [
        { "label": "Funktionierende Demo", "description": "Zeigbare, laufende Loesung" },
        { "label": "Tests bestehen", "description": "Alle Tests gruen" },
        { "label": "Review bestanden", "description": "Code Review akzeptiert" },
        { "label": "User-Feedback", "description": "Positives Nutzerfeedback" }
      ],
      "multiSelect": true
    }
  ]
}

4. Antworten zusammenfassen

Nach Erhalt der Antworten:

code
## Mein Verstaendnis der Aufgabe

**Kontext:** [Zusammenfassung]
**Ziel:** [Konkret was erreicht werden soll]
**Einschraenkungen:** [Was beachtet werden muss]
**Prioritaeten:** [Was am wichtigsten ist]
**Erfolgskriterien:** [Woran wir Erfolg messen]

Ist das so korrekt? Dann beginne ich mit der Umsetzung.

5. Mit Arbeit beginnen

Erst nach Bestaetigung der Zusammenfassung mit der eigentlichen Arbeit beginnen.

Wichtige Regeln

  • IMMER alle Fragen auf einmal stellen (nicht nacheinander)
  • NIEMALS Annahmen treffen ohne zu fragen
  • KURZE Fragen, keine langen Erklaerungen
  • KONKRETE Optionen anbieten, nicht offene Fragen
  • Bei technischen Aufgaben: Fragen auf den Tech-Kontext anpassen

Typische Nutzung

User: /clarify Baue einen neuen Login-Flow

Response:

  1. AskUserQuestion mit 4 klaerenden Fragen
  2. Warte auf Antworten
  3. Fasse Verstaendnis zusammen
  4. Beginne mit Implementation