Introducción

Cuando Codex usa con frecuencia la misma API, fuente de registros, bandeja de entrada exportada, base de datos local o script del equipo, dale un comando que pueda ejecutar desde cualquier carpeta. Codex debe poder inspeccionar el comando, acotar sus resultados y combinarlo con git, gh, rg, pruebas y scripts del repositorio.

Agrega una habilidad que indique cuándo debe usar Codex la CLI, qué debe ejecutar primero, cómo limitar el volumen de la salida, dónde se guardan los archivos descargados y qué comandos de escritura requieren aprobación.

En este flujo de trabajo, $cli-creator ayuda a Codex a crear el comando. $skill-creator le ayuda a guardar una habilidad reutilizable como $ci-logs, que se puede invocar por su nombre en tareas futuras.

Cómo usar este flujo de trabajo

Define qué debe hacer la CLI

Antes de elegir la tecnología que quieres que implemente Codex, define qué quieres que haga. Una buena CLI convierte una operación recurrente de lectura, búsqueda, descarga, exportación, redacción de borradores, carga, consulta periódica o escritura segura en un comando que Codex puede ejecutar desde cualquier repositorio.

Comparte la documentación, los archivos o los comandos

Codex necesita una referencia concreta: documentación o una especificación OpenAPI, un comando curl sin datos confidenciales, la ruta de una exportación o de una base de datos, una carpeta de registros o un script existente. Si quieres que la CLI siga un estilo conocido, pega un fragmento breve de la salida de --help de gh, kubectl o una herramienta de tu equipo.

Si el comando requiere autenticación, indica a Codex el nombre de la variable de entorno, la ruta del archivo de configuración o el flujo de inicio de sesión que debe admitir. Configura tú el secreto en tu shell o archivo de configuración. No pegues secretos en el chat. Pide a Codex que la comprobación de configuración de la CLI falle con un mensaje claro cuando falte la autenticación.

Pide a Codex que cree la CLI y la habilidad

Usa el prompt inicial de esta página. Indica qué fuente debe usar Codex como referencia y cuál es la primera tarea que debe admitir la CLI.

Antes de escribir código, Codex debe mostrarte qué comandos propone y cómo se usarían. Solo debe preguntarte por detalles que falten y sin los cuales no pueda crear la CLI.

Verifica que el comando funcione desde cualquier carpeta

Codex debe seguir con las pruebas después de ejecutar cargo run, python path/to/script.py o un comando de un paquete sin instalar. Pídele que pruebe el comando instalado desde otro repositorio o desde una carpeta temporal, tal como lo usaría en una tarea posterior.

Prueba la CLI como lo haría un agente en una tarea futura

Si Codex devuelve un bloque JSON enorme, pídele que acote la respuesta predeterminada y agregue una opción para exportar las cargas útiles completas a un archivo. Si olvida qué operaciones requieren aprobación, pídele que actualice la habilidad que acompaña a la CLI antes de usarla en otra tarea.

Vuelve a usar la habilidad

Cuando vuelvas a necesitar la CLI, invoca la habilidad en lugar de pegar otra vez la documentación:

Para las tareas recurrentes, prueba la habilidad una vez en un chat y luego pídele a Codex que programe desde ese chat una tarea con la misma invocación.