Communitygithub.com

curiositech/windags-skills

Padrões de conversação e protocolos de interação para sistemas multiagente. Aborda requisição/resposta, pub/sub, quadro-negro, cadeias de delegação, debate, crítica, consenso, fan-out/fan-in, supervisor-trabalhador e negociação entre pares. Análise aprofundada dos padrões de conversação do AutoGen, delegação do CrewAI, passagem de estado do LangGraph e performativos FIPA-ACL. Ensina como projetar o que os agentes dizem uns aos outros e em que ordem.

O que é windags-skills?

Este skill, 'Agent Conversation Protocols' (Protocolos de Conversação de Agentes), capacita você a projetar sistemas multiagente onde a comunicação é coerente e eficiente, ao invés de caótica. Ele fornece uma árvore de decisão para selecionar o padrão de conversação ideal (como fan-out/fan-in, supervisor-trabalhador, debate, consenso ou quadro-negro) com base nas características do problema, como divisibilidade da tarefa, necessidade de qualidade versus velocidade e interdependências. Além disso, o skill aborda modos de falha comuns, como loops infinitos de delegação (ping-pong) e gargalos do supervisor, oferecendo detecção e correções práticas. Inclui exemplos práticos de sistemas de revisão de código e escrita de artigos de pesquisa, mostrando como aplicar a teoria em cenários reais. O skill é compatível com plataformas como AutoGen, CrewAI e LangGraph, ensinando os conceitos abstratos de design de conversação que podem ser implementados em qualquer framework.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/curiositech/windags-skills/tree/HEAD/skills/agent-conversation-protocols

Perguntar na sua IA favorita

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

Documentação

Protocolos de Conversação de Agentes

Você é um especialista em design de conversação multiagente. Você entende como os agentes conversam entre si -- os tipos de mensagem, regras de tomada de turno, padrões de delegação e mecanismos de resolução de conflitos que tornam os sistemas multiagente coerentes em vez de caóticos.

PONTOS DE DECISÃO

Árvore de Seleção de Padrão Primário

Dadas as características do problema:

├── A tarefa é decomponível em subtarefas independentes?
│   ├── SIM + Qualidade é mais importante que velocidade
│   │   └── Use FAN-OUT/FAN-IN com execução redundante (3+ agentes mesma tarefa)
│   ├── SIM + Velocidade é mais importante que qualidade
│   │   └── Use FAN-OUT/FAN-IN com execução particionada (dividir trabalho)
│   └── NÃO + A tarefa requer dependências sequenciais
│       └── Use SUPERVISOR-TRABALHADOR com cadeias de delegação
│
├── Existem múltiplas abordagens válidas?
│   ├── SIM + Existe verdade fundamental verificável
│   │   └── Use DEBATE (refinamento adversarial com juiz)
│   ├── SIM + Decisão de preferência subjetiva
│   │   └── Use VOTAÇÃO/CONSENSO (seleção democrática)
│   └── NÃO + Abordagem única, mas precisa de refinamento
│       └── Use CRÍTICA-REFINAMENTO (melhoria iterativa)
│
├── Síntese de conhecimento de fontes diversas?
│   └── Use QUADRO-NEGRO (acumulação de estado compartilhado)
│
└── Delegação de capacidade simples?
    └── Use REQUISIÇÃO/RESPOSTA (handoff síncrono)

Matriz de Decisão: Topologia × Iniciativa × Ordem de Turno

TopologiaIniciativaOrdem de TurnoQuando UsarExemplo
EstrelaPushRound-robinLíder claro coordena o trabalhoProcesso hierárquico do CrewAI
EstrelaPullFila de prioridadeTrabalhadores solicitam tarefas quando prontosGroupChat do AutoGen com gerente
MalhaPushLivreColaboração entre pares, sem gargalosDebate multiagente
ÁrvorePushProfundidade-primeiroDecomposição hierárquicaCadeias de delegação complexas
DifusãoReativoOrientado a eventosCompartilhamento de conhecimento, atualizaçõesAtualizações de estado do LangGraph

Seleção de Condição de Término

Se o tipo de conversação é:
├── DEBATE → Pare quando confiança_do_juiz > 0.8 OU rodadas >= 3
├── CRÍTICA → Pare quando veredito == 'aprovar' OU iterações >= 4
├── VOTAÇÃO → Pare quando todos os votos coletados OU timeout
├── FAN-OUT → Pare quando política_de_coleta satisfeita (todos/maioria/primeiro)
├── SUPERVISOR → Pare quando todas as subtarefas concluídas OU orçamento excedido
└── QUADRO-NEGRO → Pare quando condição_do_objetivo atingida OU desatualização detectada

MODOS DE FALHA

1. Ping-Pong de Delegação

Detecção: Agente A delega para B, B delega de volta para A, criando loops infinitos Sintomas: Contagens de mensagens crescendo exponencialmente, mesmas tarefas repetidas infinitamente Causa Raiz: Nenhuma detecção de ciclo nas cadeias de delegação, trabalhadores podem delegar para cima Correção: Implementar restrições de delegação com rastreamento de cadeia e bloqueios de delegação ascendente

2. Colapso por Bajulação

Detecção: Em debates, todos os agentes convergem para a mesma posição na rodada 2, independentemente das evidências Sintomas: Nenhuma mudança de posição após a rodada inicial, concordância unânime em tópicos complexos Causa Raiz: Agentes otimizam para concordância em vez de busca pela verdade Correção: Atribuir papéis adversariais explícitos, exigir que os agentes defendam perspectivas atribuídas

3. Gargalo do Supervisor

Detecção: Toda coordenação flui através de um único supervisor, alta latência em tarefas paralelas Sintomas: Trabalhadores ociosos aguardando respostas do supervisor, escalonamento linear em trabalho paralelizável Causa Raiz: Supervisor atua como roteador de mensagens em vez de sintetizador Correção: Reestruturar como fan-out/fan-in ou permitir comunicação direta entre trabalhadores

4. Explosão de Estado do Quadro-Negro

Detecção: Estado compartilhado cresce sem limites, agentes desperdiçam tokens lendo entradas irrelevantes Sintomas: Tempos de resposta de consulta aumentando com o tempo, alto uso de tokens em leituras Causa Raiz: Nenhuma coleta de lixo ou filtragem de relevância nas entradas do quadro-negro Correção: Implementar expiração baseada em confiança e filtragem semântica nas leituras

5. Cascata de Degradação de Contexto

Detecção: Cadeias de delegação profundas (>3 níveis) perdem contexto essencial a cada salto Sintomas: Trabalhadores fazem perguntas de esclarecimento, a qualidade da saída diminui com a profundidade da cadeia Causa Raiz: Artefatos de compressão de contexto se acumulam nos saltos de delegação Correção: Aplainar a hierarquia para no máximo 2 níveis ou passar contexto completo para todos os trabalhadores

EXEMPLOS PRÁTICOS

Exemplo 1: Projeto de Sistema de Revisão de Código

Problema: Projetar protocolo de conversação para revisão de código com 4 agentes (autor, revisor de segurança, revisor de desempenho, revisor de estilo)

Processo de Decisão:

  1. Seleção de Padrão: Saída com qualidade crítica → CRÍTICA-REFINAMENTO + múltiplas perspectivas → Híbrido de DEBATE
  2. Análise de Topologia: 4 revisores precisam ver o mesmo código → Topologia estrela com autor como hub
  3. Ordem de Turno: Segurança deve executar primeiro (bloqueante), depois desempenho e estilo em paralelo

Protocolo Escolhido:

Fase 1: Autor submete código inicial (REQUISIÇÃO/RESPOSTA)
Fase 2: Revisão de segurança (CRÍTICA-REFINAMENTO, bloqueante)
Fase 3: Revisões de Desempenho + Estilo (FAN-OUT/FAN-IN, paralelas)
Fase 4: Resolução de conflitos se houver sobreposição de problemas (DEBATE)
Fase 5: Autor incorpora feedback (CRÍTICA-REFINAMENTO)

Matriz de Compensação de Padrões:

  • Cadeia CRÍTICA pura: Muito lenta (revisões sequenciais)
  • DEBATE puro: Problemas de segurança são debatidos e rejeitados pela maioria
  • FAN-OUT puro: Sem bloqueio para falhas de segurança
  • Híbrido: Segurança primeiro, depois paralelo, depois resolver conflitos

Exemplo 2: Escrita de Artigo de Pesquisa

Problema: 3 agentes (pesquisador, escritor, verificador de fatos) produzem revisão de literatura

Processo de Decisão:

  1. Tipo de Iniciativa: Baseado em pull (agentes trabalham quando prontos) vs baseado em push (coordenador atribui)
  2. Qualidade vs Velocidade: Qualidade crítica → redundância necessária
  3. Decomposição: Tópico pode ser particionado por área de pesquisa

Protocolo Escolhido:

pesquisador: FAN-OUT particionado entre áreas de pesquisa
verificador_de_fatos: CRÍTICA-REFINAMENTO em cada seção
entregador: Papel de SUPERVISOR sintetizando todas as entradas

Por que não alternativas:

  • Todos os agentes em um único DEBATE: Sem papéis claros, experiência do escritor desperdiçada na verificação de fatos
  • Cadeia sequencial de REQUISIÇÃO/RESPOSTA: Muito lenta, sem pesquisa paralela
  • QUADRO-NEGRO puro: Sem síntese, apenas acúmulo de conhecimento

Lógica de Término:

Pare quando:
- Todas as áreas de pesquisa cobertas (verificação de completude)
- Confiança do verificador de fatos > 0.85 em todas as seções
- Escritor produz síntese coerente
- Total de tokens < orçamento OU tempo < prazo

Exemplo 3: Decisão de Roteamento Dinâmico

Problema: Durante a execução, o supervisor percebe que 3 trabalhadores estão sobrecarregados, 1 trabalhador está ocioso

Árvore de Decisão em Tempo Real:

Estado atual: 3 trabalhadores com 90% de capacidade, 1 trabalhador com 10%
Opções:
1. Reequilibrar trabalho (migrar tarefas para trabalhador ocioso)
2. Adicionar redundância (execução paralela no caminho crítico)
3. Mudar topologia (trocar de estrela para malha para delegação entre pares)

Fatores de decisão:
├── Tempo restante? < 25% → Opção 2 (paralelo, aceitar custo mais alto)
├── Orçamento restante? < 50% → Opção 1 (reequilibrar, otimizar custo)
└── Dependências de tarefa? Alto acoplamento → Opção 3 (topologia malha)

Execução: Supervisor detecta estado, transmite mensagem de mudança de topologia, trabalhadores atualizam suas regras de delegação, trabalho continua com novo padrão

GATES DE QUALIDADE

  • Política de Término Definida: Toda conversação tem limites explícitos de número máximo de mensagens, tempo e custo
  • Detecção de Ciclo Ativa: Cadeias de delegação rastreiam histórico do agente e previnem loops A→B→A
  • Pontuações de Confiança Presentes: Todas as saídas incluem confiança do agente (0.0-1.0) para avaliação de qualidade
  • Relatório de Progresso Conectado: Tarefas de longa duração enviam mensagens de batimento cardíaco periódicas ao coordenador
  • Handoff de Contexto Validado: Cada delegação inclui estimativas de token e identifica seções de contexto descartáveis
  • Propagação de Erro Projetada: Sistema lida com falhas de agente único sem colapso total da conversação
  • Política de Coleta Explícita: Operações fan-out especificam condições de espera (todos/maioria/primeiro/quórum)
  • Diversidade de Papéis Garantida: Protocolos de debate atribuem perspectivas distintas, não genéricas "discutir este tópico"
  • Expiração de Estado Configurada: Entradas do quadro-negro têm TTL ou limites de confiança para limpeza automática
  • Topologia Corresponde à Tarefa: Estrutura da conversação se alinha com a decomposição do problema (veja árvore de decisão)

LIMITES NÃO-INCLUSOS

Este skill cobre design de conversação, NÃO:

  • Formatos de serialização (esquemas JSON, codificação de mensagens) → Use agent-interchange-formats
  • Configuração de infraestrutura (filas de mensagens, descoberta de serviço) → Use agentic-infrastructure-2026
  • Uso de ferramentas por agente único (chamada de função, cadeia de pensamento) → Use agentic-patterns
  • Persistência de memória (armazenamentos vetoriais, recall episódico) → Use episodic-memory-algorithms
  • Seleção de framework (AutoGen vs LangGraph vs CrewAI) → Use agentic-infrastructure-2026

Delegue para outros skills quando encontrar:

  • Design de protocolo de comunicação → agent-interchange-formats
  • Otimização de desempenho → agentic-infrastructure-2026
  • Raciocínio de agente individual → agentic-patterns
  • Memória de longo prazo → episodic-memory-algorithms
  • Integração de ferramentas → agentic-patterns

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

curiositech/windags-skills

Expert in 2000s-era music visualization (Milkdrop, AVS, Geiss) and modern WebGL implementations. Specializes in Butterchurn integration, Web Audio API AnalyserNode FFT data, GLSL shaders for audio-reactive visuals, and psychedelic generative art. Activate on "Milkdrop", "music visualization", "WebGL visualizer", "Butterchurn", "audio reactive", "FFT visualization", "spectrum analyzer". NOT for simple bar charts/waveforms (use basic canvas), video editing, or non-audio visuals.

curiositech/windags-skills

Expert legal research agent for finding and scraping expungement data state by state. Knows authoritative sources, URL patterns, Firecrawl configuration, and 2026 legal landscape.

curiositech/windags-skills

Expert in 3D computer vision labeling tools, workflows, and AI-assisted annotation for LiDAR, point clouds, and sensor fusion. Covers SAM4D/Point-SAM, human-in-the-loop architectures, and vertical-specific training strategies. Activate on '3D labeling', 'point cloud annotation', 'LiDAR labeling', 'SAM 3D', 'SAM4D', 'sensor fusion annotation', '3D bounding box', 'semantic segmentation point cloud'. NOT for 2D image labeling (use clip-aware-embeddings), general ML training (use ml-engineer), video annotation without 3D (use computer-vision-pipeline), or VLM prompt engineering (use prompt-engineer).

curiositech/windags-skills

Implement WCAG 2.2 AA/AAA compliance with automated testing, keyboard navigation, screen reader support, and focus management. Activate on: accessibility audit, WCAG compliance, keyboard navigation, screen reader, aria attributes, axe-core, focus trap. NOT for: design-level accessibility review (use design-accessibility-auditor), color contrast only (use css-in-js-architect).

curiositech/windags-skills

Time-blind friendly planning, executive function support, and daily structure for ADHD brains. Specializes in realistic time estimation, dopamine-aware task design, and building systems that actually work for neurodivergent minds.

curiositech/windags-skills

Designs digital experiences for ADHD brains using neuroscience research and UX principles. Expert in reducing cognitive load, time blindness solutions, dopamine-driven engagement, and compassionate design patterns. Activate on 'ADHD design', 'cognitive load', 'accessibility', 'neurodivergent UX', 'time blindness', 'dopamine-driven', 'executive function'. NOT for general accessibility (WCAG only), neurotypical UX design, or simple UI styling without ADHD context.

curiositech/windags-skills

>- Apply crisis decision-making research to agent routing, uncertainty triage, and coordination failure analysis in time-pressured systems. Use when diagnosing handoff failures, analytical paralysis, or expert judgment under incomplete information. NOT for routine coding, simple CRUD design, or static single-agent tasks with complete information.

curiositech/windags-skills

Extend and modify the admin dashboard, developer portal, and operations console. Use when adding new admin tabs, metrics, monitoring features, or internal tools. Activates for dashboard development, analytics, user management, and internal tooling.

curiositech/windags-skills

Meta-agent for creating new custom agents, skills, and MCP integrations. Expert in agent design, MCP development, skill architecture, and rapid prototyping. Activate on 'create agent', 'new skill', 'MCP server', 'custom tool', 'agent design'. NOT for using existing agents (invoke them directly), general coding (use language-specific skills), or infrastructure setup (use deployment-engineer).

curiositech/windags-skills

AI-powered calendar management and agent-based scheduling coordination. Covers calendar APIs (Google Calendar, CalDAV/iCal), AI scheduling assistants (Reclaim, Clockwise, Motion, Cal.com), building custom calendar agents with MCP, multi-calendar merging, timezone management, focus block protection, meeting fatigue detection, and agent-to-agent meeting negotiation protocols. Activate on: "calendar agent", "AI scheduling", "calendar coordination", "meeting scheduling", "calendar API", "focus time protection", "calendar optimization", "Google Calendar MCP", "Reclaim", "Clockwise", "Motion", "Cal.com", "smart scheduling", "calendar-aware agent", "timezone scheduling", "agent negotiation meetings". NOT for: manual calendar UI component design (use form-validation-architect), project management scheduling or Gantt charts (use project-management-guru-adhd), general time-tracking or pomodoro apps (use adhd-daily-planner for time-awareness), building the agent itself from scratch (use agent-creator).

curiositech/windags-skills

Build and adopt production AI agent infrastructure in 2026. Covers framework selection (LangGraph, CrewAI, AutoGen, MCP), orchestration patterns, evaluation, observability, memory systems, and tool use. Also covers the SOCIAL dimension: how to sell agent infrastructure internally, change management, measuring ROI, building trust in autonomous systems, and scaling adoption across teams. Activate on: "agent infrastructure", "agent framework comparison", "which agent framework", "sell AI tools internally", "agent adoption", "agent observability", "agent evaluation", "MCP architecture", "agentic mesh", "enterprise AI agents", "AI change management", "agent ROI". NOT for: building specific agents (use ai-engineer), designing agent behavior patterns (use agentic-patterns), prompt tuning (use prompt-engineer).

curiositech/windags-skills

Fundamental patterns for effective agentic behavior. Teaches decomposition, tool orchestration, error recovery, context management, quality self-assessment, and knowing when to stop. Model-agnostic principles that make any agent more effective regardless of domain. Activate on: "how should I structure this agent", "agentic workflow", "agent patterns", "multi-step task", "tool orchestration", "/agentic-patterns", "decompose this", "agent best practices", "chain of actions", "when should the agent stop", "agent loop design". NOT for: creating agent infrastructure (use agent-creator), building DAGs (use windags-architect), specific tool implementation.

curiositech/windags-skills

Automated discovery and matching of agent skills for dynamic task routing and capability assessment

curiositech/windags-skills

Cryptographic security for agentic systems — zero-trust agent networking, signed message envelopes (JWS/JWE), capability-based security (ocaps), Merkle tree audit trails, WASM sandboxing, and formal verification. Covers CLI dev tool security, mTLS between agents, permission boundaries (least privilege for AI agents), and supply chain security for skills/plugins. Activate on: "agent security", "zero trust agents", "secure agent communication", "capability-based security", "ocap", "signed messages between agents", "agent audit trail", "sandbox agent execution", "agent permissions", "mTLS agents", "cryptographic verification", "agent supply chain", "OWASP agentic", "prove agent did X", "tamper-proof agent logs". NOT for: application-level SAST scanning (use security-auditor), network firewall rules (use infrastructure), SOC2/HIPAA compliance (organizational), or prompt injection defense (use prompt-engineer).

curiositech/windags-skills

Data structures and serialization formats for agent-to-agent communication. Covers message envelopes, structured output schemas, capability declarations, task handoff payloads, error/retry signaling, and context windows as data structures. Deep comparison of A2A protocol, MCP, OpenAI function calling, and LangChain message types. Teaches when to use rigid schemas vs free-form with validation, typed vs untyped, streaming vs batch. Activate on: "agent message format", "agent communication schema", "agent-to-agent protocol", "A2A protocol", "MCP message format", "structured output for agents", "agent interop", "interchange format", "agent serialization", "task handoff format", "capability declaration". NOT for: what agents say to each other (use agent-conversation-protocols), orchestration topology (use multi-agent-coordination), building agent infrastructure (use agentic-infrastructure-2026).

curiositech/windags-skills

Logic-based agent programming language implementing BDI architecture for practical autonomous agent development

curiositech/windags-skills

>- Design AgentSpeak(L)-style BDI agents with context-guarded plans, selection functions, and intention stacks. Use for interruptible autonomy, agent policy, and multi-agent orchestration in dynamic environments. NOT for simple rule engines, static planners, or centralized workflows.

curiositech/windags-skills

Foundational concurrent computation model where actors communicate exclusively through asynchronous message passing

curiositech/windags-skills

Build production-ready LLM applications, advanced RAG systems, and intelligent agents. Implements vector search, multimodal AI, agent orchestration, and enterprise AI integrations. Use PROACTIVELY for LLM features, chatbots, AI agents, or AI-powered applications.

curiositech/windags-skills

license: Apache-2.0 NOT for unrelated tasks outside this domain.

Habilidades Relacionadas