aitormf/agent-skills

Eine Überprüfung anwenden

Helfen Sie dem Anwender, über jeden Prüfpunkt zu entscheiden und nur das anzuwenden, was er genehmigt.

Kernregel: Nehmen Sie niemals an, schließen Sie nicht und wenden Sie keine Änderung ohne eine explizite Entscheidung an. Wenn ein Prüfpunkt mehrdeutig ist, fragen Sie nach Klärung, bevor Sie Optionen anbieten. Jeder Prüfpunkt wird separat entschieden; gruppieren Sie sie niemals.

Artefakte und Status

• Jeder Arbeitsauftrag befindet sich in docs/specs/<YYYYMMDD>-<typ>-<name>/.
• spec.md und plan.md haben status: draft | approved | obsolete in ihrem Frontmatter. Nur eine Person setzt approved.
• Wenn Sie ein Artefakt ändern, das den Status approved hatte, setzen Sie es auf draft zurück und teilen Sie dies mit.

Schritt 1: Prüfpunkte präsentieren

1. Identifizieren Sie den Arbeitsauftrag und die Überprüfung (review-spec.md oder review-plan.md). Fragen Sie, falls dies nicht klar ist.
2. Listen Sie alle Prüfpunkte, nummeriert, zuerst die blockierenden. Zeigen Sie für jeden:
   • Prüfpunkt [N]: Was die Überprüfung aufzeigt.
   • Vorgeschlagene Korrektur, falls vorhanden.
   • Optionen:
     • A) Korrektur wie vorgeschlagen anwenden.
     • B) Eine modifizierte Korrektur anwenden (der Anwender beschreibt sie).
     • C) Verwerfen, mit Begründung.
     • D) Zurückstellen.

Warten Sie, bis der Anwender alle beantwortet hat, bevor Sie fortfahren.

Schritt 2: Bestätigen

Entscheidungsübersicht
────────────────
[N] <Titel> → anwenden / modifiziert / verworfen / zurückgestellt

Fragen Sie: „Bestätigen Sie diese Entscheidungen, bevor ich sie anwende?“ Fahren Sie nicht ohne Bestätigung fort.

Schritt 3: Anwenden

1. Wenden Sie nur die bestätigten Änderungen an (A und B) und nur an den überprüften Artefakten. Berühren Sie nichts anderes.
2. Notieren Sie in der Überprüfungsdatei unter jedem Prüfpunkt die getroffene Entscheidung:
   • Bei verworfenen Punkten: die Begründung;
   • Bei zurückgestellten Punkten: was noch aussteht.
3. Teilen Sie dem Anwender mit, wie der Stand ist:
   • Wenn keine blockierenden Prüfpunkte mehr offen sind, ist das Artefakt bereit, von ihm als approved markiert zu werden, oder für einen weiteren review-spec-Durchlauf.
   • Wenn noch blockierende zurückgestellte Punkte vorhanden sind oder verworfen wurden, die ein Risiko bergen, weisen Sie darauf hin.

Schritt 4: Andere betroffene Spezifikationen

Prüfen Sie, ob eine Entscheidung aus Schritt 2 andere in Bearbeitung befindliche Spezifikationen betrifft:

1. Suchen Sie in docs/specs/*/spec.md nach solchen mit status: draft.
2. Überlegen Sie bei jeder, ob eine Entscheidung einen Konflikt verursacht, eine Abhängigkeit ändert oder eine Annahme ungültig macht.
3. Für jede Spezifikation, die möglicherweise betroffen ist:
   • Zeigen Sie, welche Spezifikation, welcher Abschnitt und was geändert werden müsste;
   • Fragen Sie: „Betrifft diese Entscheidung diese Spezifikation? Soll ich eine Änderung vorschlagen?“. Warten Sie auf ein Ja oder Nein.
4. Wenn die Antwort Ja ist, erstellen Sie nur die minimale Änderung (den genauen Abschnitt und die Zeilen), zeigen Sie den Diff und wenden Sie ihn nur nach Genehmigung an.

Verbessern, erweitern oder formatieren Sie nichts anderes in diesen Spezifikationen. Wenn zu irgendeinem Zeitpunkt unklar ist, was zu tun ist, halten Sie an und fragen Sie.