fs-claude-plugin

Crea un modelo de FacturaScripts con su clase PHP y archivo XML de tabla.

Configura la ruta de módulos MCP locales privados en ~/.fs-claude.json

Redacta en pantalla (sin crear ningún archivo) un texto en formato markdown, listo para copiar y pegar, que explica las novedades, mejoras y correcciones de un plugin o proyecto de FacturaScripts a partir de un rango de commits o de versiones. Activa esta skill siempre que el usuario pida "redacta las novedades", "escribe la noticia de los cambios", "genera el changelog", "qué ha cambiado desde la versión X", "resume los cambios entre la versión X y la Y", "prepara el anuncio de la nueva versión", o cualquier variación en la que se pida comunicar qué se ha hecho en un rango de commits o entre dos versiones.

Guía para añadir una nueva conexión de FacturaScripts al archivo de configuración

Sincroniza modelos del MCP fs-mcp con sus fuentes (FacturaScripts core o plugins privados). Detecta columnas nuevas/modificadas/eliminadas, mantiene las descripciones unificadas en los archivos de overrides, regenera la metadata y compila si hace falta. Soporta uno o varios modelos, ruta local o URL de GitHub, y un modo "refresh masivo" para auditar todos los modelos del catálogo y actualizar la versión registrada de FacturaScripts.

Responde preguntas sobre cómo usar FacturaScripts consultando la documentación oficial de usuarios a través del agente especializado `docs-expert`. ACTIVAR SIEMPRE que el usuario pregunte cómo hacer una operación, dónde encontrar una función, cómo fluye un proceso (presupuesto→factura), cómo gestionar clientes, inventario, compras, contabilidad, o cualquier aspecto práctico de uso del ERP. También activar cuando Claude necesite explorar la documentación de usuario antes de responder sobre procedimientos — no esperar a que el usuario pregunte explícitamente. No esperes a que mencione "documentación" — si la pregunta o tarea involucra procedimientos operativos en FacturaScripts, activa esta skill.

Analiza y corrige bugs en plugins de FacturaScripts. ACTIVAR cuando el usuario describa un comportamiento incorrecto, algo que "no funciona como debería", un error inesperado, datos incorrectos generados por el código, o pida "revisa el plugin", "busca el error", "algo falla", "hay un problema con", "verifica el código", "comprueba dónde está el fallo". También activa cuando Claude necesite explorar código de un plugin FacturaScripts para entender su funcionamiento antes de modificarlo. No esperes a que el usuario use la palabra "bug" — cualquier descripción de comportamiento incorrecto o inesperado en un plugin de FacturaScripts activa esta skill. Orquesta docs-expert (comportamiento esperado según el framework), backend-developer (análisis y corrección del código) y testing-expert (test que reproduce y verifica la corrección del bug).

Diseña y crea endpoints REST API en FacturaScripts delegando al agente especializado `api-designer`. ACTIVAR SIEMPRE que el usuario pregunte o pida trabajar con: la API REST de FacturaScripts, endpoints de modelos (GET, POST, PUT, DELETE), endpoints personalizados (ApiController, Kernel::addRoute, ApiRoot::addCustomResource), autenticación por token API, filtros y paginación en la API, conexión entre instancias de FacturaScripts vía API, cliente HTTP (Http::get/post), subida/descarga de archivos por API, o creación de facturas/documentos vía API. Si la tarea involucra cualquier aspecto de la API REST, activa esta skill.

Explica cómo usar la API REST de FacturaScripts para listar, crear, modificar y eliminar registros, y cómo añadir endpoints personalizados desde un plugin. Úsalo cuando el usuario pregunte sobre la API REST, endpoints, autenticación con API key, o cómo crear endpoints personalizados en un plugin.

Desarrolla componentes backend de FacturaScripts delegando al agente especializado `backend-developer`. ACTIVAR SIEMPRE que el usuario pida crear o modificar: modelos PHP (ModelClass, ModelOnChangeClass, BusinessDocument), tablas XML, Workers para eventos asíncronos, Cron jobs para tareas periódicas, migraciones de datos, validaciones en validate(), acceso a base de datos (DbQuery, Where, DataBaseWhere), relaciones entre modelos, traits de modelos, lógica contable (Asiento, Partida, Subcuenta, Ejercicio, CuentaEspecial, getSubcuenta, codejercicio, asientos contables, plan contable), o cualquier lógica de negocio en PHP para un plugin de FacturaScripts. No esperes a que el usuario mencione "backend" — si la tarea involucra crear/modificar un modelo, worker, cron, migración, asiento contable o lógica PHP del lado servidor, activa esta skill inmediatamente.

Crea controladores de FacturaScripts (Controller con vista Twig, ListController, EditController o PanelController) con su vista asociada.

Crea extensiones de FacturaScripts para modificar modelos, controladores o vistas del core o de otros plugins sin modificar su código fuente.

Crea, usa y extiende vistas Twig en FacturaScripts, incluyendo herencia desde Core o plugins y ganchos para extensión por otros plugins.

Crea la estructura completa de un nuevo plugin para FacturaScripts con todos los archivos necesarios.

Crea o modifica archivos XMLView de FacturaScripts para definir columnas, widgets, filtros y acciones en vistas.

Explica cómo funcionan las tareas periódicas (cron jobs) en FacturaScripts mediante el archivo Cron.php y la clase CronClass.

Guía para depurar, testear y verificar código en FacturaScripts usando el modo debug, logs y PHPUnit.

Responde preguntas de programación sobre FacturaScripts consultando la documentación oficial a través del agente especializado `docs-expert`. ACTIVAR SIEMPRE que el usuario pregunte cualquier cosa relacionada con desarrollo en FacturaScripts: cómo implementar o usar modelos, controladores (ListController, EditController, PanelController), vistas (XMLView, widgets, filtros, addListView, addEditView, addHtmlView), extensiones de modelos y controladores, workers, eventos, cron, API REST, plugins, Twig, migraciones, traducciones, permisos, caché, email, base de datos, o cualquier clase/método del core. También activar cuando Claude necesite explorar o entender el funcionamiento de un plugin o clase de FacturaScripts antes de modificarlo — no esperar a que el usuario pregunte explícitamente. No esperes a que el usuario mencione "documentación" o "docs-expert" — si la pregunta o tarea involucra código PHP o lógica específica de FacturaScripts, activa esta skill inmediatamente.

Usa este agente para trabajar con documentos de compra y venta en FacturaScripts: presupuestos, pedidos, albaranes y facturas (tanto de cliente como de proveedor). Especialista en BusinessDocument, BusinessDocumentLine, SalesDocument, PurchaseDocument, Calculator, CalculatorMod, Mods de cabecera/líneas (SalesModInterface, PurchasesModInterface, SalesLineModInterface), conversión entre documentos, estados de documentos, series, impuestos, retenciones y toda la lógica de negocio de documentos del ERP.

Crea extensiones de FacturaScripts delegando al agente especializado `extension-developer`. ACTIVAR SIEMPRE que el usuario pida modificar el comportamiento de modelos, controladores, vistas XMLView, tablas o plantillas Twig del core o de otros plugins SIN modificar su código fuente. Esto incluye: extensiones de controladores (hooks createViews, loadData, execPreviousAction, execAfterAction), extensiones de modelos (hooks saveInsert, saveUpdate, delete, validate), extensiones de XMLView (añadir columnas con overwrite), extensiones de tablas (añadir columnas), extensiones de vistas Twig (getIncludeViews), y Mods para documentos de compra/venta (SalesModInterface, PurchasesModInterface, CalculatorModInterface). Si el usuario dice "modificar", "extender", "añadir campo a" un controlador/modelo/vista del core o de otro plugin, activa esta skill inmediatamente.

Desarrolla la capa frontend de FacturaScripts delegando al agente especializado `frontend-developer`. ACTIVAR SIEMPRE que el usuario pida crear o modificar: plantillas Twig (.html.twig), herencia de plantillas (MenuTemplate, MicroTemplate), JavaScript personalizado, CSS/SCSS, integración con Bootstrap 5, gestión de assets con AssetManager, funciones Twig personalizadas (Html::addFunction), macros Twig, o extensiones de vistas Twig (getIncludeViews). No esperes a que el usuario mencione "frontend" — si la tarea involucra plantillas Twig, JavaScript, CSS o assets visuales, activa esta skill inmediatamente.

Explica y usa la herramienta CLI fsmaker para generar automáticamente la estructura base de plugins, modelos, controladores, extensiones, tests y otros archivos de FacturaScripts.

Crea funcionalidades completas end-to-end en FacturaScripts delegando al agente especializado `fullstack-developer`. ACTIVAR SIEMPRE que el usuario pida crear una funcionalidad que abarque varias capas: modelo + tabla + controlador + vista. Por ejemplo: un CRUD completo, una nueva entidad con listado y formulario de edición, un PanelController con múltiples pestañas, o cualquier funcionalidad que requiera crear archivos en Model/, Table/, Controller/, XMLView/ y opcionalmente View/, Worker/, Translation/ e Init.php. Si la tarea es claramente "crear algo completo de principio a fin", activa esta skill.

Explica cómo crear y registrar migraciones en FacturaScripts para ejecutar cambios en datos de la base de datos una única vez tras instalar o actualizar un plugin.

Explica cómo crear y registrar mods en FacturaScripts para modificar visualmente o en el controlador los documentos de compra y venta (presupuestos, pedidos, albaranes, facturas).

Usa este agente para escribir código PHP idiomático y de calidad en FacturaScripts: patrones PHP 8.0+ específicos del framework (Closures para extensiones, traits de modelos, herencia de ModelClass/ControllerClass), cumplimiento PSR-12, uso correcto de la clase Tools (noHtml, fixHtml, trans, log, date, money, settings), patrones de Init.php, refactorización de código PHP, resolución de errores y análisis de calidad con PHPStan y CS-Check.

Buenas prácticas para crear commits de git claros, atómicos y bien estructurados en español. Activa esta skill siempre que el usuario pida hacer un commit, confirmar cambios, guardar cambios en git, o cualquier variación de "haz commit", "commitea", "sube los cambios", "guarda en git", "git commit", etc. También cuando el usuario pida revisar o mejorar un mensaje de commit existente.

Buenas prácticas para crear pull requests bien estructurados en español, incluyendo la creación de ramas con convención de nombres y enlaces a tareas del roadmap de FacturaScripts. Activa esta skill siempre que el usuario pida crear un pull request, una PR, un merge request, crear una rama nueva, hacer push de una rama, o cualquier variación como "abre una PR", "crea el pull request", "sube la rama", "prepara la PR", "crea una rama para la tarea X", "branch para el issue X", etc. También cuando pida revisar o mejorar una PR existente.

Usa este agente para cualquier tarea relacionada con base de datos en FacturaScripts: diseñar esquemas de tabla XML, optimizar consultas con DbQuery y Where, crear índices y constraints, escribir migraciones SQL, analizar rendimiento de queries, usar transacciones, trabajar con DataBaseWhere/DataBase/DbQuery, diseñar relaciones entre tablas (belongsTo, hasMany), y resolver problemas de rendimiento en MySQL/PostgreSQL. Especialista en la capa de datos del ERP.

ACTIVAR SIEMPRE que el usuario mencione tests, PHPUnit, TestCase, archivos *Test.php, o pida revisar, crear, comprobar, completar o verificar tests en FacturaScripts. No esperes a que el usuario pida "escribir un test" explícitamente — cualquier pregunta sobre si existe un test para una funcionalidad, si falta cobertura, o si un comportamiento está probado activa esta skill. Úsalo para: revisar tests existentes y detectar casos que faltan, escribir tests PHPUnit para modelos y controladores, ejecutar tests (fsmaker test, composer test), análisis estático con PHPStan, verificación de estilo con CS-Check/CS-Fix, diagnóstico de errores en plugins, modo debug (FS_DEBUG), logging con Tools::log(), y verificación de que extensiones, migraciones y workers funcionan correctamente. También cubre tests contables: asientos (Asiento, Partida), subcuentas (Subcuenta, codejercicio), ejercicios (Ejercicio, loadFromDate, installAccountingPlan), tests multi-ejercicio (documento en un año, pago en otro), uso de DefaultSettings

Diseña interfaces de usuario de FacturaScripts delegando al agente especializado `ui-designer`. ACTIVAR SIEMPRE que el usuario pida crear o modificar: archivos XMLView (columnas, widgets, grupos, filas), definir widgets (text, select, autocomplete, money, date, checkbox, textarea, color, password, file, link, datalist), configurar filtros (addFilterSelect, addFilterCheckbox, addFilterSelectWhere, addFilterNumber, addFilterPeriod), definir filas de estado (row-status), acciones (row-actions), estadísticas (row-statistics), cabeceras/pies (row-header/footer), o crear modales en XMLView. Si la tarea es sobre cómo se ve o se interactúa con un formulario o listado en FacturaScripts, activa esta skill.

Explica cómo funcionan los workers y la cola de trabajos en FacturaScripts para ejecutar procesos en segundo plano mediante eventos.

Analiza las ventas del período y genera un informe ejecutivo con cifras clave, comparativas y tendencias

Identifica clientes con deuda pendiente y genera un informe de cobro con prioridades de seguimiento

Asistente para aprender y resolver dudas sobre cómo usar FacturaScripts

Crea un informe personalizado con los datos de FacturaScripts que necesitas para tu análisis

Identifica productos con stock por debajo del mínimo y genera alertas de reposición

Lista todas las conexiones de FacturaScripts configuradas en el plugin