For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegación principal

Sugerencias
API Dashboard
Probar ChatGPT
Codex

Codex use case

Crea una CLI que Codex pueda usar

Dale a Codex un comando componible para trabajar con una API, una fuente de registros, una exportación o un script del equipo.

Difficulty Intermedio
Time horizon 1 h

Pídele a Codex que cree una CLI componible que pueda ejecutar desde cualquier carpeta, combinar con scripts del repositorio y usar para descargar archivos, y cuyo uso pueda recordar mediante una habilidad complementaria.

Ideal para

  • Trabajo repetitivo en el que Codex necesita hacer búsquedas, leer, descargar contenido o escribir de forma segura al trabajar con el mismo servicio, la misma exportación, el mismo archivo local o el mismo script del repositorio.
  • Herramientas para agentes que necesitan búsquedas paginadas, lecturas exactas por ID, salidas JSON predecibles, archivos descargados, índices locales o comandos que creen borradores antes de escribir.

Contents

    ← Todos los casos de uso

    Crea una CLI que Codex pueda usar

    Dale a Codex un comando componible para trabajar con una API, una fuente de registros, una exportación o un script del equipo.

    Pídele a Codex que cree una CLI componible que pueda ejecutar desde cualquier carpeta, combinar con scripts del repositorio y usar para descargar archivos, y cuyo uso pueda recordar mediante una habilidad complementaria.

    Intermedio
    1 h

    Pídele a Codex que cree una CLI componible que pueda ejecutar desde cualquier carpeta, combinar con scripts del repositorio y usar para descargar archivos, y cuyo uso pueda recordar mediante una habilidad complementaria.

    Intermedio
    1 h

    Enlaces relacionados

    Habilidades Crear habilidades personalizadas

    Ideal para

    • Trabajo repetitivo en el que Codex necesita hacer búsquedas, leer, descargar contenido o escribir de forma segura al trabajar con el mismo servicio, la misma exportación, el mismo archivo local o el mismo script del repositorio.
    • Herramientas para agentes que necesitan búsquedas paginadas, lecturas exactas por ID, salidas JSON predecibles, archivos descargados, índices locales o comandos que creen borradores antes de escribir.

    Habilidades y complementos

    • Cli Creator
      Diseña la interfaz de comandos, crea la CLI, agrega comprobaciones de configuración y autenticación, instala el comando en PATH y comprueba que funcione desde otra carpeta.
    • Skill Creator
      Crea la habilidad complementaria que enseñe a Codex, en tareas posteriores, qué comandos de la CLI debe ejecutar primero y qué acciones de escritura requieren aprobación.
    Skill Why use it
    Cli Creator Diseña la interfaz de comandos, crea la CLI, agrega comprobaciones de configuración y autenticación, instala el comando en PATH y comprueba que funcione desde otra carpeta.
    Skill Creator Crea la habilidad complementaria que enseñe a Codex, en tareas posteriores, qué comandos de la CLI debe ejecutar primero y qué acciones de escritura requieren aprobación.

    Prompt inicial

    Usa $cli-creator para crear una CLI que puedas usar y usa $skill-creator para crear la habilidad complementaria en este mismo chat. Fuente de la que debe aprender: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output]. Primera tarea que la CLI debe admitir: [download failed CI logs from a build URL, search support tickets and read one by ID, query an admin API, read a local database, or run one step from an existing script]. Tarea de escritura opcional: [create a draft comment, upload media, retry a failed job, or read-only for now]. Nombre del comando: [cli-name, or recommend one]. Antes de programar, muéstrame la interfaz de comandos propuesta y pregunta solo por los detalles faltantes que impedirían crearla.
    Usa $cli-creator para crear una CLI que puedas usar y usa $skill-creator para crear la habilidad complementaria en este mismo chat. Fuente de la que debe aprender: [docs URL, OpenAPI spec, redacted curl command, existing script path, log folder, CSV or JSON export, SQLite database path, or pasted --help output]. Primera tarea que la CLI debe admitir: [download failed CI logs from a build URL, search support tickets and read one by ID, query an admin API, read a local database, or run one step from an existing script]. Tarea de escritura opcional: [create a draft comment, upload media, retry a failed job, or read-only for now]. Nombre del comando: [cli-name, or recommend one]. Antes de programar, muéstrame la interfaz de comandos propuesta y pregunta solo por los detalles faltantes que impedirían crearla.

    Introducción

    Cuando Codex trabaja repetidamente con la misma API, fuente de registros, bandeja de entrada exportada, base de datos local o script del equipo, proporciona una interfaz componible para ese trabajo: un comando que pueda ejecutar desde cualquier carpeta, cuyos resultados pueda inspeccionar y acotar, y que pueda combinar con git, gh, rg, pruebas y scripts del repositorio.

    Agrega una habilidad complementaria que registre cuándo Codex debe usar la CLI, qué debe ejecutar primero, cómo mantener breve 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 ayuda a Codex a guardar una habilidad reutilizable, como $ci-logs, que se puede invocar por nombre en tareas futuras.

    Cómo usar

    1. Decide si la tarea necesita una CLI
    2. Comparte la fuente de la que Codex debe aprender
    3. Ejecuta $cli-creator
    4. Prueba el comando instalado
    5. Invoca la habilidad guardada más adelante

    Elige qué debe hacer la CLI

    Empieza por lo que quieres que haga Codex, no por la tecnología en la que quieres que lo programe. Una buena CLI convierte una operación recurrente de lectura, búsqueda, descarga, exportación, creación de borradores, carga, consulta de estado o escritura segura en un comando que Codex puede ejecutar desde cualquier repositorio.

    SituaciónQué puede hacer Codex con la CLI
    Solo se puede acceder a los registros de CI a través de una página de compilación.Aceptar una URL de compilación, descargar en ./logs los registros de los trabajos fallidos y devolver las rutas de los archivos junto con fragmentos breves.
    Los tickets de soporte llegan en una exportación semanal.Indexar la exportación CSV o JSON más reciente, hacer búsquedas por cliente o frase y leer un ticket por su ID estable.
    Una respuesta de una API es demasiado grande para caber en el contexto.Enumerar solo los campos que necesita, leer el objeto completo por ID y exportar la respuesta completa a un archivo.
    Una exportación de Slack contiene hilos largos.Buscar con --limit, leer un hilo y devolver el contexto cercano en vez de todo el archivo.
    Un script del equipo ejecuta cuatro pasos distintos.Dividir la configuración, el descubrimiento, la descarga, la creación de borradores, la carga, la consulta de estado y la escritura en vivo en comandos separados.
    Un complemento encuentra el registro, pero Codex necesita un archivo.Seguir usando el complemento en el chat; usar una CLI para descargar el archivo adjunto, la traza, el informe, el video o el paquete de registros y devolver la ruta.

    Comparte la documentación, los archivos o los comandos

    Codex necesita algo concreto de lo cual aprender: documentación o una especificación OpenAPI, un comando curl con la información confidencial eliminada, una ruta de exportación o base de datos, una carpeta de registros o un script existente. Si quieres que la CLI siga un estilo conocido, pega una salida breve de --help generada por gh, kubectl o la propia herramienta de tu equipo.

    Si el comando necesita autenticación, indícale 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ú mismo el secreto en tu shell o archivo de configuración. No pegues secretos en el chat. Pídele a Codex que la comprobación de configuración de la CLI muestre un error claro cuando falte la autenticación.

    Pídele a Codex que cree la CLI y la habilidad

    Usa el prompt inicial de esta página. Indica la fuente de la que Codex debe aprender y la primera tarea que la CLI debe admitir.

    Antes de que Codex escriba código, debe mostrar la interfaz de comandos propuesta y preguntar solo por los detalles faltantes que impedirían crearla.

    Verifica que el comando funcione desde cualquier carpeta

    Codex no debe detenerse tras ejecutar cargo run, python path/to/script.py o un comando de un paquete que no esté instalado. Pídele que pruebe el comando instalado desde otro repositorio o una carpeta temporal, tal como se usaría en una tarea posterior.

    Prueba la CLI como lo haría un agente en el futuro

    Prueba [cli-name] tal como la usarías en una tarea futura. Muéstrame pruebas de lo siguiente: - command -v [cli-name] se ejecuta correctamente desde fuera de la carpeta del código fuente de la CLI - [cli-name] --help explica los comandos principales - se ejecuta la comprobación de setup/auth - funciona un comando seguro de descubrimiento, listado o búsqueda - funciona un comando de lectura exacta con un ID del resultado del descubrimiento - cualquier registro, exportación, traza o carga útil de gran tamaño se guarda en un archivo y se devuelve la ruta - no se ejecutan comandos de escritura en vivo a menos que yo los haya aprobado explícitamente Luego, lee la habilidad complementaria y dime cuál es el prompt más corto que debo usar cuando vuelva a necesitar esta CLI.

    Si Codex devuelve un bloque JSON enorme, pídele que acote la respuesta predeterminada y agregue la opción de exportar las cargas útiles completas a un archivo. Si olvida el límite de aprobación, pídele que actualice la habilidad complementaria antes de usarla en otra tarea.

    Usa la habilidad más adelante

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

    Usa $ci-logs para descargar los registros de los trabajos fallidos de esta URL de compilación y dime cuál fue el primer paso que falló.
    Usa $support-export para buscar las quejas sobre reembolsos de esta semana y leer los tres tickets de mayor valor.
    Usa $admin-api para encontrar el espacio de trabajo de este usuario, leer el registro de facturación y preparar el borrador de una nota segura para la cuenta.

    Para trabajos recurrentes, prueba la habilidad una vez en un chat y luego pídele a Codex que programe una tarea para esa misma invocación desde el chat.

    Casos de uso relacionados

    Trabajar para alcanzar un objetivo

    Usa `/goal` cuando una tarea requiera que Codex siga trabajando durante varios turnos para...

    Ingeniería Automatización

    Remediar una lista de vulnerabilidades pendientes

    Incorpora hallazgos aprobados de herramientas de gestión de tickets o sistemas de reporte de...

    Ingeniería Calidad

    Auditar incidentes de dependencias

    Usa Codex para convertir un aviso público sobre un paquete o la cadena de suministro en una...

    Ingeniería Calidad