Crea un manual de delegación repetible en ChatGPT con Work Tool y Skill Reference
Usa Work Tool y Skill Reference como manual de operaciones: confirma las herramientas, codifica las habilidades y verifica la salida antes de que la ejecución sea válida.
Trata la referencia como un manual de operaciones
Work Tool y Skill Reference no es un catálogo. Es una superficie de control. Para la delegación de agentes, úsala para decidir qué puede hacer ChatGPT de forma segura, cómo empaquetar trabajo repetible y cómo verificar la salida.
La referencia separa herramientas de habilidades. Las herramientas son endpoints invocables. Las habilidades son paquetes de instrucciones reutilizables. Esa distinción importa. Una herramienta puede invocarse. Una habilidad le dice al agente cómo usar herramientas, archivos y contexto para producir un resultado.
La instantánea documenta 232 interfaces de herramientas y 44 archivos principales de habilidad completos. Es suficiente superficie para construir un manual, pero no suficiente para asumir que cada capacidad está disponible en cada ejecución.
La disponibilidad de herramientas no es fija. Puede variar según la configuración de sesión, los permisos, las aplicaciones conectadas y los plugins instalados. Antes de delegar, confirma que la herramienta requerida esté expuesta. Si falta, no pidas al modelo que la simule. Detente, corrige el entorno o reasigna la tarea.
La referencia de herramientas conserva las descripciones expuestas y las declaraciones de TypeScript. Úsalas como contrato. La descripción te dice qué afirma hacer la herramienta. La declaración te dice qué entradas y salidas espera. Si la declaración es vaga, trata la herramienta como no demostrada.
Para editar archivos, la herramienta apply_patch es una herramienta de edición de archivos de formato libre. Su parche no debe envolverse en JSON. Ese detalle importa. Un parche mal formado puede corromper un archivo o fallar en silencio. Verifica el formato del parche antes de aplicarlo.
Asigna cada tarea delegada a una habilidad
No delegues de forma ad hoc. Asigna la tarea a una habilidad existente o redacta un SKILL.md. La página de la habilidad incluye la fuente actual completa de SKILL.md para cada habilidad disponible. Esa fuente es el punto de partida. Debe indicar la tarea, las herramientas requeridas, las entradas, las salidas, las restricciones y los pasos de verificación.
Una habilidad útil es estrecha. Debe responder: ¿Cuál es el trabajo? ¿Qué herramientas se requieren? ¿Qué archivos o datos se necesitan? ¿Qué formato de salida se espera? ¿Qué cuenta como éxito? ¿Qué modos de fallo son conocidos?
Si una tarea no tiene una herramienta estable, no la codifiques como habilidad. Si la tarea cambia de forma en cada ejecución, no la codifiques como habilidad. Si el resultado no se puede comprobar contra un criterio claro, aún no la delegues.
Los archivos SKILL.md de borrador deben ser cortos. Deben ser operativos. Evita prosa que alabe al modelo. Usa comandos, restricciones y ejemplos. El agente no está leyendo una página de marketing. Está leyendo un procedimiento.
Para trabajo repetible, la habilidad debe incluir un bloque de verificación. El bloque debe listar las comprobaciones que el agente debe ejecutar antes de declarar la tarea completa. Si la tarea es código, incluye pruebas. Si la tarea es un documento, incluye las secciones requeridas. Si la tarea es datos, incluye comprobaciones de esquema o conteos de filas.
Ejecuta el bucle Tool-Skill-Verify
Usa un bucle fijo. Confirma la disponibilidad de herramientas. Asigna la tarea a una habilidad. Define criterios de aceptación. Ejecuta al agente. Verifica la salida contra los criterios. Registra el modo de fallo para la siguiente ejecución.
Paso uno: confirma la herramienta. Revisa la configuración de sesión. Revisa los permisos. Revisa las aplicaciones conectadas. Revisa los plugins instalados. Si la herramienta no está expuesta, registra la brecha. No dejes que el agente adivine.
Paso dos: carga la habilidad. Usa la fuente actual de SKILL.md. Si la habilidad falta, redacta una. Si la habilidad está desactualizada, actualízala. Una habilidad desactualizada es peor que no tener habilidad. Le da al agente una falsa confianza.
Paso tres: define criterios de aceptación. Los criterios deben ser verificables. Escribe un resumen no es un criterio. Produce un resumen de 300 palabras con tres encabezados, sin citas y sin lenguaje en primera persona es un criterio. Ejecuta la compilación no es un criterio. Código de salida 0, sin nuevos errores de lint y el archivo objetivo actualizado es un criterio.
Paso cuatro: ejecuta al agente. Dale la habilidad, la lista de herramientas, las entradas y los criterios. No añadas requisitos ocultos en el prompt. Ponlos en la habilidad.
Paso cinco: verifica la salida. Compara la salida con los criterios. Si la tarea produjo archivos, inspecciona los archivos. Si la tarea produjo código, ejecuta las pruebas. Si la tarea produjo un parche, revisa el diff. Si la tarea produjo datos, valida el esquema.
Paso seis: registra el modo de fallo. Si la ejecución falló, registra qué se rompió. ¿Faltaba la herramienta? ¿La habilidad era ambigua? ¿El parche estaba mal formado? ¿La salida estaba incompleta? El registro es la entrada de la siguiente ejecución.
Construye el manual como un documento vivo
El playbook debe tener tres partes. Un inventario de herramientas. Un índice de habilidades. Un registro de fallos.
El inventario de herramientas lista cada herramienta, su descripción expuesta, su declaración de TypeScript y sus restricciones conocidas. Para apply_patch, anota que el parche no debe envolverse en JSON. Para herramientas con permisos, anota el acceso requerido. Para herramientas que dependen de aplicaciones conectadas, anota la dependencia.
El índice de habilidades lista cada habilidad, su fuente actual de SKILL.md, las herramientas que requiere y los criterios de aceptación que usa. Si una habilidad no está completa, márcala como borrador. Si una habilidad tiene un modo de fallo conocido, márcala como vigilada.
El registro de fallos registra cada ejecución fallida. Debe incluir la tarea, la habilidad usada, las herramientas requeridas, el modo de fallo y la corrección. Con el tiempo, el registro se convierte en la parte más valiosa del manual. Te dice qué tareas es seguro delegar y cuáles no.
El objetivo no es hacer que el agente haga más. El objetivo es hacer que el agente haga la misma cosa correctamente, repetidamente, sin supervisión. Si una tarea no puede superar esa prueba, déjala en manos humanas. Si puede, codifícala, verifícala y registra el resultado.