Communitygithub.com

2023Anita/harness-interview-workflow

Uma habilidade para Codex que transforma tarefas vagas em varreduras de pontos cegos, perguntas de entrevista, opções de rota e execução com portões de aprovação.

O que é harness-interview-workflow?

Esta habilidade para Codex foi projetada para desacelerar o agente antes de executar trabalhos caros ou arriscados. Ela pega uma solicitação vaga ou complexa do usuário e a transforma em um processo estruturado de entrevista: primeiro, descobre desconhecidos classificando a solicitação em tipos conhecidos/desconhecidos; depois, faz apenas as 1-3 perguntas de maior alavancagem, priorizando aquelas que podem alterar arquitetura, risco ou formato do entregável; em seguida, propõe 2-3 opções de rota com prós, contras e riscos; e só executa após aprovação explícita do usuário. A habilidade é útil para evitar que agentes de IA sigam caminhos errados ou caros sem verificar suposições, sendo suportada em plataformas como Codex (CLI da Anthropic). Seu funcionamento é guiado por um contrato operacional claro e inclui recursos como varredura de pontos cegos, modo de entrevista, tratamento de referências (como repositórios ou exemplos), proposta de rota e execução com portões de aprovação. Recomenda-se usá-la em conjunto com `codex-dynamic-workflows` para trabalhos amplos.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add 2023Anita/harness-interview-workflow

Perguntar na sua IA favorita

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

Documentação

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

  1. Reafirme o objetivo do usuário e o entregável provável.
  2. Faça uma varredura de pontos cegos antes de propor execução.
  3. Faça no máximo 1-3 perguntas por rodada.
  4. Priorize perguntas cujas respostas alteram arquitetura, risco, formato do entregável ou verificação.
  5. Ofereça 2-3 opções de rota quando houver contexto suficiente.
  6. Pare após o plano se o usuário pediu um plano ou ainda não aprovou a execução.
  7. 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.
  8. 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:

  1. Qual resposta mudaria a arquitetura ou a rota central?
  2. Qual resposta mudaria os limites de risco ou requisitos de aprovação?
  3. Qual resposta mudaria o formato final do artefato?
  4. Qual resposta mudaria a verificação ou os critérios de aceitação?
  5. 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.

Habilidades Relacionadas