Consejos de prompts para Codex CLI

Dominar las técnicas de prompts eficaces es clave para aprovechar al máximo Codex CLI. Esta sección detalla cómo escribir prompts eficientes para obtener los mejores resultados.


Fundamentos de los prompts

Interactúas con Codex enviando prompts, que describen la tarea que deseas que complete.

Ejemplos básicos

Prompt básico

# Explicar la funcionalidad del código
"Explain how the transform module works and how other modules use it."

# Añadir una nueva función
"Add a new command-line option `--json` that outputs JSON."

# Corregir un bug
"Fix the error in the login function"

Cómo funcionan los prompts

Cuando envías un prompt, Codex trabaja en el siguiente ciclo:

Codex 提示词工作流程
Figura: Flujo de trabajo de prompts de Codex
  1. Llama al modelo de lenguaje
  2. Ejecuta las operaciones indicadas por la salida del modelo (leer archivos, editar archivos, ejecutar herramientas, etc.)
  3. Repite hasta que la tarea se complete o tú la canceles.
Entender este ciclo te ayuda a diseñar mejores prompts, porque Codex toma decisiones basadas en el contexto en cada paso.

Consejos para escribir prompts eficaces

Consejo 1: Incluye pasos de verificación

Codex produce resultados de mayor calidad cuando puede verificar su trabajo. Incluir pasos de verificación ayuda a Codex a garantizar la corrección:

Prompt con verificación incluida

# No recomendado
"Write a function to sort a list"

# Recomendado - incluir verificación
"Write a function to sort a list. Include test cases to verify it handles empty lists, already-sorted lists, reverse-sorted lists, and lists with duplicates. Run the tests to confirm they pass."

Consejo 2: Divide tareas complejas en pasos pequeños

Codex se desempeña mejor con tareas más pequeñas y enfocadas. Las tareas pequeñas son más fáciles de probar y revisar:

Dividir la tarea

# No recomendado - tarea demasiado grande
"Create a complete user authentication system with login, registration, password reset, and OAuth"

# Recomendado - dividir en pasos pequeños
"Step 1: Create a user model with email and password fields
Step 2: Add a registration endpoint
Step 3: Add a login endpoint with JWT
Step 4: Add password reset functionality
Let me know when Step 1 is done before moving to Step 2"

Consejo 3: Proporciona contexto

Proporciona contexto que Codex pueda usar, como referencias a archivos relevantes e imágenes:

Proporcionar contexto

# No recomendado
"Fix this bug"

# Recomendado - incluir información detallada
"Fix the bug in src/auth.py where users can't log in with special characters in their password. I've attached a screenshot of the error message and the relevant code section."

Consejo 4: Especifica el formato de salida

Dile a Codex el formato de salida que esperas:

Especificar el formato de salida

# Especificar estilo de código
"Write a function to calculate Fibonacci numbers. Use TypeScript, include JSDoc comments, and follow functional programming principles."

# Especificar estructura de salida
"Explain the codebase structure. Organize your answer with: 1) Overview 2) Key directories 3) Main entry points"
Los prompts más específicos suelen producir mejores resultados. Codex es bueno entendiendo la intención, pero cuanta más información proporciones, mejor será su desempeño.

Hilos (Threads)

Un hilo es una sesión única: tu prompt más las salidas del modelo y las llamadas a herramientas posteriores. Un hilo puede contener múltiples prompts.

Hilos locales vs. hilos en la nube

TipoDescripciónVentajas
Hilo localSe ejecuta en tu máquinaPuede leer y escribir archivos, usar herramientas existentes
Hilo en la nubeSe ejecuta en un entorno aisladoEjecución en paralelo, delegación de tareas desde otros dispositivos

Reanudar sesión

Reanudar una sesión anterior

# Abrir el selector de sesiones
codex resume

# Saltar directamente a la sesión reciente
codex resume --last

# Reanudar una sesión específica
codex resume <SESSION_ID>

Gestión de sesiones

Los hilos en ejecución pueden ser paralelos, pero evita que dos hilos modifiquen el mismo archivo al mismo tiempo. También puedes reanudar un hilo más tarde continuando con otro prompt.


Gestión del contexto

Cuando envías un prompt, incluye contexto que Codex pueda usar, como referencias a archivos e imágenes relevantes. La extensión del IDE añade automáticamente como contexto la lista de archivos abiertos y el rango de texto seleccionado.

Ventana de contexto

Toda la información en el hilo debe caber en la ventana de contexto del modelo. Codex supervisa e informa el espacio restante.

Compresión automática

Para tareas más largas, Codex puede comprimir automáticamente el contexto resumiendo la información relevante y descartando detalles menos relevantes. Codex puede seguir procesando tareas complejas en múltiples pasos.

Gestión manual del contexto

Puedes ayudar a Codex a gestionar el contexto de las siguientes maneras:

  • Enfócate en la tarea actual.
  • Evita mezclar múltiples tareas independientes en un solo prompt.
  • Comienza nuevas sesiones periódicamente (usando/new)
Cuando Codex informe un uso elevado del contexto, considera empezar una nueva sesión o reducir los mensajes históricos.

Técnicas avanzadas de prompts

Usar el modo planificación

Para tareas complejas, usa el modo planificación para que Codex primero planifique y luego ejecute:

Modo planificación

# Usar el comando /plan
/plan implementar un sistema de autenticación de usuarios

# O incluir 'plan' en el prompt
"Plan and implement a REST API with CRUD operations for a blog"

Usar el modo revisión

Solicita a Codex que revise el código en lugar de modificarlo directamente:

Modo revisión

# Usar el comando /review
/review src/auth.py

# O describir la necesidad de revisión
"Review this code for potential security vulnerabilities and suggest improvements"

Limitar el alcance de las modificaciones

Indica claramente a Codex qué puede modificar:

Limitar el alcance de las modificaciones

# Modo de solo lectura
"Explain what this function does, don't make any changes"

# Limitar el alcance a archivos
"Add logging only to the auth module, don't touch other files"

# Confirmación paso a paso
"Let me know the proposed changes before you make them"

Plantillas de prompts

A continuación se presentan algunas plantillas de prompts de uso común:

Generación de código

Write a [语言] function that [功能描述].
Requirements:
- [需求1]
- [需求2]
Include:
- 详细的文档注释
- 错误处理
- 测试用例

Revisión de código

Review the [文件/模块] for:
- Potential bugs
- Security issues
- Performance problems
- Code style violations

Provide:
- Issue list with severity
- Suggested fixes
- Overall quality score (1-10)

Corrección de bugs

Fix the bug in [文件:行号/函数名].
Error: [错误信息]
Expected behavior: [期望行为]
Steps to reproduce: [复现步骤]

Refactorización

Refactor [文件/函数] to [目标].
Current issues:
- [问题1]
- [问题2]

Constraints:
- 保持功能不变
- 不要改变 API 接口
- 添加单元测试
La práctica hace al maestro. Practica escribir prompts y poco a poco dominarás cómo obtener los mejores resultados.

Preguntas frecuentes

P: ¿Qué hago si Codex no entendió mi prompt?

Prueba: 1) descriptirlo con más precisión 2) proporcionar más contexto 3) dividirlo en pasos más pequeños 4) usar ejemplos para ilustrar la salida esperada.

P: ¿Debería usar inglés o chino para los prompts?

Codex admite varios idiomas, pero el inglés suele funcionar mejor. Si describes en chino, asegúrate de que la descripción sea suficientemente detallada y clara.

P: ¿Cómo hago para que Codex solo analice y no modifique el código?

Dile explícitamente 'solo lectura' o 'don't make any changes', y solo proporcionará análisis sin modificar el código.

P: ¿Qué hago si la ventana de contexto está llena?

Inicia una nueva sesión (usando /new), o deja que Codex comprima el historial (lo manejará automáticamente).

Otras extensiones