Fluxo de Trabalho de Entrevista Harness
Visão Geral
Use esta habilidade para desacelerar o Codex antes de trabalhos caros. A habilidade transforma uma solicitação vaga ou complexa em uma entrevista estruturada: descubra desconhecidos, faça apenas as perguntas de maior alavancagem, proponha rotas e aguarde aprovação explícita antes da execução.
Contrato Operacional
- Reafirme o objetivo do usuário e o entregável provável.
- Faça uma varredura de pontos cegos antes de propor execução.
- Faça no máximo 1-3 perguntas por rodada.
- Priorize perguntas cujas respostas alteram arquitetura, risco, formato do entregável ou verificação.
- Ofereça 2-3 opções de rota quando houver contexto suficiente.
- Pare após o plano se o usuário pediu um plano ou ainda não aprovou a execução.
- Se o usuário confirmar a execução, crie um plano de implementação normal e use portões de aprovação para ações arriscadas.
- Mantenha notas de implementação quando a execução revelar casos extremos ou desvios.
Varredura de Pontos Cegos
Classifique a solicitação em quatro tipos de desconhecidos:
Conhecidos conhecidos:
Desconhecidos conhecidos:
Conhecidos desconhecidos:
Desconhecidos desconhecidos:
Mal-entendido de maior risco:
Próximo menor passo:
Use português claro por padrão ao trabalhar com Anita, a menos que o usuário peça o contrário.
Modo de Entrevista
Faça apenas as próximas 1-3 perguntas. Prefira esta ordem:
- Qual resposta mudaria a arquitetura ou a rota central?
- Qual resposta mudaria os limites de risco ou requisitos de aprovação?
- Qual resposta mudaria o formato final do artefato?
- Qual resposta mudaria a verificação ou os critérios de aceitação?
- Qual resposta afeta apenas o estilo?
Evite formulários longos. Se uma pergunta for opcional, continue com uma suposição conservadora e rotule-a.
Tratamento de Referências
Quando o usuário fornecer um artigo, repositório, captura de tela, código, projeto antigo, template ou exemplo, classifique a referência antes de usá-la:
deve reutilizar: preserve estrutura, semântica, nomes ou conteúdo.referência de estilo: tome emprestado a sensação ou padrão, não copie.não imitar: use apenas para entender restrições.fonte de fato: cite ou preserve a proveniência factual quando necessário.
Se a classificação não estiver clara, faça uma pergunta curta de esclarecimento.
Proposta de Rota
Após contexto suficiente, forneça opções como:
Opção A: Versão Mínima Viável
Adequado para:
Fará:
Não fará:
Risco:
Verificação:
Opção B: Versão Completa e Segura
Adequado para:
Fará:
Não fará:
Risco:
Verificação:
Opção C: Versão de Alta Qualidade Estendida (opcional)
Adequado para:
Fará:
Não fará:
Risco:
Verificação:
Recomendação:
Aguardando confirmação do usuário:
Não execute até que o usuário escolha uma rota ou diga uma confirmação clara como confirmar execução, continuar ou executar conforme recomendação.
Execução Após Aprovação
Quando o usuário confirmar a execução, use este formato de plano:
Objetivo:
Critérios de sucesso:
Contexto atual:
Restrições:
Riscos:
Aprovação necessária:
Caminho do artefato do fluxo de trabalho:
Pacotes de trabalho:
Política de integração:
Verificação:
Artefatos reutilizáveis:
Para trabalhos complexos ou reutilizáveis, crie um artefato de fluxo de trabalho:
.workflow/<slug>/
|-- plan.md
|-- state.json
|-- orchestration.md
|-- packets/
|-- results/
`-- final-report.md
Se codex-dynamic-workflows estiver disponível e o trabalho for amplo, use-o em conjunto com esta habilidade.
Notas de Implementação
Para tarefas de execução, mantenha notas no local natural da tarefa, geralmente implementation-notes.md ou .workflow/<slug>/results/implementation-notes.md:
# Notas de Implementação
## Plano Original
## Decisões
## Desvios
## Casos Extremos
## Confirmações do Usuário
## Verificação
## Acompanhamento
Quando um caso extremo forçar um desvio, escolha um caminho conservador, registre o motivo e continue apenas se permanecer dentro do limite de aprovação do usuário.
Resposta Final
Para trabalho apenas de plano, retorne:
- resumo da varredura de pontos cegos
- perguntas feitas ou suposições assumidas
- opções de rota
- rota recomendada
- pergunta clara de aprovação
Para trabalho executado, retorne:
- artefatos concluídos e caminhos
- evidência de verificação
- verificações ignoradas
- riscos restantes
- como reutilizar o fluxo de trabalho
Para alterações complexas, adicione um pequeno questionário pós-ação para que o usuário possa confirmar que entendeu o que mudou.