Documentación de DIXI Spec Kit English · Código en GitHub

Extensiones y presets

Propósito

Mostrar cómo escribir una extensión o un preset desde una carpeta vacía e instalarlo. Una extensión añade operaciones propias junto a las del kit; un preset sustituye el texto de operaciones o plantillas del kit por la versión de tu equipo. Los dos son carpetas locales que solo contienen datos: DIXI copia texto, nunca ejecuta nada de ellas y no usa la red.

Cuál necesitas

QuieresUsaInstala
Añadir una operación que el kit no tieneUna extensiónUn comando nuevo llamado dixi-<id>-<operation>
Cambiar cómo se lee una operación o una plantilla del kitUn presetTu texto en lugar del texto del kit, en el mismo archivo

Una extensión necesita un proyecto creado con un agente: con --agent none no hay archivos de comandos que añadir, y dixi extension add se rechaza. Un preset se acepta en cualquier proyecto; con --agent none no hay archivos de operaciones que sustituir, así que solo pueden aplicarse sus plantillas.

Escribir una extensión

Una carpeta con un manifiesto y un texto por operación e idioma. El repositorio tiene esta en examples/extension-minimal:

extension-minimal/
├── extension.json
└── operations/
    ├── en/deploy-check.md
    └── es/deploy-check.md

extension.json:

{"id": "acme", "version": "1.0.0", "operations": ["deploy-check"]}

Instálala desde la raíz del proyecto:

dixi extension add ../examples/extension-minimal
dixi extension list

La operación queda disponible como dixi-acme-deploy-check: /dixi-acme-deploy-check en Claude Code, $dixi-acme-deploy-check en Codex y la skill dixi-acme-deploy-check en un agente compatible con Agent Skills. El prefijo hace que una extensión nunca pueda tomar el nombre de una operación del kit. Si ya existe un archivo con ese nombre, no se escribe nada.

Para quitarla:

dixi extension remove acme

Borra solo los archivos que instaló y que no editaste; los editados se conservan y se listan.

Escribir un preset

Una carpeta con un manifiesto y los textos que sustituye. El repositorio tiene este en examples/preset-minimal, que le da al traspaso los encabezados propios del equipo:

preset-minimal/
├── preset.json
└── operations/
    ├── en/handoff.md
    └── es/handoff.md

preset.json:

{"id": "team", "version": "1.0.0", "priority": 50}

Instálalo desde la raíz del proyecto:

dixi preset add ../examples/preset-minimal
dixi preset list

Un archivo se sustituye solo cuando se cumple todo esto:

  1. Es un archivo del kit instalado en este proyecto.
  2. No lo has editado: conserva el texto del kit, o el de un preset de menor prioridad.
  3. No hay un archivo para él en .dixi/overrides/. Esa carpeta guarda las versiones propias del proyecto y siempre gana a cualquier preset.

Los archivos que no lo cumplen se conservan y se listan, así que un preset nunca sobrescribe tu trabajo. dixi upgrade tampoco sobrescribe un archivo que un preset sustituyó.

Para quitarlo:

dixi preset remove team

Devuelve el texto del kit a los archivos que aún tienen el texto del preset y conserva los que editaste después.

Qué no hace ninguno de los dos

Relacionado