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
"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:
- Llama al modelo de lenguaje
- Ejecuta las operaciones indicadas por la salida del modelo (leer archivos, editar archivos, ejecutar herramientas, etc.)
- 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
"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
"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
"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
"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
| Tipo | Descripción | Ventajas |
|---|---|---|
| Hilo local | Se ejecuta en tu máquina | Puede leer y escribir archivos, usar herramientas existentes |
| Hilo en la nube | Se ejecuta en un entorno aislado | Ejecución en paralelo, delegación de tareas desde otros dispositivos |
Reanudar sesión
Reanudar una sesión anterior
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
/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
/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
"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