CommunitySchreiben & Editierengithub.com

troels-im/agent-skills-playbook-template

Progressive Docs-as-Code-Vorlage für KI-Agenten-Fähigkeiten, AGENTS.md, Playbooks, Arbeitsabläufe und Just-Test-Richtlinien

Was ist agent-skills-playbook-template?

Diese Fähigkeit bietet eine leichtgewichtige, token-effiziente Kommandooberfläche für Repository-Workflows mit KI-Agenten. Sie führt Agenten durch eine strukturierte Abfolge – vom Lesen der AGENTS.md und der Indexdateien über die Auswahl des kleinsten passenden Flows bis hin zur Erstellung eines timestamp-basierten Run-Checklisten und der schrittweisen Befolgung der zugehörigen Playbooks. Die Fähigkeit unterstützt explizite Benutzereingabegates (der Agent pausiert bei fehlenden Entscheidungen und fragt nach, anstatt Annahmen zu treffen) und endet mit automatisierten Testschritten (`just turn-test` vor jedem Commit, `just pr-test` vor dem Abschluss). Entwickelt für Umgebungen wie Claude Code, Cursor oder Codex, nutzt sie das `/lets`-Kommando als Benutzerschnittstelle und `flows/` als dauerhafte Repository-Schicht. Die implementierte Logik stellt sicher, dass Agenten ohne passenden Flow über `playbooks/repository/choose-workflow.md` routen und Fortschrittsupdates im Format `XX% / YY% / ZZ%: Nachricht` melden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add troels-im/agent-skills-playbook-template

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Lets

Nutzen Sie diese Fähigkeit als token-arme Kommandooberfläche für Repository-Workflows.

Workflow

  1. Lesen Sie AGENTS.md.
  2. Lesen Sie die root index.md.
  3. Lesen Sie flows/index.md.
  4. Wählen Sie den kleinsten passenden Flow.
  5. Laden Sie die ausgewählte Flow-Datei.
  6. Erstellen oder aktualisieren Sie die zum Flow gehörende Run-Checkliste. Verwenden Sie UTC-Zeitstempel-Slugs für generierte Run-Namen: run-YYYYMMDDTHHMMSSZ-short-slug.md.
  7. Befolgen Sie nur die vom Flow benannten Playbooks, die der aktuelle Schritt erfordert.
  8. Stellen Sie Fortschrittsupdates im vom Flow geforderten Format voran: XX% / YY% / ZZ%: Nachricht.
  9. Führen Sie just turn-test vor jedem Commit aus.
  10. Führen Sie beim letzten Schritt eines Flows just pr-test aus, beheben Sie fehlschlagende PR-Tests und wiederholen Sie den Vorgang, bis die PR-Tests bestehen oder ein echter Blocker dokumentiert wird.

Benutzereingabe-Gates

Wenn ein Flow-Schritt Benutzereingaben, Genehmigung, eine Produktentscheidung oder Feedback benötigt, um korrekt fortzufahren, pausieren Sie die Schleife und fragen Sie. Treffen Sie keine fehlenden Entscheidungen oder fahren Sie nicht auf Basis von angenommenen Anforderungen fort.

Fahren Sie nur dann ohne Nachfrage fort, wenn der Benutzer ausdrücklich sagt, dass Sie ihn nicht stören, ihn nicht fragen, mit bestem Ermessen fortfahren oder eine gleichwertige Anweisung geben sollen. Notieren Sie in diesem Fall die Annahme in der Run-Checkliste und halten Sie sie möglichst reversibel.

Wenn kein Flow passt, sagen Sie das klar und leiten Sie über playbooks/repository/choose-workflow.md weiter.

Behandeln Sie /goal oder /loop nicht als Benutzerbefehle für diese Vorlage. Verwenden Sie /lets als benutzerseitigen Befehl und flows/ als dauerhafte Repository-Schicht.

Verwandte Skills