0xKoios/skills

Azure DevOps Boards: Meine Karten

Hilft einer Person, ihre eigenen Karten auf Azure Boards über MCP oder az zu verwalten. Teamkonventionen leben in der Konfiguration; derselbe Skill passt für verschiedene Teams.

1. Vor allem anderen

1. Konfiguration lesen – ~/.config/ado-boards/config.md (Windows: %USERPROFILE%\.config\ado-boards\config.md). Fehlt → zuerst die Kern-Einrichtung ausführen (workflows/setup.md); Raten der Organisation/des Projekts schreibt an die falsche Stelle. Werte, die als not set yet markiert sind, werden beim ersten Bedarf durch einen Workflow gesammelt.
2. Backend für diesen Durchgang auswählen:
   • MCP, wenn Azure DevOps MCP-Werkzeuge verfügbar sind (z. B. wit_work_item): mcp-tools.md laden (plus eine az/ Lückendatei nur dann, wenn diese Karte eine MCP-Lücke dokumentiert).
   • az sonst: az/README.md laden, plus die eine Abschnittsdatei für diesen Workflow. Auch az/windows.md nur dann, wenn eine HTML-Beschreibung/AC-Ausgabe verstümmelt zurückkommt oder PowerShell-Zitierung fehlschlägt. Login bestätigen (az account show oder AZURE_DEVOPS_EXT_PAT); wenn keines, führt der Benutzer az login selbst aus.
   • Keines → auf Einrichtung verweisen.
3. Den passenden Workflow öffnen (Tabelle unten) und ihm folgen. Workflows sagen was; die Backend-Datei sagt wie. Regeln in §2 binden beide Backends.

Fertig, wenn die Konfiguration vorliegt, ein Backend ausgewählt ist und die Workflow-Datei geöffnet ist.

Der Benutzer meldet sich selbst an (Entra / az login). Anmeldedaten bleiben außerhalb des Chats.

2. Regeln

Lesezugriffe benötigen keine Berechtigung. Jeder Schreibzugriff benötigt eine Vorschau und ein explizites Ja – selbst wenn das Werkzeug selbst nicht danach fragt. Das Board wird geteilt; MCP-Schreibvorgänge überspringen oft eine Eingabeaufforderung, daher ist die Vorschau das Tor.

Regel	Kriterium
Vorschau-Umfang	Eine Änderung an der eigenen Karte des Benutzers → eine Zeile (#512: Status Aktiv -> Geschlossen. OK?). Mehrere Änderungen oder eine Karte eines anderen → Tabelle (ID, Feld, alt, neu). Mehr als 10 → Anzahl nennen und erneut bestätigen.
Rückmeldung	Nach jedem Schreibvorgang: ID, was geändert wurde, URL https://dev.azure.com/<org>/<project>/_workitems/edit/<id>.
Eltern	Wenn die Konfiguration Parent required: yes sagt, nur mit einem Elternteil erstellen (Waisen fallen aus Backlog-Ansichten heraus).
Bugs	Wenn die Konfiguration sagt, dass Bugs woanders leben: einen Task unter dem bestehenden Bug anbieten (ein zweiter Bug spaltet die Historie).
Externe Karten	Titel-Präfix in der Konfiguration (z. B. EXT): warnen, dass Kommentare vor Kommentar- oder Feldänderung mit dem Reporter synchronisiert werden können; Auswirkung beim Schließen überspringen.
Einheiten	Zeitfelder sind einfache Zahlen; Einheit steht in der Konfiguration. Umrechnen, wenn der Benutzer eine andere Einheit nennt, beide anzeigen, immer die Einheit nennen (Boards-UI zeigt in beiden Fällen "h").
Karten bleiben	Schließen oder verschieben; die Karte auf dem Board belassen. Einen Kommentar nur entfernen, nachdem er vollständig angezeigt und ein Ja erhalten wurde – beides ist nicht rückgängig zu machen.
Eigene Kommentare	Nur die eigenen Kommentare des Benutzers bearbeiten oder entfernen (ADO lehnt den Rest ab).
Echte Werte	Nach Schätzungen, Bearbeitern, Daten, Auswirkung fragen – oder leer lassen. Erfundene Zahlen sehen auf dem Board echt aus.
Sichere Zitierung	Werte sicher zitieren; Titel können Anführungszeichen enthalten.
Schreib-Fußzeile	Nach einem Schreibvorgang: was getan wurde, was übersprungen wurde, ein nächster Schritt. Reine Lesezugriffe: nur antworten.

3. Workflows

Wenn	Öffnen
Den ADO-Skill einrichten; Konfiguration fehlt; etwas hat sich geändert	workflows/setup.md
Was liegt auf meinem Teller; zeige meine Karten; verschieben; Zeit buchen; schließen	workflows/my-cards.md
Eine Karte erstellen; eine Story in Tasks zerlegen	workflows/create-card.md
Kommentar hinzufügen, auflisten, bearbeiten oder entfernen	workflows/comments.md
Beschreibung oder Abnahmekriterien	workflows/write-description.md
Meinen Sprint planen; woran soll ich zuerst arbeiten	workflows/plan-my-sprint.md

4. Agile Referenz (gegen Konfiguration prüfen)

Hierarchie: Epic > Feature > User Story > Task. Bugs sitzen je nach Team-Einstellung neben oder unter Stories.

Typ	Status
Feature / User Story	Neu, Aktiv, Gelöst, Geschlossen, Entfernt
Bug	Neu, Aktiv, Gelöst, Geschlossen
Task	Neu, Aktiv, Geschlossen, Entfernt

Eltern: Task unter User Story (oder Bug), User Story unter Feature. Benutzerdefinierte Status und Pflichtfelder leben in der Konfiguration, sobald sie gesammelt wurden.