Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Catálogo de habilidades y plugins

Estado: Activo Alcance: público, estado actual Última revisión: 2026-08-12 Responsable: entorno de ejecución de AX Code

Registro descubrible de habilidades integradas y de cómo añadir habilidades de proyecto.

El menú predeterminado / es un plano de control (/plan, /review, /debug, /status, /model). Las habilidades integradas más antiguas siguen siendo solo del agente (herramienta de habilidad). El paquete de fiabilidad del backend también se lista como comandos de barra.

Habilidades integradas (publicadas bajo `packages/ax-code/skills/`)

Habilidad	Propósito	Barra
`debug-n-fix`	Depurar y luego corregir con verificación	Usa `/debug`
`debug-only`	Investigación sin cambios de código	Solo agente
`improve-overall`	Mejoras amplias de calidad	Solo agente
`improve-security`	Mejoras centradas en la seguridad	Solo agente
`mcp`	Orientación de configuración de MCP	Usa `/mcp`
`run`	Lanzar y observar la aplicación	Solo agente
`simplify`	Apretar el código cambiado hace poco	Solo agente
`verify`	Informe de verificación del entorno de ejecución	Solo agente
`verified-change`	Editar solo después de una señal de fallo y luego volver a ejecutar la misma comprobación	`/verified-change`
`safe-db-migration`	Cambios de esquema de ampliación, relleno o contracción, con notas de reversión	`/safe-db-migration`
`api-contract`	Evolución de API o esquema públicos que prioriza lo aditivo	`/api-contract`
`incident-observability`	Diagnóstico de incidentes que prioriza la evidencia, antes de un parche	`/incident-observability`
`auth-boundaries`	Autenticación y autorización, aislamiento de inquilinos, pruebas negativas	`/auth-boundaries`
`queue-worker`	Cambios idempotentes de cola y trabajador, y entrega duplicada	`/queue-worker`
`ruby-on-rails`	Convenciones de Rails sin arrancar el proceso de Rails	Solo agente

Las habilidades usan SKILL.md con frontmatter YAML (name, description, paths opcional, allowed-tools).

Habilidades de proyecto

Coloca las habilidades bajo cualquiera de estas rutas:

.ax-code/skill/<name>/SKILL.md o .ax-code/skills/<name>/SKILL.md
.agents/skills/<name>/SKILL.md (compatibilidad con Agents / Codex)
.claude/skills/<name>/SKILL.md (compatibilidad con Claude Code)
.opencode/skills/<name>/SKILL.md

Lista y valida:

ax-code            # TUI skill dialog
# or use the skill tool from a session

Controles de invocación

AX Code lee estos controles opcionales al descubrir una habilidad:

Ubicación	Campo	Efecto
Frontmatter de `SKILL.md`	`disable-model-invocation: true`	Conserva el comando explícito `/skill-name`, pero excluye la habilidad del descubrimiento del modelo y de las cargas directas de la herramienta del modelo.
Frontmatter de `SKILL.md`	`user-invocable: false`	Omite la habilidad de los comandos de barra; la invocación del modelo sigue disponible salvo que se desactive aparte.
`agents/openai.yaml` hermano	`policy.allow_implicit_invocation: false`	Exige invocación explícita de barra, también para las habilidades importadas mediante `.agents/skills`.

Usa los booleanos YAML true y false. Los controles ausentes conservan los valores predeterminados. Si varias fuentes discrepan, gana una declaración restrictiva. Los tipos de control no válidos o una política de acompañante mal formada desactivan ambos modos de invocación y producen diagnósticos de invocación en el inventario de habilidades y en los registros del entorno de ejecución. Corrige los metadatos antes de usar la habilidad. El acompañante opcional debe ser menor de 64 KiB; allí no se admiten delimitadores de documento YAML ni alias.

Estos controles gobiernan la invocación de la habilidad, con independencia de los permisos existentes del agente. Una mención en lenguaje natural de una habilidad solo manual no autoriza al modelo a cargarla; invoca su comando de barra. Los allowed-tools declarados siguen siendo instrucciones de flujo y no conceden permisos.

Descubrimiento acotado

El modelo recibe al principio resúmenes de habilidades, no las instrucciones completas. Cada bloque de metadatos de habilidad en el prompt de sistema y en la descripción de la herramienta tiene un presupuesto de 8,000 caracteres. Las descripciones se acortan antes de omitir entradas; las recomendaciones coincidentes con archivos tienen prioridad cuando la lista sigue superando ese presupuesto. Un aviso de omisión explica cómo obtener más resúmenes. Es un límite de caracteres, no un recuento de tokens ni una garantía de rendimiento.

La herramienta skill tiene dos modos mutuamente excluyentes:

{"name":"api-contract"} carga una habilidad mediante la comprobación de permiso existente.
{"query":"database"} busca nombres y descripciones aptos sin cargar los cuerpos de las habilidades.
{"query":"","offset":20} continúa un listado usando el nextOffset exacto del resultado anterior.

La búsqueda es literal y no distingue mayúsculas. Las consultas vacías listan las habilidades aptas. Sigue nextOffset hasta que esté ausente. Las habilidades solo manuales y las denegadas por permiso quedan excluidas del descubrimiento del modelo. Las entradas individuales de metadatos sobredimensionadas se omiten con un aviso. Los nombres y la precedencia de origen permanecen sin cambios.

Plugins

Configura los plugins en ax-code.json:

{
  "plugin": ["file:///absolute/path/to/plugin.js"]
}

Los plugins implementan hooks @ax-code/plugin (tool.execute.before, tool.execute.after, shell.env, autenticación, etc.).

Vida de la devolución de llamada

Las fábricas de plugins reciben un lifecycle opcional en su entrada. lifecycle.signal se aborta cuando se desecha la instancia o se retira el plugin. Registra temporizadores, observadores y suscripciones con lifecycle.onDispose(cleanup). La función devuelta anula el registro de esa limpieza. Los registros se ejecutan como máximo una vez; registrar después del desecho inicia la limpieza de inmediato. Las devoluciones de limpieza empiezan en orden inverso de registro, cada una con un presupuesto de un segundo, y pueden terminar de forma concurrente.

Los hooks de transformación reciben un tercer argumento opcional, { signal }; los hooks de configuración y de evento lo reciben como segundo argumento. Esta señal cancela el trabajo mientras la devolución está pendiente; usa lifecycle.signal para el trabajo del que es dueño el plugin más allá de una devolución. Pasa señales a las operaciones abortables. Las devoluciones de inicialización, configuración, evento y transformación tienen un plazo de 15 segundos. Un tiempo de espera retira el plugin de esa instancia y aborta su vida. Las fábricas existentes y los hooks de transformación de dos argumentos siguen funcionando. La ejecución de herramientas personalizadas y la autenticación interactiva conservan sus contratos de ejecución existentes.

Las entradas de transformación son observaciones de solo lectura de datos planos. Muta el borrador de salida y espera todos los cambios antes de volver. Las mutaciones de salida exitosas se hacen visibles en orden de registro; los cambios fallidos o tardíos se descartan. Los cambios de la carga del evento nunca se publican. Una denegación de permiso sigue siendo una denegación, y los hooks de permiso fallidos o retirados exigen preguntar salvo que ya exista una denegación.

Los arrays y los objetos planos se separan del estado del entorno de ejecución. Los esquemas, las funciones y las instancias de clase conservan la identidad y deben tratarse como de solo lectura. Los plugins siguen siendo JavaScript de confianza que se ejecuta en el proceso del entorno de ejecución: la cancelación es cooperativa y no puede detener bucles infinitos síncronos ni deshacer efectos externos.

Paquetes de hooks

Consulta hooks de ciclo de vida para los cinco paquetes oficiales de ciclo de vida (format-after-edit, block-force-push, require-tests-on-stop, protect-env-files, log-bash-commands).

Harness de evaluación

Ejecuta la suite de puerta del entorno de ejecución agéntico y la suite de política de conjunto multimodo:

cd packages/ax-code
pnpm exec vitest run test/harness/agentic-runtime-eval.test.ts
pnpm exec vitest run test/harness/multi-mode-ensemble-eval.test.ts

Consulta también modos de ejecución para local, nube, híbrido, council y arena.