CommunityCodierung & Entwicklunggithub.com

hava-idea/fy-flow

Ein Workflow-Skill-Paket für die multi-rollenbasierte Zustandsverwaltung, Qualitätsprüfung, Fehlervermeidung und Kanban-Automatisierung in der Zusammenarbeit zwischen mehreren KI-Agenten und menschlichen Teams. Aktivierbar über die Kurzbefehle /fy-flow help, /fy-flow start, /fy-flow status, /fy-flow kanban, /fy-flow trace oder über natürliche Sprache.

Was ist fy-flow?

FY-Flow ist ein vertragsgetriebener Mikrokernel für die kollaborative Entwicklung mehrerer KI-Agenten, der auf dem AutoGen-Paradigma basiert und unbefugte Aktionen, fragmentierte Arbeitsabläufe und Status-Hänger effektiv verhindert. Es definiert einheitliche Gateway-Protokolle, die alle Eingaben über einen zentralen Einstiegspunkt kanalisieren und in zwei Zweige aufteilen: Systemkonsole-Operationen (z. B. Hilfe, Start, Status, Kanban) und geschäftliche Entwicklungs-/Interaktionsintentionen. Letztere durchlaufen einen erzwungenen Drei-Fragen-Klassifizierungsprozess, der Aufgaben in L0 (Sofortantwort), L1 (leichte Aufgabe) und L2 (standardmäßige Entwicklungsaufgabe) einteilt. Jede L1/L2-Aufgabe muss vor der Autorisierung durch einen menschlichen Benutzer in einem 'zurückgehalten' Zustand verbleiben. Das Skill-Paket enthält acht spezialisierte Sub-Agenten (PM, Architekt, Entwickler, Frontend, Reviewer, QA, Docs, DevOps) mit klar definierten Schreibberechtigungen, Zustandsübergängen und Exit-Verträgen. Es unterstützt Codex Desktop und andere Hosts durch ein Dispatch-Token-Gating-System und bietet eine Reihe von CLI-Befehlen für die Aufgabenverwaltung, Statusübergänge, Kanban-Start, Integritätsprüfungen, Trace-Generierung und intelligente inkrementelle Tests. Die Hauptvorteile liegen in der Disziplinierung des Agentenverhaltens durch strenge Zustandsautomaten und Verträge, der Verhinderung von 'Self-Playing' und der Sicherstellung von Qualität und Auditierbarkeit durch menschliche Endabnahme.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
Part ofAgent Workflows
npx skills add hava-idea/fy-flow

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

FY MultiAgent Flow Skill (FY-Flow)

Vertragsgetriebener Mikrokern für die kollaborative Entwicklung mehrerer KI-Agenten (FY-Flow) – Ausgerichtet am AutoGen-Paradigma, Verhinderung von Autorisierungsüberschreitungen, Aufgabenfragmentierung und Status-Hängern.

Einheitliches Gateway-Einstiegsprotokoll (Unified Gateway Protocol)

Alle Aufrufe dieses Skills werden einheitlich über diesen Gateway-Einstiegspunkt kanalisiert und gemäß den folgenden zwei Verzweigungsregeln klassifiziert und verarbeitet:

1. Zwei-Verzweigungs-Matrix

VerzweigungstypAuslöser & BefehlVerarbeitungsmechanismus & AntwortvertragTypisches Szenario
Verzweigung A: Systemkonsole-Operation/fy-flow help/fy-flow start/fy-flow status/fy-flow kanban/fy-flow traceDirekt zur zugrunde liegenden Betriebsengine (0 Vorab-Klassifizierung), führt das entsprechende Skript direkt aus und gibt den Systemstatus aus.Hilfedokumentation anzeigen, SOP initialisieren, Kanban starten, Systemüberprüfung, Offline-Trace-Diagramm
Verzweigung B: Geschäftsentwicklung & InteraktionsabsichtAnforderungen in natürlicher Sprache, Codeänderungen, Feature-Entwicklung, Fehlerbehebung, Debugging, /fy-flow autoVorherige erzwungene Durchführung von [Drei-Fragen-Klassifizierung und Single-Responsibility-Aufteilung] und Ausgabe eines Doppelkopf-Headers in der ersten Antwortzeile:`【Aufgabenstufe: L0 Sofortantwort / L1 Leichte Aufgabe / L2 Standardentwicklung】【Single-Responsibility: Konforme Einzelkarte / Komplexe Anforderung muss in N atomare Aufgaben zerlegt werden】`

2. Drei-Fragen-Entscheidungsfluss für Geschäftsanforderungen

[Geschäftsanforderungseingabe]
   │
   ├─► 1. Werden Code-/Dokument-/Konfigurations- oder andere Repository-Dateien geändert?
   │      ├─ Nein ──► 2. Muss das Ergebnis für die spätere technische Nachverfolgung aufbewahrt werden?
   │      │            ├─ Nein ──────────────────────► 【L0 Sofortantwort】 (Keine Karte, direkte Antwort, 0 ms CLI-Latenz, Entwurf in Entwurfsordner)
   │      │            └─ Ja ────────────────────────► 【L1 Leichte Aufgabe】 (Karte erstellen, anhalten bis zur Bearbeitung → nach menschlicher Autorisierung, Einzelrolle erledigt)
   │      │
   │      └─ Ja ──► 3. Sind mehrere Rollen beteiligt, wird Kern-Business-Code geändert oder eine gemeinsame Basisbibliothek geändert?
   │                   ├─ Nein ──────────────────────► 【L1 Leichte Aufgabe】
   │                   └─ Ja ────────────────────────► 【L2 Standardentwicklungsaufgabe】 (Karte erstellen, anhalten bis zur Bearbeitung → nach menschlicher Autorisierung, mehrere Rollen zusammenarbeitend)
  • Gateway-Klassifizierung und CCP-Elastizitätsklassifizierungs-Mapping:
    • 【L0 Sofortantwort】 : Keine Karte, direkte Antwort, 0 Zustandsmaschinen-Overhead;
    • 【L1 Leichte Aufgabe】 : Mapping auf CCP Tier-3 (Fast-Path, schnelle Freigabe, kein separater physikalischer Bericht, Anmeldeinformationen direkt zurück ins Kanban);
    • 【L2 Standardentwicklung】 : Automatisches Mapping auf CCP Tier-2 (Teiloptimierung, Arbeitsaufwand ≤ 4,0 h, kein physikalischer Bericht) oder CCP Tier-1 (Kernarchitektur und Schnittstellenverträge streng verpflichtend) basierend auf Umfang und Vertrag.
  • Bei L1/L2-Geschäftsanforderungen wird vom Gateway eine Single-Responsibility-Prüfung erzwungen (Aufwandsdauer ≤ 8,0 h, einzelnes atomares Ergebnis). Anforderungen, die orthogonale Bereiche überschreiten, müssen aufgeteilt und als separate Karten erstellt werden.
  • Harte rote Linie für die Bearbeitungsautorisierung: Nach der Kartenerstellung ist der aktuelle Planungsdurchgang abgeschlossen; die Aufgabenkarte muss strikt im Status 【Zurückgestellt】 verbleiben; ohne explizite Bearbeitungsautorisierung durch den menschlichen Benutzer (z. B. "Loslegen", "Mit Entwicklung beginnen", "Ausführung bestätigen") ist es strengstens verboten, automatisch Aufgaben in den Status 【In Bearbeitung】 zu verschieben.
  • Die Ausführungs-Task-ID (z. B. T0001) wird direkt durch das Gateway in die Zustandsmaschine übergeben; eine erneute Kartenerstellung ist nicht zulässig.

Kurzreferenz der Kernbefehle (CLI Command Quick Reference)

GeschäftsszenarioEinheitliche CLI-Schnittstelle (cli.py)Unterspezifisches SkriptKernfunktion & Parameter
Aufgabenkarte erstellenpython3 scripts/cli.py task create ...python3 scripts/quick_task.py create ...--name "..." --assignee "..." --stage "Sprint 2.1 Menüanpassung" --type "A" --target "..." --criteria "..." [--in-scope "file # Grund"]
Phasengatter-Zugang/Phasenabschlusspython3 scripts/check_stage_gate.py ...python3 scripts/check_stage_gate.py ...--action start/close --stage "Sprint 2.1 Menüanpassung" (Zugang nach Bedarf, vorherige Abhängigkeiten werden automatisch überprüft)
Codebasierte Aufgabenverteilungpython3 scripts/cli.py dispatch --task-id T00xx --format codexpython3 scripts/dispatch_task.pyÜberprüft Abhängigkeiten und Parallelität, verschiebt nach 【In Bearbeitung】, gibt JSON-Parameter aus, die direkt vom Codex-Sub-Agenten-Tool verwendet werden können
Aufgabenstatus weiterleitenpython3 scripts/transition_task.py ...python3 scripts/transition_task.py ...--task-id T00xx --role DEV --from-status In Bearbeitung --to-status In Überprüfung --token <token> --summary "Beschreibung der Kernänderung" --remarks "..." (Bei Einreichung zur Überprüfung muss --summary mit Änderungsdiff und Anmeldeinformationen-Snapshot mitgeliefert werden)
Menschliche Endabnahmepython3 scripts/cli.py task accept ...python3 scripts/quick_task.py accept ...--task-id T00xx (Nur für menschliche Benutzer, Agenten ist die Unterschrift strengstens untersagt)
Kanban startenpython3 scripts/cli.py kanbanpython3 scripts/start_kanban_server.pyStartet standardmäßig unter http://127.0.0.1:32886/
Systemüberprüfungpython3 scripts/cli.py statuspython3 scripts/heartbeat.pyGibt Systemzustand, blockierte Karten und Leistungskennzahlen aus (einschließlich Sub-Agenten-Kognitions-Roaming und Alarmen bei > 600 s)
Technologie-Stack-Synchronisation/Profil-Neuberechnung-scripts/update_agent_tech_stacks.py--force-recalc erzwingt die Neuberechnung der Expertenfähigkeitsprofile und aktualisiert den Export von Sub-Agenten; behebt Probleme mit veralteten Profilen nach Technologie-Stack-Migration
Kontinuitätsprüfungpython3 scripts/cli.py ccp ...python3 scripts/cli.py ccp ...--task-id T00xx --stage In Überprüfung überprüft die Kontextkontinuität
Vollständiges Link-Trace-Diagrammpython3 scripts/cli.py tracepython3 scripts/generate_trace_html.pyAnalysiert Sitzungsspuren offline und generiert in Sekundenschnelle ein vollständiges Link-Trace-Diagramm als HTML (0 Token)
Intelligente inkrementelle Testspython3 scripts/cli.py testscripts/run_tests.pyErkennt automatisch Git-Änderungen, führt nur relevante Unit-Tests aus (sekundenschnell), Dokumentationsänderungen werden automatisch ausgenommen, --all für vollständige Regression

8 Experten-Sub-Agenten: Schreibberechtigungen & Statusübergangsmatrix

[!IMPORTANT] Physikalische Isolationseisenregel & Token-Gating (Dispatch Token Gating):

  1. Dem Haupt-Agenten (PM Manager Yan) ist es strengstens untersagt, in der Hauptsitzung selbst die Rolle des Entwicklers zu spielen und Business-Code zu schreiben! Codex-Hosts müssen die echten Sub-Agenten-Tools zur Verteilung verwenden; andere Hosts können ihre eigenen Sub-Agenten-Tools verwenden.
  2. Codebasierte Verteilung & Token-Gating: Bei der Aufgabenverteilung wird von cli.py dispatch ein dedizierter dispatch_token generiert. Professionelle Entwicklungsrollen (DEV/FRONTEND/REVIEWER/QA) müssen bei der Statusweitergabe --token <token> mitführen; die Zustandsmaschine erzwingt dies auf der unteren Ebene, um Selbstspielerei und vorgetäuschte Grünstatus zu verhindern.

Codex Desktop Automatischer Verteilungsvertrag

Nach expliziter Autorisierung durch den Benutzer führt der Haupt-Agent im Zielprojektverzeichnis aus: python3 .agents/skills/fy-flow/scripts/dispatch_task.py --task-id <ID> --format codex. Die Standardausgabe ist ein einzelnes JSON-Objekt, das tool, arguments, task_id und role enthält; Diagnoseinformationen werden über die Standardfehlerausgabe gesendet. Der Haupt-Agent muss die arguments unverändert als tatsächlichen Aufruf des Tools collaboration.spawn_agent verwenden, auf die Rückkehr des Sub-Agenten warten und dann basierend auf dem aktuellen Aufgabenstatus die Verteilung der Überprüfungs- und Testexperten fortsetzen. Die Verteilungsnachricht darf nicht manuell neu geschrieben, kopiert oder verkürzt werden; das JSON darf nicht als Abschluss der Verteilung ausgegeben werden, und der Haupt-Agent darf die Arbeit des Experten nicht selbst ausführen. Wenn der aktuelle Codex-Host kein Sub-Agenten-Tool hat, muss der Host-Mangel klar gemeldet werden; die Aufgabe bleibt im aktuellen Status, und es wird kein gefälschter Expertenbeleg erstellt. Ein bereits verteilter Experte führt nur das exit_contract.required_cli in der Nachricht aus; er darf keine neue Karte erstellen oder mit der Arbeit beginnen. Da die Benutzerautorisierung diese Ausführung abdeckt, kann die Verteilung nach der Kartenerstellung in derselben Sitzung fortgesetzt werden; nur wenn noch keine Bearbeitungsautorisierung vorliegt, bleibt der Status 【Zurückgestellt】.

Sub-Agenten-IDRollennameKernaufgabeGültiger StatusübergangsbereichAustrittsvertrag
@flow-pmManager Yan (Projektmanager)Anforderungsanalyse, Klassifizierung & KartenerstellungZurückgestellt -> In Bearbeitung / Zur Abnahme vorgelegtKartenerstellungsszenario bleibt bei 【Zurückgestellt】, wartet auf Bearbeitungsautorisierung; legt zur menschlichen Abnahme vor
@flow-architectQian Architekt (Systemarchitekt)Gesamtsystemarchitektur, Schnittstellenverträge & TechnologieauswahlZurückgestellt -> In Bearbeitung -> AbgeschlossenErstellt ADR & Architekturdokumentation
@flow-devLi Entwickler (Entwicklungsingenieur)Backend-/Full-Stack-Kerncodierung & Unit-Test-ImplementierungZurückgestellt -> In Bearbeitung -> In ÜberprüfungMuss Unit-Tests ausführen, Entwicklungsbericht erstellen, bei Einreichung --summary bereitstellen
@flow-frontendMa Frontend (Frontend-Entwicklungsingenieur)Web/UI-Komponenten & Frontend-ErfahrungsimplementierungZurückgestellt -> In Bearbeitung -> In ÜberprüfungÜberprüft Komponenten-Rendering & Interaktion, erstellt Bericht, stellt bei Einreichung --summary bereit
@flow-reviewerZhou Reviewer (Code-Review-Experte)Code-Standards, Sicherheitsscans & QualitätsgatterIn Überprüfung -> Im Test / In Überprüfung -> Abgeschlossen (Tier-3-Anmeldeinformationen frisch & nicht abgewichen, Überspringen von QA) / In Überprüfung -> ZurückgewiesenStatischer Scan ohne Warnungen, erstellt Überprüfungskommentare
@flow-qaZhang Tester (Testingenieur)Zielgerichtete Integrationstests & Freigabe (führt nur für die aktuelle Aufgabe relevante Tests aus; Ausführen von vollständigen Skripten strengstens untersagt)Im Test -> Abgeschlossen / Im Test -> ZurückgewiesenErstellt zielgerichtete Testfälle, dokumentiert tatsächliche Arbeitszeit
@flow-docsLi Wentong (Dokumentationsingenieur)Verwaltung von Ergebnisdokumentationen & BenutzerhandbüchernZurückgestellt -> In Bearbeitung -> AbgeschlossenBefolgt akademische und technische Standards gemäß GB/T 7713
@flow-devopsLü Gaite (Betriebsadministrator)Branch-Merging, Release-Builds & Git-HistorienschutzZurückgestellt -> In Bearbeitung -> AbgeschlossenÜberprüft Pipeline-Erfolg, löst PR-Blockaden

Modulares Vertrags-Entity-Verzeichnis (Nach Bedarf spezifische Regelspezifikationsdateien einsehen)

Genau dann, wenn ein bestimmtes Geschäftsszenario eintritt, MUSS der Agent view_file aufrufen, um die entsprechende Entity-Markdown-Datei einzusehen:

Verwandte Skills

steipete/bluebubbles

Send and manage iMessages via BlueBubbles, including attachments, tapbacks, edits, replies, and groups.

community

steipete/eightctl

Control Eight Sleep pods (status, temperature, alarms, schedules).

community

steipete/blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

community

steipete/bear-notes

Create, search, and manage Bear notes via grizzly CLI.

community

steipete/camsnap

Capture frames or clips from RTSP/ONVIF cameras.

community

steipete/gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets.

community
← More Codierung & Entwicklung skills