CommunityProgramação e Desenvolvimentogithub.com

FY MultiAgent Flow Skill (FY-Flow)

Conjunto de habilidades de fluxo de trabalho multiagente para desenvolvimento colaborativo entre IA e humanos, com transição de estados de múltiplos papéis, auditoria de qualidade, prevenção de erros e automação de kanban. Pode ser ativado por comandos como /fy-flow help, /fy-flow start, /fy-flow status, /fy-flow kanban, /fy-flow trace ou por linguagem natural.

O que é FY MultiAgent Flow Skill (FY-Flow)?

O FY-Flow é um skill de fluxo de trabalho colaborativo multiagente, projetado para orquestrar a transição de estados de tarefas, auditoria de qualidade e prevenção de erros em um ambiente de desenvolvimento de software que combina múltiplos agentes de IA e humanos. Ele funciona como um microkernel que gerencia a definição de tarefas, sua priorização, alocação e execução, garantindo que cada atividade siga um processo rigoroso, com verificações de qualidade e validação contínua. O skill suporta plataformas como Claude Code, Cursor e Codex, e oferece uma interface unificada através de comandos CLI rápidos (por exemplo, /fy-flow start) ou linguagem natural. O FY-Flow implementa um fluxo de decisão de três níveis (L0, L1, L2) para classificar tarefas, que podem ser respostas rápidas, tarefas leves ou tarefas de desenvolvimento padrão. Ele também gerencia um kanban automatizado, realiza auditorias de saúde do sistema e fornece relatórios de rastreabilidade, tudo com um forte controle de acesso e tokens de despacho para evitar que um agente se passe por outro. O skill é particularmente útil para evitar a fragmentação de tarefas e o deslizamento de estado, garantindo que cada etapa seja concluída antes da próxima, e que a qualidade do código seja mantida através de revisões e testes integrados. A arquitetura modular do FY-Flow, com seus oito subagentes especializados (PM, Arquiteto, Desenvolvedor, etc.), permite que as atividades sejam delegadas de forma eficiente, com cada subagente atuando dentro de um intervalo de estados específico e com um contrato de saída claro.

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

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

O que FY MultiAgent Flow Skill (FY-Flow) faz?

Microkernel colaborativo multiagente orientado por contrato (FY-Flow) — Alinhado ao paradigma AutoGen, prevenindo efetivamente acesso não autorizado, fragmentação de tarefas e estagnaçao de estado.

Protocolo de Gateway de Entrada Unificado (Unified Gateway Protocol)

Todas as instruções que invocam este Skill são unificadas e convergidas para este ponto de entrada do gateway, com desvio e decisão baseados nas seguintes duas regras:

1. Matriz de Desvio de Duas Linhas

Tipo de RamoCaracterística de Gatilho e InstruçãoMecanismo de Processamento e Contrato de RespostaCenário Típico
Ramo A: Operação do Console do Sistema/fy-flow help/fy-flow start/fy-flow status/fy-flow kanban/fy-flow traceRota direta para o mecanismo de operação subjacente (sem pré-classificação), executando diretamente o script correspondente e gerando o status do sistema.Visualizar manual de ajuda, SOP de inicialização, iniciar kanban, inspeção geral, diagrama de visão geral offline
Ramo B: Intenção de Desenvolvimento e Interação de NegóciosRequisitos em linguagem natural, modificação de código, desenvolvimento de funcionalidades, correção de defeitos, solução de problemas, /fy-flow autoExecutar forçadamente a [Classificação em Três Níveis e a Separação de Responsabilidade Única] antes do processamento, e gerar explicitamente na primeira linha da resposta o cabeçalho duplo:【Classificação de Tarefa: L0 Resposta Imediata / L1 Tarefa Leve / L2 Desenvolvimento Padrão】 【Responsabilidade Única: Cartão Individual / Requisitos complexos devem ser divididos em N tarefas atômicas】

2. Fluxo de Decisão [Classificação em Três Níveis] para Requisitos de Negócios

[Entrada de Requisito de Negócio]
   |
   ├─► 1. Isso resultará em alterações de arquivos no repositório (código, documentos, configuração, etc.)?
   |      ├─ Não ──► 2. O resultado precisa ser rastreável posteriormente como base de engenharia?
   |      |            ├─ Não ───────────────► 【L0 Resposta Imediata】（Sem cartão, responder diretamente, 0 ms de latência CLI, rascunho na caixa de rascunho）
   |      |            └─ Sim ──────────────► 【L1 Tarefa Leve】（Criar cartão, parar aguardando início → Aguardar autorização humana, concluir com um único papel）
   |      |
   |      └─ Sim ──► 3. Requer colaboração de múltiplos papéis, modificação de código de negócios principal ou alteração de bibliotecas base comuns?
   |                   ├─ Não ───────────────► 【L1 Tarefa Leve】
   |                   └─ Sim ──────────────► 【L2 Tarefa de Desenvolvimento Padrão】（Criar cartão, parar aguardando início → Aguardar autorização humana, colaboração de múltiplos papéis）
  • Mapeamento de Classificação de Gateway para Classificação Elástica CCP:
    • 【L0 Resposta Imediata】：Sem cartão, responder diretamente, 0 overhead do state machine;
    • 【L1 Tarefa Leve】：Mapeado para CCP Tier-3 (Fast-Path, liberação rápida, sem relatório físico, credenciais gravadas diretamente no kanban);
    • 【L2 Desenvolvimento Padrão】：Corresponde automaticamente, de acordo com o tamanho e o contrato, a CCP Tier-2 (Otimização local, horas de trabalho ≤ 4.0h, sem relatório físico) ou CCP Tier-1 (Restrições de arquitetura central e contrato de interface).
  • Para todos os requisitos de negócios L1/L2, o gateway aplica uma revisão de responsabilidade única (horas de trabalho ≤ 8.0h, único artefato atômico). Requisitos que abrangem domínios ortogonais devem ser divididos em cartões.
  • Linha vermelha rígida de autorização de início: Ao concluir a criação do cartão, o estado da sessão de planejamento atual é finalizado. O cartão de tarefa deve permanecer estritamente no estado 【Aguardando Início】. Sem uma instrução explícita de autorização de início do usuário humano (por exemplo, "Iniciar", "Começar a desenvolver", "Confirmar execução"), é estritamente proibido avançar automaticamente para 【Em Andamento】.
  • O ID da tarefa em execução (por exemplo, T0001) passa diretamente pelo gateway para o state machine. É estritamente proibido criar um segundo cartão.

Tabela de Referência Rápida de Comandos Principais (CLI Command Quick Reference)

Cenário de NegóciosFachada CLI Unificada (cli.py)Script Especializado SubjacenteFunção Principal e Parâmetros
Criar Cartão de Tarefapython3 scripts/cli.py task create ...python3 scripts/quick_task.py create ...--name "..." --assignee "..." --stage "Sprint 2.1 Ajustes de Menu" --type "A" --target "..." --criteria "..." [--in-scope "arquivo # motivo"]
Gate de Fase / Aceitação/Encerramentopython3 scripts/check_stage_gate.py ...python3 scripts/check_stage_gate.py ...--action start/close --stage "Sprint 2.1 Ajustes de Menu" (Admissão sob demanda, dependências anteriores verificadas automaticamente)
Despacho via Códigopython3 scripts/cli.py dispatch --task-id T00xx --format codexpython3 scripts/dispatch_task.pyVerificar dependências e concorrência, avançar para 【Em Andamento】, gerar parâmetros JSON que podem ser chamados diretamente pelas ferramentas do subagente Codex
Avançar Transição de Tarefapython3 scripts/transition_task.py ...python3 scripts/transition_task.py ...--task-id T00xx --role DEV --from-status Em Andamento --to-status Em Revisão --token <token> --summary "Descrição da alteração principal" --remarks "..." (Ao enviar para revisão, é obrigatório incluir --summary para registrar automaticamente o diff e o snapshot de credenciais)
Aceitação Final pelo Humanopython3 scripts/cli.py task accept ...python3 scripts/quick_task.py accept ...--task-id T00xx (Exclusivo para usuário humano, é estritamente proibido que o Agente assine em seu lugar)
Iniciar Kanbanpython3 scripts/cli.py kanbanpython3 scripts/start_kanban_server.pyIniciado por padrão em http://127.0.0.1:32886/
Inspeção de Saúdepython3 scripts/cli.py statuspython3 scripts/heartbeat.pyExibir saúde geral, cartões bloqueados e indicadores de eficiência (incluindo roaming cognitivo de subagentes e alertas acima de 600s)
Sincronização de Stack Técnico / Recálculo de Perfil-scripts/update_agent_tech_stacks.py--force-recalc para recalcular forçadamente o perfil de capacidade técnica do especialista e atualizar a exportação do Subagente, resolvendo problemas de perfil desatualizado após migração de stack
Verificação de Continuidadepython3 scripts/cli.py ccp ...python3 scripts/cli.py ccp ...--task-id T00xx --stage Em Revisão para verificar a continuidade do contexto
Diagrama de Visão Geral da Cadeiapython3 scripts/cli.py tracepython3 scripts/generate_trace_html.pyAnalisar offline o rastreamento da sessão, gerar em segundos um diagrama de visão geral da cadeia em HTML (0 Token)
Teste Incremental Inteligentepython3 scripts/cli.py testscripts/run_tests.pyDetectar automaticamente alterações no Git, executar apenas testes unitários relevantes (segundos), alterações de documentação são isentas automaticamente, --all para regressão completa

Matriz de Permissões de Escrita e Intervalo de Transição dos 8 Subagentes Especialistas

[!IMPORTANT] Regra de Isolamento Físico e Gate de Token de Despacho (Dispatch Token Gating):

  1. O Agente Principal (PM Gerente Yan) é estritamente proibido de se passar por desenvolvedor e escrever código de negócios na sessão principal! O host Codex deve usar ferramentas de subagente reais para despachar; outros hosts podem usar suas próprias ferramentas de subagente.
  2. Despacho via Código e Gate de Token: Ao despachar uma tarefa, o cli.py dispatch gera um dispatch_token exclusivo. Os papéis de desenvolvimento profissional (DEV/FRONTEND/REVIEWER/QA) devem incluir --token <token> ao fazer a transição. O state machine subjacente intercepta fortemente, eliminando a possibilidade de auto-representação falsa.

Contrato de Despacho Automático da Área de Trabalho Codex

Após o usuário autorizar explicitamente o início, o Agente Principal executa no diretório do projeto alvo python3 .agents/skills/fy-flow/scripts/dispatch_task.py --task-id <ID> --format codex. A saída padrão é um único objeto JSON, contendo tool, arguments, task_id e role; informações de diagnóstico vão para o erro padrão. O Agente Principal deve imediatamente passar arguments exatamente como parâmetros para uma chamada de ferramenta collaboration.spawn_agent real, aguardar o retorno do subagente e, em seguida, continuar a despachar os especialistas de revisão e teste com base no estado atual da tarefa. Não reescreva, copie ou reduza manualmente a mensagem de despacho; não imprima o JSON como se o despacho estivesse concluído, e não execute o trabalho do especialista como Agente Principal. Se o host Codex atual não tiver ferramentas de subagente, relate explicitamente a falta de capacidade do host, mantenha a tarefa no estado atual e não falsifique um recibo de especialista. Os especialistas já despachados executam apenas o exit_contract.required_cli na mensagem, não podem criar outro cartão ou iniciar. Como a autorização do usuário já cobre esta execução, após criar o cartão, pode-se continuar a despachar na mesma sessão; apenas quando a autorização de início ainda não foi recebida, a tarefa permanece em Aguardando Início.

Identificador do SubagenteNome do PapelResponsabilidade PrincipalIntervalo de Transição de Estado VálidoContrato de Saída
@flow-pmGerente Yan (Gerente de Projeto)Decomposição de requisitos, classificação de nível e criação de cartõesAguardando Início -> Em Andamento / Solicitando AceitaçãoParar no estado 【Aguardando Início】no cenário de criação de cartão, aguardando autorização de início; solicitar aceitação humana
@flow-architectArquiteto Qian (Arquiteto de Sistemas)Arquitetura geral do sistema, contrato de interface e seleção de tecnologiaAguardando Início -> Em Andamento -> ConcluídoProduzir ADR e documento de plano de arquitetura
@flow-devDesenvolvedor Li (Engenheiro de Desenvolvimento)Codificação principal de backend/full-stack e implementação de testes unitáriosAguardando Início -> Em Andamento -> Em RevisãoDeve executar testes unitários, gerar relatório de desenvolvimento, fornecer --summary ao enviar para revisão
@flow-frontendDesenvolvedor Frontend Ma (Engenheiro de Desenvolvimento Frontend)Implementação de componentes Web/UI e experiência frontendAguardando Início -> Em Andamento -> Em RevisãoVerificar renderização de componentes e interação, gerar relatório, fornecer --summary ao enviar para revisão
@flow-reviewerRevisor Zhou (Especialista em Revisão de Código)Padrões de código, varredura de segurança e gate de qualidadeEm Revisão -> Em Teste / Em Revisão -> Concluído (Credenciais Tier-3 frescas e sem desvio, dispensando QA) / Em Revisão -> DevolvidoVarredura estática sem alertas, produzir parecer de revisão
@flow-qaTestador Zhang (Engenheiro de Teste)Testes de integração direcionados e verificação de saída (executar apenas testes relacionados à tarefa atual, é estritamente proibido executar scripts completos)Em Teste -> Concluído / Em Teste -> DevolvidoEscrever casos de teste direcionados, registrar horas de trabalho reais
@flow-docsRedator Técnico Li Wentong (Engenheiro de Documentação)Governança de documentos de entrega e manual do usuárioAguardando Início -> Em Andamento -> ConcluídoSeguir a norma acadêmica e de engenharia GB/T 7713
@flow-devopsOperador Lü Gaite (Administrador de Operações)Mesclagem de branches, construção de release e proteção do histórico GitAguardando Início -> Em Andamento -> ConcluídoVerificar pipeline aprovado, resolver bloqueios de PR

Índice de Entidades Normativas Modulares (Consulte o arquivo de especificação específico conforme necessário)

Quando e somente quando entrar em um cenário de negócios específico, o Agente deve chamar view_file para consultar o arquivo Markdown da entidade correspondente:

Habilidades Relacionadas

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 Programação e Desenvolvimento skills