Communitygithub.com

candycong2001-ui/agent-project-playbook

Ein installierbares, migrierbares und iterativ verbessertes Mensch-Maschine-Projekt-Kollaborationshandbuch.

Was ist agent-project-playbook?

Diese Skill-Schablone definiert ein formales Arbeitsablaufprotokoll für die Zusammenarbeit zwischen einem AI-Agenten und einem menschlichen Entwickler. Es stellt sicher, dass alle Beteiligten stets über den aktuellen Projektkontext informiert sind, indem es eine Reihe von Dokumenten bereithält (BLUEPRINT.md, ARCHITECTURE.md, CURRENT_HANDOFF.md und AGENTS.md). Der Skill automatisiert die Kommunikation und den Dokumentenabgleich, sodass der Agent nach jedem relevanten Schritt den aktuellen Handoff-Status aktualisiert. Entwickler können damit den Überblick über das Projekt bewahren, ohne ständig neu erklären zu müssen, wo genau sie gerade stehen oder was als nächstes zu tun ist. Der Skill kommt ohne zusätzliche Abhängigkeiten aus und unterstützt jede Codebasis, solange die entsprechenden Dokumente im `docs/`-Verzeichnis vorhanden sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add candycong2001-ui/agent-project-playbook
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Projektdokumentation

Arbeitsablauf

  1. Lies zu Beginn einer umfangreichen Implementierung oder Fehlerdiagnose docs/CURRENT_HANDOFF.md und nur die relevanten Abschnitte der stabilen Dokumente.
  2. Überprüfe Behauptungen aus den Dokumenten anhand des aktuellen Repository-Zustands.
  3. Melde bei der Erkundung oder reinen Überprüfung Abweichungen, ohne Änderungen vorzunehmen, es sei denn, der Benutzer autorisiert diese.
  4. Ersetze zu Beginn einer Aufgabe das aktuelle Ziel und die nächste Aktion in CURRENT_HANDOFF.md.
  5. Ersetze nach einem bestätigten Meilenstein den aktuellen Zustand und die Verifizierungsnachweise; füge keinen Zeitplan hinzu.
  6. Entferne vor der Übergabe abgeschlossene Prozessdetails und hinterlasse einen fortsetzbaren Zustand.
  7. Aktualisiere BLUEPRINT.md nur, wenn sich Produktabsicht, Benutzer, Umfang, Einschränkungen oder Akzeptanzkriterien ändern.
  8. Aktualisiere ARCHITECTURE.md nur, wenn sich Komponenten, Grenzen, Datenfluss, verifizierte Befehle, Bereitstellung, Rollback oder Risiken ändern.
  9. Führe vor einer umfangreichen Auslieferung python3 .agents/skills/project-docs/scripts/docs_lint.py aus.

Grenzen

  • Aktueller Code, Tests, Konfiguration, Befehlsausgabe und Benutzeranweisungen haben Vorrang vor diesen Dokumenten.
  • BLUEPRINT sollte maximal 160 Zeilen umfassen.
  • ARCHITECTURE sollte maximal 160 Zeilen umfassen.
  • CURRENT_HANDOFF sollte maximal 80 Zeilen umfassen.
  • AGENTS sollte maximal 90 Zeilen umfassen.
  • Git speichert den Verlauf. CURRENT_HANDOFF speichert nur den letzten Arbeitszustand.

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community