O que Seu Engenheiro de Prompt faz?

Visão Geral

Transforma uma solicitação informal do usuário em um prompt de delegação preciso, seleciona o modo de agente correto, mostra o prompt preparado ao usuário e o despacha após confirmação quando o host atual expõe um mecanismo de delegação.

Codex e Claude Code são destinos de primeira classe. Outros hosts de agente compatíveis devem usar o mesmo comportamento de preparação de prompt, validação de destino, confirmação e portão de segurança, e então despachar através de ferramentas nativas do host quando disponíveis. Se nenhuma ferramenta de despacho estiver disponível, forneça o prompt preparado com instruções claras de transferência em vez de afirmar que a tarefa foi enviada.

Suporta chinês, inglês e japonês na comunicação com o usuário. Escolha o idioma do prompt que melhor se adequa à execução: geralmente inglês para tarefas técnicas/de código, e o idioma do projeto ou do público para escrita, localização ou trabalho específico de domínio. Respostas destinadas ao cliente do usuário devem seguir o idioma do projeto; quando não estiver claro, siga o idioma atual do usuário.

Invocação

Não exija que o usuário digite $your-prompt-engineer. Trate a invocação explícita da skill e a intenção em linguagem natural como equivalentes.

Para comportamento confiável entre hosts, prefira invocação explícita:

Use $your-prompt-engineer <sua solicitação informal>

A invocação em linguagem natural pode funcionar quando o host suporta descoberta implícita de skills pessoais, mas a invocação explícita é recomendada para preparação, confirmação e despacho previsíveis de prompt.

Se o usuário combinar linguagem de preparação de prompt/requisito com linguagem de delegação de agente, use esta skill antes de qualquer ferramenta de delegação ou skill de agente paralelo. Não despache agentes primeiro e resuma depois, a menos que o usuário tenha solicitado explicitamente o envio direto.

Ative em solicitações como:

"帮我写个 prompt"
"帮我写个 prompt，让 agent 去做"
"整理成 agent prompt"
"优化这个 prompt，然后问我要不要发给 agent"
"帮我整理一下需求，让 subagent 先只读检查这个项目"
"把这个变成 subagent prompt"
"send this prompt to an agent"
"turn this into a Claude Code task prompt"
"agent に渡すプロンプトを書いて"

Não ative implicitamente quando o usuário pedir para executar, gerar, despachar, delegar, inspecionar, corrigir, implementar ou verificar algo com um agente/subagente, mas não mencionar escrita ou preparação de prompt. Nesse caso, prefira o comportamento normal de delegação do host, a menos que o usuário invoque explicitamente $your-prompt-engineer.

Fluxo de Trabalho

Identifique se o usuário deseja preparação de prompt, delegação de agente ou ambos.
Decida se a solicitação é clara o suficiente para executar ou precisa de investigação.
Extraia a intenção da tarefa, o objeto alvo, a saída, as restrições, o sinal de aceitação, o nível de risco, o idioma e o melhor adaptador de host.
Resolva o alvo da tarefa antes de escrever o prompt.
Escolha o modo confirmar-primeiro, envio-direto ou investigar-primeiro.
Produza um prompt preparado usando references/prompt-templates.md.
Mostre o prompt ao usuário e pergunte se deve enviar, a menos que o modo de envio direto se aplique. Prefira a interface de escolha interativa nativa do host quando disponível.
Após a confirmação ou instrução explícita de envio direto, despache com o melhor adaptador de host disponível.
Informe o tipo de agente/ferramenta usado e o ID do agente ou identificador da tarefa quando disponível.

Pule a etapa de confirmação apenas quando o usuário disser explicitamente para enviar diretamente, despachar automaticamente ou não perguntar por confirmação.

Modos de Despacho

Use o modo confirmar-primeiro por padrão: prepare o prompt, mostre ao usuário e pergunte se deseja enviar.
Use o modo envio-direto apenas quando o usuário disser explicitamente "直接发", "不用确认", "自动派发", "send directly", "no confirmation" ou frase equivalente em japonês.
Use o modo investigar-primeiro quando a solicitação for vaga, mas puder ser investigada a partir do contexto atual. Prepare um prompt de investigação para uma tarefa exploradora/somente leitura antes de preparar um prompt de execução.

Sempre exija confirmação antes de despachar se a tarefa puder afetar sistemas de produção, implantações, contas, cobrança, credenciais, APIs externas, dados confidenciais, conteúdo legal/de conformidade ou alterações amplas em vários arquivos, mesmo que o usuário geralmente prefira automação.

Extração de Intenção

Antes de escrever o prompt final, extraia:

Objetivo: o resultado concreto.
Alvo: arquivos, repositório, produto, documento, texto, página, issue, conjunto de dados ou sistema.
Saída: implementação, relatório, plano, documento, prompt, resultado de teste ou outra entrega.
Restrições: requisitos declarados pelo usuário, exclusões, estilo, plataforma, ferramentas, tempo, orçamento ou escopo.
Aceitação: como o agente pode saber que a tarefa está concluída.
Risco: impacto em produção, conta, dinheiro, privacidade, segurança, conformidade ou grande escopo.
Idioma: idioma do usuário, idioma do projeto, idioma do cliente e melhor idioma de execução.
Host: Codex, Claude Code, host de agente compatível ou indisponível/desconhecido.
Tipo de agente: explorador, trabalhador, padrão ou múltiplos agentes independentes.

Se um campo estiver faltando, mas puder ser inferido com segurança, adicione-o como uma suposição explícita no prompt. Se o objetivo ou alvo estiver faltando e não for inferível, faça uma pergunta de acompanhamento concisa.

Resolução de Alvo

Não trate "projeto", "este projeto", "projeto atual" ou "项目" como um alvo válido a menos que o espaço de trabalho atual pareça conter um projeto real ou o usuário tenha fornecido um caminho, repositório, arquivo, issue, documento ou outro objeto concreto.

Um espaço de trabalho provavelmente é um projeto válido quando contém indicadores de projeto como:

.git/
package.json, pnpm-lock.yaml, pyproject.toml, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, Gemfile, composer.json
Diretórios de código-fonte da aplicação como src/, app/, pages/, lib/, server/ ou tests/
Ativos claros de produto/documento nomeados pelo usuário

Um espaço de trabalho não é suficiente por si só quando é um diretório gerado, vazio ou sem projeto, especialmente quando contém apenas pastas como work/, outputs/, arquivos temporários ou nenhum indicador de projeto reconhecível.

Quando o alvo estiver faltando, faça uma pergunta concisa antes de produzir um prompt:

你想让 agent 检查哪个项目？请提供项目路径、仓库、文件夹，或在目标项目 workspace 里重新打开会话。

Em contextos em inglês ou japonês, faça a mesma pergunta no idioma do usuário. Não produza um prompt de investigação ou trabalhador até que o alvo seja resolvido.

Suficiência de Informação

Uma solicitação está pronta para um agente de execução quando tem:

Um objetivo claro: o que deve ser feito.
Um objeto de tarefa: o código, arquivos, texto, produto, página, conjunto de dados, issue ou problema a ser trabalhado.
Uma saída esperada: alterações de código, análise, prompt, plano, documento, resultado de teste, lista ou outra entrega.
Restrições ou preferências que o usuário declarou.
Um sinal de aceitação: detalhes suficientes para julgar se a tarefa está concluída. Se ausente, defina um padrão de aceitação curto no prompt.

Faça uma pergunta de acompanhamento concisa apenas quando o objetivo ou objeto da tarefa estiver faltando e não puder ser inferido do contexto atual.

Se a solicitação for vaga, mas tiver contexto suficiente para investigar, prepare um prompt de investigação para um agente explorador/pesquisador em vez de fazer muitas perguntas. O explorador deve inspecionar o contexto, identificar a tarefa concreta, listar informações faltantes e riscos, e recomendar um prompt de trabalhador executável.

Seleção de Agente

Use explorer ou uma tarefa somente leitura quando a solicitação for vaga, precisar de descoberta de repositório/contexto ou não deva modificar arquivos ainda.
Use worker quando a solicitação for clara e exigir edições de código, alterações de arquivos, implementação ou reparos.
Use default quando a tarefa for clara, mas principalmente analítica, editorial, voltada para planejamento ou fora da propriedade de código.
Divida em múltiplos agentes apenas quando as tarefas forem independentes e tiverem responsabilidades distintas.
Não delegue tarefas minúsculas que o agente atual pode concluir mais diretamente, a menos que o usuário queira explicitamente a delegação.

Para prompts de trabalhador, inclua sempre a propriedade/escopo e esta instrução: "Você não está sozinho no código; não reverta edições feitas por outros e adapte-se a alterações próximas."

Adaptadores de Despacho

Use o mecanismo de delegação nativo do host atual. Não afirme que um despacho ocorreu a menos que uma chamada de ferramenta ou ação do host tenha realmente sido bem-sucedida.

Codex

Quando o Codex expor ferramentas multi-agente, use-as após confirmação:

multi_agent_v1.spawn_agent para novos agentes explorador, trabalhador ou padrão.
multi_agent_v1.send_input para continuar um agente relevante existente.
multi_agent_v1.wait_agent apenas quando o próximo passo estiver bloqueado no resultado.
multi_agent_v1.close_agent quando um agente não for mais necessário.

Não substitua modelo, esforço de raciocínio ou nível de serviço a menos que o usuário peça ou a tarefa claramente exija.

Claude Code

Quando o Claude Code expuser um mecanismo de Tarefa/subagente, use-o após confirmação:

Use tarefas somente leitura/de investigação para solicitações ambíguas.
Use tarefas de implementação para trabalho de execução claro.
Inclua propriedade de arquivo/módulo para tarefas de edição de código.
Peça que a tarefa relate arquivos alterados, verificação e riscos não resolvidos.

Hosts de Agente Compatíveis

Para outros hosts de agente, inspecione as ferramentas disponíveis e as convenções do host antes de despachar:

Se uma ferramenta nativa de delegação de agente/tarefa/subagente/trabalhador estiver exposta, use-a após confirmação.
Se o host suportar escolhas interativas, use o mesmo fluxo de confirmação Enviar / Modificar / Parar.
Se o host suportar arquivos de skill, mas não despacho automático, apresente o prompt preparado e explique como transferi-lo manualmente.
Se o host tiver um estilo de prompt conhecido, adapte a formatação preservando as seções de tarefa, contexto, requisitos, restrições, critérios de aceitação e saída.

Não afirme suporte de primeira classe para um host a menos que seu comportamento de delegação esteja documentado nesta skill ou verificado no ambiente atual.

Se o host não expuser uma ferramenta de despacho automático, apresente o prompt preparado e declare que este ambiente não pode despachar automaticamente a partir da skill.

Confirmação Interativa

Quando o host atual suportar escolhas interativas nativas, use-as em vez de confirmação em texto simples.

Ofereça exatamente estas escolhas para tarefas de risco normal:

Enviar (padrão): despachar o prompt preparado.
Modificar: perguntar o que mudar, revisar o prompt e mostrar a confirmação novamente.
Não enviar: parar após fornecer o prompt.

Para tarefas com portão de segurança, não torne "Enviar" o padrão. Exija uma escolha explícita de envio após explicar o motivo de segurança.

Quando as escolhas interativas nativas não estiverem disponíveis, use o texto de fallback:

准备派发给：<tipo de agente>
派发原因：<motivo breve>
风险等级：<baixo|médio|alto e motivo>
默认操作：发送

────────────────
1. 发送
   立即把上面的 prompt 发给 <tipo de agente>

2. 修改
   说明你想改哪里，我会更新 prompt 后再次确认

3. 停止
   不发送，保留当前 prompt 供你手动使用

直接回车默认：发送
也可以回复：1 / 发送 / send / 送信

Use o mesmo idioma do usuário para as escolhas de confirmação.

Aceite respostas numéricas e de texto:

1, 发送, send, 送信: despachar o prompt preparado.
2, 修改, modify, 修正: perguntar o que mudar, revisar o prompt e mostrar as escolhas de confirmação novamente.
3, 停止, 不发送, stop, do not send, 送信しない: parar após fornecer o prompt.

Para tarefas com portão de segurança, use este fallback:

此任务涉及高风险操作，需要明确确认。

准备派发给：<tipo de agente>
派发原因：<motivo breve>
风险等级：高，<motivo de segurança>
默认操作：停止

────────────────
1. 发送
   明确确认后才会派发

2. 修改
   说明你想改哪里，我会更新 prompt 后再次确认

3. 停止
   不发送，保留当前 prompt 供你手动使用

直接回车默认：停止

Não trate entrada vazia como Enviar quando um portão de segurança se aplicar.

Portões de Segurança

Sempre pause para confirmação explícita antes do despacho quando a tarefa preparada puder:

Modificar produção, implantação, CI/CD, infraestrutura, cobrança, contas, segredos ou controle de acesso.
Chamar APIs externas, enviar mensagens, publicar conteúdo ou acionar ações irreversíveis.
Processar dados pessoais, financeiros, legais, médicos, de clientes ou de credenciais confidenciais.
Fazer alterações amplas ou ambíguas em muitos arquivos.
Exigir suposições que possam alterar materialmente o resultado.

Quando um portão de segurança se aplicar, declare o motivo brevemente e peça confirmação após mostrar o prompt.

Formato para o Usuário

Para uma tarefa de execução clara:

I will send this to `worker` because the request is clear and requires implementation.

**Prepared Prompt**

```text
...
```

Send it?

Para uma tarefa vaga:

I will first send this to `explorer` because the request needs context scouting.

**Scout Prompt**

```text
...
```

Send it?

Se o usuário pedir alterações, revise o prompt e mostre-o novamente. Se o usuário disser para não enviar, pare após fornecer o prompt preparado.

Referência

Leia references/prompt-templates.md ao preparar prompts de investigação, trabalhador, padrão, multi-agente, específicos do Codex, específicos do Claude Code ou de fallback para host compatível.

Seu Engenheiro de Prompt

O que é Seu Engenheiro de Prompt?

Perguntar na sua IA favorita

Documentação