Modo de Fluxo de Trabalho Dinâmico
Use esta habilidade quando um agente de codificação puder gerar ou adaptar um harness local de tarefa em vez de seguir apenas um fluxo de comando estático. O objetivo é transformar o modo de fluxo de trabalho dinâmico em um sistema disciplinado: harnesses temporários para trabalho único, extração de habilidade compartilhada para trabalho repetido e checkpoints observáveis de painel de controle para equipes.
Quando Ativar
- O usuário menciona fluxos de trabalho dinâmicos, harnesses personalizados, harness-por-tarefa, fluxos de trabalho adaptativos ou o modo de fluxo de trabalho dinâmico do Claude Code.
- Uma tarefa precisa de um loop personalizado, avaliador, rastreador, gerador de fixtures, observador ou painel local.
- Múltiplos agentes precisam do mesmo processo repetível, mas o processo ainda não foi capturado como uma habilidade compartilhada.
- Um fluxo de trabalho precisa de artefatos de handoff duráveis, evidências de avaliação ou aprovação do operador antes do merge.
Contrato Central
O modo de fluxo de trabalho dinâmico deve produzir um harness local de tarefa apenas quando o harness for mais barato e seguro do que executar manualmente os mesmos passos. O harness deve ter:
- Objetivo: o resultado que ele possui e o resultado que ele explicitamente não possui.
- Entradas: arquivos, URLs, prompts, fontes de dados, política de credenciais e restrições fornecidas pelo usuário.
- Saídas: commits, relatórios, capturas de tela, arquivos de status ou instantâneos do painel de controle.
- Avaliação: pelo menos uma verificação de aprovação/reprovação vinculada à tarefa, não apenas "funcionou".
- Handoff: um artefato curto que informa ao próximo operador o que aconteceu, o que está bloqueado e como retomar.
Árvore de Decisão de Harness Dinâmico
- Tarefa única: mantenha inline. Não invente um harness.
- Tarefa repetida com entradas variáveis: crie um harness local de tarefa e mantenha-o sob uma área de trabalho temporária ou local do projeto.
- Tarefa repetida entre colegas ou repositórios: extraia o padrão para uma habilidade compartilhada.
- Tarefa com estado externo, filas ou aprovações: adicione visibilidade do painel de controle antes de adicionar mais automação.
- Tarefa com risco de segurança: adicione um portão de avaliação e um portão de merge humano antes da execução autônoma.
Modelo de Harness Local de Tarefa
Use esta estrutura antes de escrever código:
# Harness de Fluxo de Trabalho Dinâmico
Objetivo:
- Entregar:
- Não entregar:
Entradas:
- Repositório ou espaço de trabalho:
- Sistemas externos:
- Política de credenciais:
Loop:
1. Descobrir estado atual.
2. Gerar ou atualizar o menor artefato útil.
3. Executar verificações de avaliação.
4. Registrar status e handoff.
5. Parar em portão com falha, propriedade incerta ou ação externa insegura.
Avaliação:
- Comando:
- Sinal de aprovação esperado:
- Proprietário da falha:
Handoff:
- Status:
- Evidência:
- Próxima ação:
Extração de Habilidade Compartilhada
Promova um harness local de tarefa para uma habilidade compartilhada apenas quando pelo menos duas destas condições forem verdadeiras:
- O mesmo fluxo de trabalho aparece em múltiplas sessões, repositórios, equipes ou inicializações.
- O fluxo de trabalho precisa de sequenciamento específico de linguagem, ferramenta ou segurança.
- Falhas se repetem porque operadores pulam um portão ou perdem contexto.
- O fluxo de trabalho tem um contrato estável de entrada/saída.
- O fluxo de trabalho se beneficia de um painel de controle, quadro de status ou handoff de equipe.
Ao extrair, escreva primeiro a habilidade em skills/<nome>/SKILL.md. Adicione shims de comando apenas se uma superfície de entrada com barra ainda for necessária.
Checkpoints de Painel de Controle
O modo de fluxo de trabalho dinâmico torna-se utilizável pela equipe quando expõe estado. Registre estes checkpoints sempre que a tarefa abranger mais de uma sessão:
- Plano: objetivo, proprietário, critérios de aceitação e sistemas externos arriscados.
- Fila: itens de trabalho, função do agente atribuída, branch/worktree e arestas de dependência.
- Execução: harness ativo, passo atual do loop, resultado de avaliação recente e sinal de token/custo, se disponível.
- Portão: resultados de teste, capturas de tela do navegador, revisão de segurança e prontidão para merge.
- Handoff: o que está feito, o que falhou, o que precisa de uma decisão humana.
Se o repositório tiver o estado ECC2 habilitado, prefira adicionar ou ler checkpoints através do painel de controle ECC ou scripts baseados em armazenamento de estado, em vez de espalhar notas não rastreadas.
Portões de Avaliação
Cada harness dinâmico precisa de uma avaliação específica da tarefa. Escolha o portão confiável mais barato:
| Tipo de Trabalho | Portão de Avaliação |
|---|---|
| Funcionalidade de código | Teste focado, lint, cobertura e um caminho de integração |
| Interface do usuário/painel de controle | Teste de fumaça do navegador com captura de tela e verificações de overflow/erro |
| Fluxo de trabalho do agente | Transcrição de fixture ou item de trabalho semeado com roteamento esperado |
| Pesquisa/conteúdo | Resumo neutro de fonte, lista de verificação de reivindicações e esboço prontos para publicação |
| Integração | Comando de simulação (dry-run), validação de configuração e verificação de ausência de segredos |
Não afirme que um fluxo de trabalho dinâmico é reutilizável até que a avaliação possa ser executada novamente por outro colega.
Antipadrões
- Gerar scripts que escondem a lógica real de decisão do operador.
- Tratar o modo de fluxo de trabalho dinâmico como permissão para pular testes.
- Criar documentos descartáveis quando uma habilidade compartilhada ou artefato de status é o produto real.
- Executar múltiplos agentes sem propriedade, portão de merge ou política de conflito.
- Deixar dados brutos de pesquisa privada vazarem em documentos públicos.
Padrão de Saída
Finalize com:
- O caminho do harness ou habilidade.
- Os comandos de avaliação e resultados.
- O caminho do painel de controle ou artefato de handoff.
- O próximo candidato a extração reutilizável.