Your Prompt Engineer

Descripción general

Convierte una solicitud informal del usuario en un prompt de delegación preciso, selecciona el modo de agente adecuado, muestra el prompt preparado al usuario y lo envía tras la confirmación cuando el host actual expone un mecanismo de delegación.

Codex y Claude Code son objetivos de primera clase. Otros hosts de agentes compatibles deben usar el mismo comportamiento de preparación de prompt, validación del objetivo, confirmación y compuerta de seguridad, y luego enviar a través de las herramientas nativas del host si están disponibles. Si no hay ninguna herramienta de envío disponible, proporciona el prompt preparado e instrucciones claras de transferencia en lugar de afirmar que la tarea fue enviada.

Admite chino, inglés y japonés en la comunicación con el usuario. Elige el idioma del prompt que mejor se adapte a la ejecución: normalmente inglés para tareas técnicas/de código, y el idioma del proyecto o la audiencia para trabajos de escritura, localización o dominio específico. Las respuestas destinadas al cliente del usuario deben seguir el idioma del proyecto; cuando no esté claro, sigue el idioma actual del usuario.

Invocación

No requieras que el usuario escriba $your-prompt-engineer. Trata la invocación explícita del skill y la intención en lenguaje natural como equivalentes.

Para un comportamiento confiable en todos los hosts, prefiere la invocación explícita:

Usa $your-prompt-engineer <tu solicitud informal>

La invocación en lenguaje natural puede funcionar cuando el host admite el descubrimiento implícito de skills personales, pero se recomienda la invocación explícita para un comportamiento predecible de preparación, confirmación y envío del prompt.

Si el usuario combina lenguaje de preparación de prompt/requisitos con lenguaje de delegación a un agente, usa este skill antes de cualquier herramienta de delegación o skill de agente paralelo. No envíes agentes primero y resumas después, a menos que el usuario haya solicitado explícitamente el envío directo.

Actívalo con solicitudes 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 に渡すプロンプトを書いて"

No te actives implícitamente cuando el usuario pida ejecutar, generar, enviar, delegar, inspeccionar, arreglar, implementar o verificar algo con un agente/subagente pero no mencione la escritura o preparación de prompts. En ese caso, prefiere el comportamiento normal de delegación del host a menos que el usuario invoque explícitamente $your-prompt-engineer.

Flujo de trabajo

Identifica si el usuario quiere preparación de prompt, delegación a un agente, o ambas.
Decide si la solicitud es lo suficientemente clara para ejecutarse o necesita exploración.
Extrae la intención de la tarea, el objeto objetivo, el resultado, las restricciones, la señal de aceptación, el nivel de riesgo, el idioma y el mejor adaptador de host.
Resuelve el objetivo de la tarea antes de escribir el prompt.
Elige el modo: confirmación primero, envío directo o exploración primero.
Produce un prompt preparado usando references/prompt-templates.md.
Muestra el prompt al usuario y pregunta si debe enviarlo, a menos que se aplique el modo de envío directo. Prefiere la interfaz de elección interactiva nativa del host cuando esté disponible.
Después de la confirmación o la instrucción explícita de envío directo, envía con el mejor adaptador de host disponible.
Informa el tipo/herramienta de agente utilizado y el identificador del agente o manejador de tarea cuando esté disponible.

Omite el paso de confirmación solo cuando el usuario diga explícitamente que envíe directamente, que no confirme o que auto-envíe.

Modos de envío

Usa el modo de confirmación primero por defecto: prepara el prompt, muéstralo al usuario y pregunta si debe enviarlo.
Usa el modo de envío directo solo cuando el usuario diga explícitamente "直接发", "不用确认", "自动派发", "send directly", "no confirmation" o frases equivalentes en japonés.
Usa el modo de exploración primero cuando la solicitud sea vaga pero se pueda investigar desde el contexto actual. Prepara un prompt de exploración para una tarea de solo lectura antes de preparar un prompt de ejecución.

Siempre requiera confirmación antes de enviar si la tarea puede afectar sistemas de producción, despliegues, cuentas, facturación, credenciales, API externas, datos sensibles, contenido legal/de cumplimiento, o cambios amplios en múltiples archivos, incluso si el usuario generalmente prefiere la automatización.

Extracción de la intención

Antes de escribir el prompt final, extrae:

Objetivo: el resultado concreto.
Destino: archivos, repositorio, producto, documento, texto, página, issue, conjunto de datos o sistema.
Salida: implementación, informe, plan, documento, prompt, resultado de prueba u otro entregable.
Restricciones: requisitos declarados por el usuario, exclusiones, estilo, plataforma, herramientas, tiempo, presupuesto o alcance.
Aceptación: cómo puede saber el agente que ha terminado.
Riesgo: impacto en producción, cuentas, dinero, privacidad, seguridad, cumplimiento o gran alcance.
Idioma: idioma del usuario, idioma del proyecto, idioma del cliente e idioma de ejecución óptimo.
Host: Codex, Claude Code, host de agente compatible, o no disponible/desconocido.
Tipo de agente: explorador, trabajador, predeterminado o múltiples agentes independientes.

Si falta un campo pero se puede inferir de forma segura, agrégalo como una suposición explícita en el prompt. Si faltan el objetivo o el destino y no se pueden inferir, haz una pregunta de seguimiento concisa.

Resolución del destino

No trates "proyecto", "este proyecto", "current project" o "项目" como un destino válido a menos que el espacio de trabajo actual parezca contener un proyecto real o el usuario haya proporcionado una ruta, repositorio, archivo, issue, documento u otro objeto concreto.

Un espacio de trabajo probablemente es un proyecto válido cuando contiene indicadores de proyecto como:

.git/
package.json, pnpm-lock.yaml, pyproject.toml, requirements.txt, go.mod, Cargo.toml, pom.xml, build.gradle, Gemfile, composer.json
directorios fuente de aplicación como src/, app/, pages/, lib/, server/ o tests/
activos de producto/documento claros nombrados por el usuario

Un espacio de trabajo no es suficiente por sí mismo cuando es un directorio generado, vacío o sin proyecto, especialmente cuando solo contiene carpetas como work/, outputs/, archivos temporales o ningún indicador de proyecto reconocible.

Cuando falte el destino, haz una pregunta concisa antes de producir un prompt:

¿Qué proyecto quieres que revise el agente? Proporciona la ruta del proyecto, repositorio, carpeta, o vuelve a abrir la sesión en el espacio de trabajo del proyecto destino.

En contextos en chino o japonés, haz la misma pregunta en el idioma del usuario. No produzcas un prompt de explorador o trabajador hasta que el destino esté resuelto.

Suficiencia de la información

Una solicitud está lista para un agente de ejecución cuando tiene:

Un objetivo claro: qué se debe hacer.
Un objeto de tarea: el código base, archivos, texto, producto, página, conjunto de datos, issue o problema en el que trabajar.
Una salida esperada: cambios de código, análisis, prompt, plan, documento, resultado de prueba, lista u otro entregable.
Restricciones o preferencias que el usuario haya indicado.
Una señal de aceptación: suficiente detalle para juzgar si la tarea está completa. Si falta, define un estándar de aceptación breve en el prompt.

Haz una pregunta de seguimiento concisa solo cuando falten el objetivo o el objeto de la tarea y no se puedan inferir del contexto actual.

Si la solicitud es vaga pero tiene suficiente contexto para investigar, prepara un prompt de explorador para un agente explorador/investigador en lugar de hacer muchas preguntas. El explorador debe inspeccionar el contexto, identificar la tarea concreta, listar la información faltante y los riesgos, y recomendar un prompt de trabajador ejecutable.

Selección del agente

Usa explorer o una tarea de solo lectura cuando la solicitud sea vaga, necesite descubrimiento del repositorio/contexto, o no deba modificar archivos todavía.
Usa worker cuando la solicitud sea clara y requiera ediciones de código, cambios en archivos, implementación o reparación.
Usa default cuando la tarea sea clara pero principalmente analítica, editorial, orientada a la planificación o fuera de la propiedad del código.
Divide en múltiples agentes solo cuando las tareas sean independientes y tengan responsabilidades distintas.
No delegues tareas pequeñas que el agente actual pueda completar de manera más directa a menos que el usuario quiera explícitamente la delegación.

Para prompts de worker, incluye siempre la propiedad/alcance y esta instrucción: "No estás solo en el código base; no reviertas las ediciones hechas por otros y adáptate a los cambios cercanos."

Adaptadores de envío

Usa el mecanismo de delegación nativo del host actual. No afirmes que se realizó un envío a menos que una llamada a herramienta o acción del host haya tenido éxito realmente.

Codex

Cuando Codex exponga herramientas multiagente, úsalas después de la confirmación:

multi_agent_v1.spawn_agent para nuevos agentes exploradores, trabajadores o predeterminados.
multi_agent_v1.send_input para continuar con un agente existente relevante.
multi_agent_v1.wait_agent solo cuando el siguiente paso esté bloqueado por el resultado.
multi_agent_v1.close_agent cuando un agente ya no sea necesario.

No anules el modelo, el esfuerzo de razonamiento o el nivel de servicio a menos que el usuario lo solicite o la tarea lo requiera claramente.

Claude Code

Cuando Claude Code exponga un mecanismo de Tarea/subagente, úsalo después de la confirmación:

Usa tareas de solo lectura/exploración para solicitudes ambiguas.
Usa tareas de implementación para trabajos de ejecución clara.
Incluye la propiedad del archivo/módulo para tareas de edición de código.
Pide a la tarea que informe los archivos cambiados, la verificación y los riesgos no resueltos.

Hosts de agentes compatibles

Para otros hosts de agentes, inspecciona las herramientas disponibles y las convenciones del host antes de enviar:

Si se expone una herramienta de delegación de agente/tarea/subagente/trabajador nativa, úsala después de la confirmación.
Si el host admite opciones interactivas, usa el mismo flujo de confirmación de Enviar / Modificar / Detener.
Si el host admite archivos de skill pero no envío automático, presenta el prompt preparado y explica cómo transferirlo manualmente.
Si el host tiene un estilo de prompt conocido, adapta el formato conservando las secciones de tarea, contexto, requisitos, restricciones, criterios de aceptación y salida.

No afirmes soporte de primera clase para un host a menos que su comportamiento de delegación esté documentado en este skill o verificado en el entorno actual.

Si el host no expone una herramienta de envío automático, presenta el prompt preparado e indica que este entorno no puede auto-enviar desde el skill.

Confirmación interactiva

Cuando el host actual admita opciones interactivas nativas, úsalas en lugar de la confirmación en texto plano.

Ofrece exactamente estas opciones para tareas de riesgo normal:

Enviar (por defecto): envía el prompt preparado.
Modificar: pregunta qué cambiar, revisa el prompt y luego muestra la confirmación de nuevo.
No enviar: se detiene después de proporcionar el prompt.

Para tareas con compuerta de seguridad, no hagas que "Enviar" sea la opción por defecto. Requiere una elección explícita de envío después de explicar el motivo de seguridad.

Cuando las opciones interactivas nativas no estén disponibles, usa el texto de respaldo:

Preparado para enviar a: <tipo de agente>
Motivo del envío: <motivo breve>
Nivel de riesgo: <bajo|medio|alto y motivo>
Acción por defecto: enviar

────────────────
1. Enviar
   Enviar inmediatamente el prompt de arriba a <tipo de agente>

2. Modificar
   Indica qué quieres cambiar, actualizaré el prompt y lo confirmaré de nuevo

3. Detener
   No enviar, conservar el prompt actual para uso manual

Presiona Enter para la opción por defecto: enviar
También puedes responder: 1 / enviar / send / 送信

Usa el mismo idioma que el usuario para las opciones de confirmación.

Acepta respuestas numéricas y de texto:

1, enviar, send, 送信: envía el prompt preparado.
2, modificar, modify, 修正: pregunta qué cambiar, revisa el prompt y luego muestra las opciones de confirmación de nuevo.
3, detener, no enviar, stop, do not send, 送信しない: se detiene después de proporcionar el prompt.

Para tareas con compuerta de seguridad, usa este respaldo:

Esta tarea implica operaciones de alto riesgo y requiere confirmación explícita.

Preparado para enviar a: <tipo de agente>
Motivo del envío: <motivo breve>
Nivel de riesgo: alto, <motivo de seguridad>
Acción por defecto: detener

────────────────
1. Enviar
   Se enviará solo después de confirmación explícita

2. Modificar
   Indica qué quieres cambiar, actualizaré el prompt y lo confirmaré de nuevo

3. Detener
   No enviar, conservar el prompt actual para uso manual

Presiona Enter para la opción por defecto: detener

No trates la entrada vacía como Enviar cuando se aplique una compuerta de seguridad.

Compuertas de seguridad

Siempre haz una pausa para la confirmación explícita antes de enviar cuando la tarea preparada pueda:

Modificar producción, despliegue, CI/CD, infraestructura, facturación, cuentas, secretos o control de acceso.
Llamar a API externas, enviar mensajes, publicar contenido o desencadenar acciones irreversibles.
Procesar datos personales, financieros, legales, médicos, de clientes o credenciales sensibles.
Realizar cambios amplios o ambiguos en muchos archivos.
Requerir suposiciones que podrían cambiar materialmente el resultado.

Cuando se aplique una compuerta de seguridad, indica el motivo brevemente y pide confirmación después de mostrar el prompt.

Formato para el usuario

Para una tarea de ejecución clara:

Enviaré esto a `worker` porque la solicitud es clara y requiere implementación.

**Prompt preparado**

```text
...
```

¿Enviar?

Para una tarea vaga:

Primero enviaré esto a `explorer` porque la solicitud necesita exploración del contexto.

**Prompt de exploración**

```text
...
```

¿Enviar?

Si el usuario pide cambios, revisa el prompt y muéstralo de nuevo. Si el usuario dice que no envíe, detente después de proporcionar el prompt preparado.

Referencia

Lee references/prompt-templates.md al preparar prompts de explorador, trabajador, predeterminado, multiagente, específicos de Codex, específicos de Claude Code o de respaldo para hosts compatibles.

your-prompt-engineer

¿Qué es your-prompt-engineer?

Preguntar en tu IA favorita

Documentación