Pacotes de tarefas de IA: melhores instruções e critérios de aceitação

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 pacote | Exemplo do laboratório | Verificação |
|---|---|---|
| Resultado | Adicionar --status ao relatório | Os dois valores aceitos funcionam |
| Fonte | docs/requirements.md, revisão 1 | O código corresponde aos valores aprovados |
| Escopo | Somente programa e testes | O diff não contém outros arquivos |
| Restrições | Manter a saída padrão e os dados de exemplo | A saída-base continua Total tasks: 4 |
| Evidência | Comando de teste e execuções manuais | As saídas correspondem às contagens esperadas |
| Parada | Não fazer commit nem push | O 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
- 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.
- 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 .


