concava/skills (Guía de Codex)

Guía de Codex Skill

Ejecutar una tarea

1. Para una nueva sesión (las reanudaciones heredan el modelo/esfuerzo anterior; ver paso 5), pregunte al usuario (mediante AskUserQuestion) qué modelo y qué esfuerzo de razonamiento usar, en una sola pregunta con dos opciones. Cuando el usuario no exprese preferencia, use por defecto gpt-6-astra con high.
   • Modelo — por defecto gpt-6-astra:
     • GPT-6: gpt-6-astra (frontera/más capaz — por defecto)
     • GPT-5.6: gpt-5.6-sol (caballo de batalla agéntico fiable), gpt-5.6-terra (equilibrado, cotidiano), gpt-5.6-luna (rápido y asequible)
     • Legado (mantenido por compatibilidad): gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark, gpt-5.3-codex
   • Esfuerzo de razonamiento — por defecto high: low, medium, high, xhigh, max, ultra.
     • max/ultra requieren un modelo GPT-6 o GPT-5.6; ultra solo está disponible en astra/sol/terra (luna tiene un máximo de max); los modelos heredados tienen un límite de xhigh.
     • ultra = razonamiento máximo con delegación automática de tareas (el más lento y costoso — reserve para los trabajos más complejos).
     • Si el esfuerzo elegido supera el máximo del modelo seleccionado, reduzca al esfuerzo máximo soportado por ese modelo y comuníqueselo al usuario.
2. Seleccione el modo sandbox requerido para la tarea; por defecto use --sandbox read-only a menos que se necesiten ediciones o acceso a red.
3. Construya el comando con las opciones adecuadas:
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<low|medium|high|xhigh|max|ultra>" (max/ultra solo en modelos GPT-6 / GPT-5.6; ultra solo en astra/sol/terra — ver paso 1)
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
   • "su prompt aquí" (como argumento posicional final)
4. Use siempre --skip-git-repo-check.
5. Al continuar una sesión anterior, use codex exec --skip-git-repo-check resume --last mediante stdin. Al reanudar, no use ninguna bandera de configuración a menos que el usuario lo solicite explícitamente (por ejemplo, si especifica el modelo o el esfuerzo de razonamiento al pedir reanudar una sesión). Sintaxis de reanudación: echo "su prompt aquí" | codex exec --skip-git-repo-check resume --last 2>/dev/null. Todas las banderas deben insertarse entre exec y resume.
6. IMPORTANTE: Por defecto, añada 2>/dev/null a todos los comandos codex exec para suprimir los tokens de pensamiento (stderr). Solo muestre stderr si el usuario solicita explícitamente ver los tokens de pensamiento o si se necesita depuración.
7. IMPORTANTE (stdin): codex exec siempre lee stdin y lo concatena con el prompt posicional, incluso cuando el prompt se proporciona completamente como argumento posicional. Si stdin no se cierra, codex se bloquea indefinidamente. Al invocar desde un entorno externo (tareas en segundo plano, hooks, scripts donde stdin no es una TTY pero tampoco está cerrado), redirija stdin explícitamente: añada </dev/null al comando, por ejemplo codex exec ... "prompt" </dev/null 2>/dev/null. Síntoma de hacerlo mal: cero bytes de salida estándar, cero CPU acumulada, el proceso parece colgado indefinidamente.
8. Ejecute el comando, capture stdout/stderr (filtrado según corresponda) y resuma el resultado para el usuario.
9. Después de que Codex termine, informe al usuario: "Puedes reanudar esta sesión de Codex en cualquier momento diciendo 'codex resume' o pidiéndome que continúe con análisis o cambios adicionales."

Referencia rápida

Caso de uso	Modo sandbox	Banderas clave
Revisión o análisis de solo lectura	read-only	--sandbox read-only 2>/dev/null
Aplicar ediciones locales	workspace-write	--sandbox workspace-write --full-auto 2>/dev/null
Permitir acceso a red o general	danger-full-access	--sandbox danger-full-access --full-auto 2>/dev/null
Reanudar sesión reciente	Heredado del original	echo "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null (sin banderas permitidas)
Ejecutar desde otro directorio	Según necesidades de la tarea	-C <DIR> más otras banderas 2>/dev/null

Tiempos de espera de ejecución

Codex no produce ninguna salida intermedia — escribe el resultado solo al finalizar. Si el proceso se mata antes de terminar, el archivo de salida está silenciosamente vacío (sin error).

Enfoque preferido: ejecutar de forma síncrona — elimina por completo el riesgo de tiempo de espera y la conversación espera el resultado de todos modos.

Si se ejecuta en segundo plano, establezca el tiempo de espera de ejecución según el esfuerzo de razonamiento:

Esfuerzo de razonamiento	Tiempo de espera
low	150s
medium	300s
high	600s
xhigh	1200s
max	1800s
ultra	1800s

Seguimiento

• Después de cada comando codex, use inmediatamente AskUserQuestion para confirmar los siguientes pasos, recopilar aclaraciones o decidir si reanudar con codex exec resume --last.
• Al reanudar, canalice el nuevo prompt a través de stdin: echo "nuevo prompt" | codex exec resume --last 2>/dev/null. La sesión reanudada usa automáticamente el mismo modelo, esfuerzo de razonamiento y modo sandbox de la sesión original.
• Vuelva a indicar el modelo elegido, el esfuerzo de razonamiento y el modo sandbox al proponer acciones de seguimiento.

Evaluación crítica de la salida de Codex

Codex funciona con modelos de OpenAI que tienen sus propios límites de conocimiento y limitaciones. Trate a Codex como un colega, no como una autoridad.

Directrices

• Confíe en su propio conocimiento cuando esté seguro. Si Codex afirma algo que sabe que es incorrecto, refútelo directamente.
• Investigue los desacuerdos usando WebSearch o documentación antes de aceptar las afirmaciones de Codex. Comparta los hallazgos con Codex mediante reanudación si es necesario.
• Recuerde los límites de conocimiento: es posible que Codex no conozca versiones recientes, API o cambios ocurridos después de sus datos de entrenamiento.
• No delegue ciegamente - Codex puede equivocarse. Evalúe críticamente sus sugerencias, especialmente en lo que respecta a:
  • Nombres y capacidades de modelos
  • Versiones recientes de bibliotecas o cambios en API
  • Prácticas recomendadas que pueden haber evolucionado

Cuando Codex se equivoca

1. Exprese su desacuerdo claramente al usuario
2. Proporcione evidencia (su propio conocimiento, búsqueda web, documentación)
3. Opcionalmente, reanude la sesión de Codex para discutir el desacuerdo. Preséntese como Claude para que Codex sepa que es una discusión entre IA pares. Use el nombre real de su modelo (por ejemplo, el modelo con el que está funcionando actualmente) en lugar de un nombre fijo:

   echo "Soy Claude (<nombre de su modelo actual>) haciendo seguimiento. No estoy de acuerdo con [X] porque [evidencia]. ¿Cuál es tu opinión sobre esto?" | codex exec --skip-git-repo-check resume --last 2>/dev/null
   

4. Plantee los desacuerdos como discusiones, no correcciones — cualquiera de las dos IA podría estar equivocada
5. Deje que el usuario decida cómo proceder si hay una ambigüedad real

Manejo de errores

• Deténgase e informe fallos siempre que codex --version o un comando codex exec termine con código distinto de cero; solicite instrucciones antes de reintentar.
• Antes de usar banderas de alto impacto (--full-auto, --sandbox danger-full-access, --skip-git-repo-check) pida permiso al usuario mediante AskUserQuestion a menos que ya se haya otorgado.
• Cuando la salida incluya advertencias o resultados parciales, resúmalos y pregunte cómo ajustar mediante AskUserQuestion.