Table of Contents

Voltar ao curso prático de fluxos de trabalho com IA

Uma boa instrução descreve o trabalho e como você avaliará o resultado. Mais palavras não corrigem a falta de escopo. Esta lição transforma um pedido vago em um pacote de tarefas para o laboratório do curso.

Objetivo de aprendizagem: você escreverá um pacote de tarefas delimitado, com fonte, escopo de arquivos, verificações e condição de parada.

Principais pontos

  • Resultado nomeia o artefato ou comportamento desejado.
  • Escopo nomeia os arquivos permitidos e as ações excluídas.
  • Fonte identifica o requisito aprovado.
  • Critérios de aceitação tornam o sucesso observável.
  • Condições de parada evitam suposições e trabalho posterior sem autorização.

Antes de começar

Pré-requisitos: o laboratório extraído, o arquivo docs/requirements.md e a lição sobre o contexto do repositório . Reserve 30 minutos. O nível é iniciante. O exercício termina com um pacote escrito. Ainda não é preciso editar código.

Compare dois pedidos

Pedido vago: “Melhore o script de tarefas.” Um agente poderia reescrever a saída, adicionar dependências, editar dados de exemplo ou pular testes. O pedido não determina nenhuma dessas escolhas.

Pedido delimitado: “Adicione um filtro de status opcional a task_report.py usando a revisão 1 de docs/requirements.md. Mantenha a saída padrão. Adicione testes. Não altere dados de exemplo. Pare antes do commit.” O agente ainda escolhe os detalhes de implementação, enquanto a tarefa define o que significa sucesso.

Parte do pacoteExemplo do laboratórioVerificação
ResultadoAdicionar --status ao relatórioOs dois valores aceitos funcionam
Fontedocs/requirements.md, revisão 1O código corresponde aos valores aprovados
EscopoSomente programa e testesO diff não contém outros arquivos
RestriçõesManter a saída padrão e os dados de exemploA saída-base continua Total tasks: 4
EvidênciaComando de teste e execuções manuaisAs saídas correspondem às contagens esperadas
ParadaNão fazer commit nem pushO histórico do Git e o repositório remoto não mudam

Use um modelo reutilizável

Copie este modelo para uma pequena tarefa de programação ou pesquisa. Exclua campos sem relação com a tarefa em vez de preenchê-los com texto vago.

Outcome:
Authoritative source and revision:
Relevant files or records:
Allowed changes:
Excluded changes and actions:
Examples of desired behavior:
Completion checks:
Stop or ask when:
Report back with:

Para o laboratório, o pacote preenchido fica assim:

Outcome: Add an optional --status filter to task_report.py.
Source: docs/requirements.md, revision 1.
Relevant files: task_report.py, tasks.json, tests/.
Allowed changes: task_report.py and focused tests.
Excluded: tasks.json, new dependencies, commits, pushes.
Examples: no filter prints Total tasks: 4. Open and done each print 2.
Checks: run unit tests and four manual commands: no filter, open, done, and invalid.
The invalid value must exit nonzero with a clear error.
Stop or ask: source conflict, missing file, unrelated failing baseline.
Report: changed files, commands, observed outputs, unresolved issues.

No Windows, use py -3 nos comandos do pacote se o seu ambiente usar o inicializador Python.

O pacote não prescreve cada linha de código. Ele deixa o agente escolher uma implementação pequena e mantém o resultado verificável.

Acrescente exemplos com cuidado

Um exemplo preciso elimina ambiguidades. Os exemplos open e done especificam a saída para o arquivo fornecido com quatro tarefas. Eles não estabelecem uma regra geral para todos os arquivos. Em outro arquivo, as contagens dependem dos registros.

Separe o esperado do observado. Antes de executar o programa, Total tasks: 2 é o resultado esperado para cada status. Depois da execução, a saída do terminal é uma observação. Se os valores divergirem, examine os dados e a implementação antes de declarar sucesso.

Pratique uma condição de parada

Suponha que o arquivo de requisitos esteja ausente. O pacote o nomeia como fonte aprovada. Pare e solicite o requisito em vez de inferir os valores aceitos de um chat antigo ou de uma tarefa de exemplo.

Suponha que os testes-base falhem antes da edição. Registre a falha e pergunte se deve corrigir primeiro o estado inicial. Uma execução posterior bem-sucedida não mostra se a diferença veio do filtro ou do estado de partida.

Suponha que o agente queira fazer um commit. O pacote exclui commits. Peça que ele pare após o diff e os testes. Você decide se um commit posterior se encaixa no fluxo do projeto.

Confira o pacote

Dê um ponto por resposta: o resultado é concreto? A fonte que rege o trabalho está nomeada? O escopo dos arquivos está claro? Há pelo menos duas verificações observáveis? Existe uma condição de parada? Uma pontuação abaixo de cinco indica que o pacote precisa de revisão antes da delegação.

Seu resultado: salve o pacote final e uma explicação de uma linha para uma condição de parada. Entregue-o a um agente de programação na próxima lição prática ou responda manualmente aos resultados esperados no roteiro de estudos.

Verifique o entendimento

  1. Pergunta: o que torna um pacote de tarefas verificável? Resposta: Uma fonte, arquivos permitidos, verificações observáveis e uma condição de parada.
  2. Pergunta: o que um agente deve fazer quando a fonte não traz um detalhe necessário? Resposta: Parar e informar o detalhe ausente em vez de inventá-lo.

Solução de problemas

  • O agente altera demais: nomeie os arquivos e as ações excluídas no pacote.
  • O agente faz muitas perguntas: forneça a fonte ausente ou um exemplo concreto.
  • O agente declara sucesso cedo demais: peça as saídas observadas dos comandos e inspecione os arquivos.
  • O pacote fica longo demais: substitua o conteúdo copiado da fonte pelo caminho e pela revisão.

Próximos passos

Continue com Sua primeira tarefa com um agente de programação . Use o pacote para orientar uma pequena alteração no laboratório.

Navegação do curso: Anterior: Contexto do repositório , Programa do curso .