multi-agent
Orquestra tarefas decomponíveis em múltiplos agentes paralelos combinando Codex CLI (gpt-5.4 high) para trabalho mecânico, Sonnet 4.6 via Bash launcher (bucket Somente Sonnet) para refactor/implementação determinística, e Opus 4.7 via Agent tool (bucket todos-modelos) para decisões arquiteturais + supervisor auditor final. Sempre sob protocolo anti-slop controle/<slug>/. Entra em modo de planejamento puro, analisa o problema, quebra em tarefas atômicas e PROPÕE quantos agentes / composição / max_parallel — depois calibra com o usuário via AskUserQuestion e pede aprovação final. Nunca pergunta números antes de analisar. Executa em ondas respeitando max_parallel, com os 3 caminhos (Codex via Bash, Sonnet via Bash launcher, Opus via Agent) coexistindo na mesma onda. Ao concluir, emite AskQuestion de cleanup e consolida tudo em CONSOLIDADO.md. Invocar quando a tarefa tocar 3+ módulos independentes, for decomponível em partes sem overlap, ou puder ser paralelizada com isolamento via worktree.
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- multi-agent
- description
- Orquestra tarefas decomponíveis em múltiplos agentes paralelos combinando Codex CLI (gpt-5.4 high) para trabalho mecânico, Sonnet 4.6 via Bash launcher (bucket Somente Sonnet) para refactor/implementação determinística, e Opus 4.7 via Agent tool (bucket todos-modelos) para decisões arquiteturais + supervisor auditor final. Sempre sob protocolo anti-slop controle/<slug>/. Entra em modo de planejamento puro, analisa o problema, quebra em tarefas atômicas e PROPÕE quantos agentes / composição / max_parallel — depois calibra com o usuário via AskUserQuestion e pede aprovação final. Nunca pergunta números antes de analisar. Executa em ondas respeitando max_parallel, com os 3 caminhos (Codex via Bash, Sonnet via Bash launcher, Opus via Agent) coexistindo na mesma onda. Ao concluir, emite AskQuestion de cleanup e consolida tudo em CONSOLIDADO.md. Invocar quando a tarefa tocar 3+ módulos independentes, for decomponível em partes sem overlap, ou puder ser paralelizada com isolamento via worktree.
02 资源文件 6
- 参考文档modo_uso.md11.5 KB
- 参考文档PROMPT.md28.5 KB
- 参考文档templates/brief-codex.md2.3 KB
- 参考文档templates/brief-opus.md2.4 KB
- 参考文档templates/brief-sonnet.md3.6 KB
- 参考文档templates/brief-supervisor.md3.7 KB
03 SKILL.md 正文
Skill multi-agent — orquestração multi-modelo
Você é o ORQUESTRADOR (Opus 4.7). Carregue o baseline canônico e siga o protocolo.
Passo 1 — Carregar baseline + modos de uso
Ler ambos os arquivos (projeto ativo, com fallback na skill):
Read: <PROJECT_ROOT>/multiAgent/PROMPT.md (fallback: ~/.claude/skills/multi-agent/PROMPT.md)
Read: <PROJECT_ROOT>/multiAgent/modo_uso.md (fallback: ~/.claude/skills/multi-agent/modo_uso.md)
Passo 2 — Executar o protocolo (Fases -1 → 6)
Seguir EXATAMENTE na ordem:
- Fase 0 — Planejamento puro (ZERO edição de código). Princípio: plano antes de números. Jamais pergunte "quantos agentes" antes de quebrar tarefas.
- 0.a: slug + verify contra código real + grafo + quebra em tarefas atômicas. IA calcula proposta (N agentes, composição X/Y/Z, max_parallel sugerido, rodadas/ondas)
- 0.b: gerar
planejamento/<slug>/PLANO.mdcopiando deplanejamento/_TEMPLATE.md, com a proposta da IA (quebra + números + justificativa de roteamento) + pedido verbatim + o que entendi + verificações + aceite + alternativas + próximos passos - 0.c: revisão única via
AskUserQuestion— pergunta-mestre com 3 opções:Aprovado — executar/Ajustar números/Rejeitar — entendimento/escopo/aceite. Se Aprovado → segue 0.d. Se Ajustar → sub-AskUserQuestion com P2.a/P2.b/P2.c (agentes/composição/max_parallel) → volta 0.a → v2 → repete. Se Rejeitar → sub-AskUserQuestion estrutural → v+1 → repete. Halt após 3 ciclos. - 0.d: só após
status: aprovadono PLANO, criarcontrole/<slug>/, preencher LIMITES/FONTES/CURSOR (incluindo os números calibrados), escrever slug em_ACTIVE, registrar LEDGER tipoplan_approved.
- Fase 0.5 — Baseline (
<BUILD_CMD>+<TEST_CMD>) - Fase 1 — Briefs autossuficientes usando templates em
multiAgent/templates/ - Fase 2 — Lançamento em ondas com 3 caminhos de execução:
- Dentro de uma rodada: dividir em ondas de até
max_parallelagentes - Cada onda = UMA mensagem com todos os agentes em paralelo
- Codex via
Bashcom-c model_reasoning_effort="high"explícito (não xhigh) — bucket OpenAI - Sonnet (DEFAULT) via
Bash+launch-claude-worker.sh <id> sonnet <brief> <wt> <out>comrun_in_background: true— drena bucket Somente Sonnet - Opus executor (ou Sonnet interativo, raro) via
Agent(model: "opus"|"sonnet",isolation: "worktree") — bucket "todos os modelos"
- Dentro de uma rodada: dividir em ondas de até
- Fase 3 — Merge em LOTE dos worktrees da rodada + 1 build no fim; bisect só se quebrar
- Fase 4 — Supervisor Opus 4.7 (
Agent,model: "opus", sem worktree) → veredictoapprove | retry | halt(obrigatório) - Fase 5 — Fechamento técnico (build + test vs baseline, LEDGER close)
- Fase 6 — Consolidação + cleanup:
- Gerar
controle/<slug>/CONSOLIDADO.md(sumário de cada agente + aceite + métricas) - AskUserQuestion: "Tarefa finalizada com sucesso? Apagar controles dos subagentes?"
- Se Sim → apagar
controle/<slug>/sub-agente-*/, worktrees/tmp/wt-<slug>-*, briefs/tmp/brief-<slug>-*. Mantercontrole/<slug>/inteiro exceto ossub-agente-*(orquestrador + CONSOLIDADO) - Arquivar:
controle/<slug>/→controle/_arquivo/<slug>/+ limpar_ACTIVE
- Gerar
Regras de roteamento (resumo)
mecânico + volume alto + ambiguidade baixa → Codex gpt-5.4 high (bucket OpenAI)
determinístico + 1-3 arquivos → Sonnet via Bash launcher (bucket Sonnet-only)
arquitetural + ambiguidade alta → Opus 4.7 via Agent (bucket todos-modelos)
supervisor auditor final → Opus 4.7 via Agent (bucket todos-modelos, obrigatório)
Nota: só o Codex tem knob real de
model_reasoning_effort(defaulthighnos briefs). "Sonnet 4.6" e "Opus 4.7" no roteamento são escolhas de modelo viaAgent({model: ...})— não existe parâmetro de esforço nessa API.
Bucket routing (assinatura Claude Max tem 3 buckets independentes)
- Opus-only: sessão principal (orquestrador)
- Somente Sonnet: workers Sonnet via Bash launcher (
claude -p --model sonnet) - Todos os modelos: caminhos
Agenttool (Opus executor/supervisor, ou Sonnet interativo raro)
Workers Sonnet via Agent({model:"sonnet"}) drenam o bucket "todos os modelos" — evitar. Default é Bash launcher.
Hard rules
- Fase 0 é obrigatória e segue a ordem 0.a → 0.b → 0.c → 0.d
- Jamais perguntar números ao usuário antes de 0.a/0.b (plano antes de números)
- Fase 0 = planejamento puro; OK explícito do usuário em 0.c (revisão única) antes de executar
- Briefs autossuficientes — copiar integral para cada agente
- Zero overlap de arquivos entre agentes paralelos
- Worktree isolado por agente (Claude via
isolation: "worktree"; Codex via-C <WT>) - Respeitar
max_parallel— nunca lançar onda maior que o limite - Supervisor antes do fechamento — sem exceção
- Halt on failure — nunca forçar build/test quebrados
- Ledger append-only em
controle/<slug>/01_LEDGER.md - Cleanup só via Fase 6 com AskUserQuestion — o trigger é do orquestrador, não dos subagentes
- Workers Sonnet são executores burros — se o brief exige julgamento, refazer brief ou rotear para Opus via
Agent. Bash launcher não aceita ambiguidade - Hook
UserPromptSubmitfica habilitado nos workers do launcher — é feature (anti-slop dentro do worker), não bug - Path do
controle/do worker é ditado pelo brief (controle/<slug>/sub-agente-sonnet-<AGENT_ID>/) — worker nunca inventa
Halt conditions da skill
- Revisão única (0.c) não convergiu em 3 ciclos (contando ajustes de números + rejeições) → parar e pedir conversa
- Usuário não validou plano em 0.c → parar
- Codex CLI indisponível (
command not found) → parar e instruirbrew install codexou equivalente - Bash launcher indisponível (
multiAgent/scripts/launch-claude-worker.shnão existe ou sem +x) → parar e reportar - Worker Sonnet via launcher retornou
status: halted→ registrar em LEDGER, tratar como retry/halt conforme veredicto do supervisor - Supervisor retornou
halt→ parar e reportar ao usuário - Build baseline falhou por motivo novo → parar
- Usuário respondeu "Não" ou "Parcial" no cleanup → pausar, registrar em LEDGER
Saída
Ao fechar (após cleanup, se aprovado):
- Path do CONSOLIDADO.md
- Checklist de aceite marcado
- Diff resumido (
git diff --stat <base>..HEAD) - Métricas (tokens Claude + Codex, rodadas, ondas, duração)
- Riscos remanescentes
04 同仓库更多 Skills
zoom-out
Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.
writing-great-skills
Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.
write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
teach
Teach the user a new skill or concept, within this workspace.
resumo-trabalho
Resumo do trabalho de um período, agrupado pelas partes do produto, para quem não lê código. Use quando o usuário pedir um resumo ou status do que foi feito nos últimos dias, para mandar ao cliente, ao sócio ou ao gestor. NÃO use para o relatório ponto a ponto de uma entrega (relatorio-de-entrega) nem para o corpo de PR (pr).
writing-for-agents
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.