Sistema de habilidades Skills

源码版本v2026.7.20

Responsabilidad

Una Skill es una unidad de capacidad de orden superior respecto a una Tool: un flujo reutilizable con frontmatter (similar a la especificación agentskills.io), clasificado por dominio en skills/<category>/. A diferencia de las herramientas («funciones estáticas»), las habilidades pueden ser creadas, reescritas y refinadas por el bucle de aprendizaje; son el soporte que hace al agent «más listo cuanto más se usa». Las habilidades se exponen al bucle principal a través de skills_tool.

Archivos clave

• directorio skills/ — agrupado por dominio (apple, computer-use, research, software-development, yuanbao…)
• skills_tool — expone las habilidades como herramienta al bucle principal
• skill_manager_tool — gestión de habilidades (listar/ver/activar)
• skills_hub — sincronización con el hub de habilidades (compatible con agentskills.io)
• skills_sync — sincronización local ↔ remoto
• skill_bundles — empaquetado de bundles de habilidades, inyectados en el prompt
• skill_preprocessing — preprocesado del contenido de habilidades
• nodos y aristas de habilidades:125-193 — build_skill_nodes / build_edges, organiza las habilidades en un grafo de aprendizaje

Flujo de datos

1. En el arranque, skill_preprocessing (agent/skill_preprocessing.py) escanea skills/<category>/ y lee el frontmatter.
2. skill_bundles (agent/skill_bundles.py) empaqueta las habilidades relevantes y las inyecta vía build_turn_context:268 en el prompt del turno.
3. El provider decide invocar una habilidad → tool_call: skills → tools/skills_tool.py carga y ejecuta el flujo de esa habilidad.
4. El resultado de la ejecución se devuelve al bucle principal.
5. El bucle de aprendizaje revisa el turno en segundo plano y puede:
   • crear nuevas habilidades (learning_mutations)
   • registrar la nueva habilidad en el grafo de aprendizaje agent/learning_graph.py:125
   • sincronizarla al hub vía tools/skills_sync.py

Resumen

Habilidad = flujo de orden superior evolutivo: el frontmatter lo describe, el archivo lo define, el bucle de aprendizaje lo puede reescribir. Relación con las herramientas: las herramientas son los átomos invocados dentro del flujo de una habilidad; las habilidades son el conocimiento de «cómo combinar herramientas para completar una clase de tareas». La evolución de las habilidades se describe en el bucle de aprendizaje.