Desarrollo de skills

Las skills son unidades reutilizables de capacidad de agente en Brazosd. Una skill normalmente describe el conocimiento de negocio, los pasos operativos, las reglas de uso de herramientas y los límites de riesgo para una clase de tareas. Los usuarios pueden vincular skills a agentes para que el agente cargue el contenido correspondiente cuando gestione una tarea relevante.

Las skills son útiles para conservar conocimiento experto dentro de una organización. En lugar de poner todas las reglas en el prompt de un agente, las skills pueden separarse por tema de negocio, mantenerse de forma independiente y reutilizarse en varios agentes.

Cómo afectan las skills a los agentes

Durante la ejecución, un agente ve el nombre, la descripción y el directorio canónico de Cloud Drive de cada skill instalada. Cuando una tarea coincide con una descripción, el agente lee por completo el punto de entrada SKILL.md de ese directorio con la herramienta normal read antes de realizar acciones específicas de la tarea, y carga los archivos vinculados solo cuando son necesarios mediante read y ls.

Este mecanismo reduce la cantidad de contenido en el contexto por defecto. El agente no necesita cargar todas las skills en cada ejecución; sus archivos son archivos normales de Cloud Drive y se cargan progresivamente solo cuando son relevantes.

Vincular una skill cambia el comportamiento del agente en ejecuciones posteriores. Antes de añadir una skill a un agente, confirme que el alcance, los límites de autorización y las reglas de uso de herramientas de la skill coinciden con las responsabilidades del agente.

Contenido de una skill

Una skill es un directorio cuyo punto de entrada es SKILL.md. El front matter YAML contiene el nombre y la descripción; el resto del archivo contiene sus instrucciones. El directorio también puede incluir referencias, scripts, plantillas o recursos vinculados.

El nombre debe describir claramente el tema de la skill. La descripción debe ayudar al agente a decidir cuándo necesita leerla. El cuerpo debe definir el flujo concreto de la tarea, las convenciones de entrada y salida, las herramientas que deben llamarse, las acciones que requieren confirmación del usuario y los límites de negocio que no deben cruzarse.

El cuerpo de la skill no debería contener solo principios abstractos. Para agentes expertos de nivel empresarial, es más valioso dividir los flujos de negocio en pasos ejecutables y explicar qué hacer ante excepciones, permisos insuficientes, información faltante o fallos de sistemas externos.

Skills del sistema y skills de organización

Brazosd proporciona skills del sistema que describen capacidades integradas de la plataforma y flujos básicos de operación. Las skills del sistema son administradas por el inicializador de Brazosd, y los usuarios no deberían editarlas ni eliminarlas en la consola.

Las organizaciones también pueden crear sus propias skills. Las skills de organización son adecuadas para procesos internos, conocimiento sectorial, experiencia de proyectos con clientes y reglas de uso de herramientas privadas. Viven en el directorio .skills de Cloud Drive de la organización y pueden instalarse en agentes de la organización como una referencia de solo lectura o como un clon independiente.

Edición de skills

Las skills se administran con las mismas operaciones read, write, edit, ls, grep, find, copy, mkdir, delete y tree que cualquier otro archivo. Las ediciones en Cloud Drive usan compare-and-swap, por lo que un cambio concurrente produce un conflicto en vez de sobrescribirse silenciosamente. Las referencias siguen los cambios de la skill de origen; los clones permanecen independientes.

Publicación y reutilización

Las skills pueden reutilizarse como activos internos de la organización. Antes de vincular una skill ampliamente, evite incluir información que solo aplique a un cliente, a un proyecto temporal o a contenido que no debería exponerse a todos los agentes que usan esa skill.

Para capacidades que dependen fuertemente de datos privados de la empresa, manténgalas como skills internas de la organización y combínelas con el directorio del agente en el organization drive, otros materiales del cloud drive y brazosd_ctrl para construir agentes expertos orientados al negocio.