RafaelFerSilva/refinement-agent-skills

Arbeitsbereich konfigurieren

Schreiben Sie die Arbeitsbereichskonfiguration, die von /refine-story, /qa-plan, /requirements-discovery und /meeting-minutes vorausgesetzt wird. Dies ist eine gesprächsgesteuerte Skill, kein automatisiertes Skript: Erkunden, Ergebnisse präsentieren, bestätigen und erst dann Dateien schreiben.

Schritte

1. Erkunden. Prüfen Sie vorhandene Dateien, bevor Sie Annahmen treffen: AGENTS.md und CLAUDE.md im Stammverzeichnis, CONTEXT.md, docs/agents/refinement.md und docs/agents/issue-tracker.md (frühere Ausgaben dieser Skill), .scratch/ sowie Signale für Quellcode: package.json, pyproject.toml, src/, go.mod oder alles, was ein Team kompiliert oder ausführt. Wenn docs/agents/issue-tracker.md bereits aus einer anderen Konvention existiert, bewahren Sie sie: Überprüfen Sie lediglich, ob sie angibt, wo veröffentlicht wird. Wenn CLAUDE.md lediglich eine Brücke mit @AGENTS.md ist, ist die primäre Anweisungsdatei AGENTS.md. Abgeschlossen, wenn: Sie wissen, ob der Arbeitsbereich bereits konfiguriert ist, der wahrscheinliche Modus, die wahrscheinliche Sprache (en-US oder pt-BR), ob ein Glossar existiert, ob der Tracker existiert und welche Anweisungsdatei zu bearbeiten ist.

2. Fragen, Abschnitt für Abschnitt, mit der empfohlenen Antwort voran.

   Modus. Empfehlung basierend auf den Ergebnissen: wenn Code vorhanden ist, com-codigo (mit Code); wenn nicht, sem-codigo (ohne Code). Erklären Sie in einem Satz: Mit Code untersucht der Agent den Quellcode, bevor er fragt; ohne Code ist der PO die Quelle der Fakten und Architekturfragen werden zu Fragebögen für das Team.

   Sprache. Empfehlung basierend auf vorhandenen Dateien oder standardmäßig en-US: en-US oder pt-BR. Erklären Sie in einem Satz: Definiert die Sprache für Prüfung, Fragerunden, Erzählungen, Gherkin-Kriterien und Bewertungen.

   Arbeitsaufgaben. Entstehen User Stories in einem externen Tracker? Wenn ja, wie lautet die Basis-URL und Feldkonvention (z. B. Azure: <ID> für Azure DevOps-Arbeitsaufgaben). Jede US entsteht dort und jedes Artefakt trägt diese ID-Zeile.

   Produktglossar. Existiert CONTEXT.md bereits? Wenn nicht, ist jetzt keine Aktion erforderlich: Die erste Prüfung, die einen Domänenbegriff auflöst, wird sie erstellen. Machen Sie dies deutlich.

   Abgeschlossen, wenn: Modus, Sprache, Arbeitsaufgabenkonvention und Basis-URL bestätigt sind.

3. Bestätigen und schreiben. Präsentieren Sie den Entwurf von docs/agents/refinement.md basierend auf refinement.md, docs/agents/issue-tracker.md basierend auf issue-tracker.md (nur wenn sie noch nicht existiert) und den ## Refinement-Block für die Agentenanweisungsdatei. Erlauben Sie Anpassungen. Schreiben Sie dann die Dateien. Für die Anweisungsdatei: Wenn CLAUDE.md existiert und AGENTS.md importiert (@AGENTS.md), bearbeiten Sie AGENTS.md; andernfalls bearbeiten Sie CLAUDE.md, falls vorhanden; andernfalls AGENTS.md, falls vorhanden; wenn keine existiert, fragen Sie, welche erstellt werden soll. Wenn der ## Refinement-Block bereits existiert, aktualisieren Sie ihn an Ort und Stelle, ohne den Rest der Datei zu ändern.

   Der Block:

   ## Refinement
   
   Sokratische Verfeinerungs-Workflows: Führen Sie `/which-flow` aus, um einen Workflow auszuwählen. Modus und Konventionen befinden sich in `docs/agents/refinement.md`; Tracker-Konventionen in `docs/agents/issue-tracker.md`. Artefakte befinden sich in `.scratch/<slug>/` mit `Status:` und Arbeitsaufgaben-ID.
   

   Abgeschlossen, wenn: refinement.md, die Tracker-Datei (neu oder erhalten) und der Anweisungsblock mit bestätigtem Inhalt vorhanden sind.

4. Abschließen. Bestätigen Sie, dass der Arbeitsbereich konfiguriert ist, listen Sie Workflows auf, die docs/agents/refinement.md lesen, und weisen Sie darauf hin, dass Dateien später manuell bearbeitet werden können; eine erneute Ausführung dieser Skill ist nur erforderlich, um den Modus, die Sprache oder die Tracker-Konventionen zu wechseln.