메뉴
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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | fsmaker |
| description | 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. |
fsmaker es una herramienta de línea de comandos (CLI) que genera automáticamente los archivos con la estructura base necesaria para desarrollar plugins en FacturaScripts. Evita escribir código repetitivo a mano y garantiza que los archivos siguen las convenciones del framework.
fsmaker --version
# fsmaker 2.2.0
fsmaker
# o
fsmaker list
| Comando | Descripción |
|---|---|
plugin | Crea la estructura básica de un nuevo plugin |
model | Crea un nuevo modelo con su tabla XML |
controller | Crea un nuevo controlador (Controller, ListController o EditController) |
view | Crea una vista Twig en la carpeta View |
extension | Crea una extensión de tabla, modelo, controlador, XMLView o vista |
init | Crea un archivo Init.php para el plugin |
cron | Crea un archivo Cron.php para el plugin |
cronjob | Crea un nuevo CronJob y lo registra en Cron.php |
worker | Crea un nuevo Worker y lo registra en Init.php |
migration | Crea una nueva migración |
mod | Crea un mod para Modelos (Calculator, HTML Header, Line, Footer) |
api | Genera automáticamente endpoints API REST para los modelos |
test | Crea un nuevo test para el plugin |
run-tests | Ejecuta los tests de FacturaScripts |
translations | Actualiza los archivos de traducción |
upgrade | Actualiza archivos PHP, XML, Twig e INI del plugin |
upgrade-bs5 | Actualiza las vistas XML de Bootstrap 4 a Bootstrap 5 |
github-action | Crea un archivo de GitHub Action para testing |
gitignore | Crea un archivo .gitignore para FacturaScripts |
agent-ai | Copia los archivos de configuración de IA para Claude Code |
zip | Genera un archivo ZIP del plugin actual |
Desde la carpeta raíz de FacturaScripts o dentro del directorio Plugins/:
fsmaker plugin
fsmaker hace preguntas interactivas (nombre, descripción, versión mínima) y genera toda la estructura de carpetas y archivos (facturascripts.ini, Init.php, etc.).
fsmaker model
Genera Model/NombreModelo.php y Table/nombre_tabla.xml con la estructura base.
fsmaker controller
Genera el controlador del tipo elegido (Controller, ListController, EditController) y su XMLView asociado.
fsmaker view
Genera un archivo .html.twig en View/ con la plantilla base.
fsmaker extension
Genera una extensión de modelo, controlador, XMLView, tabla o vista para modificar clases existentes sin tocar su código fuente.
fsmaker test
Genera un archivo de test PHPUnit en Test/ listo para ejecutar.
fsmaker run-tests
Lanza los tests del plugin con PHPUnit (equivalente a vendor/bin/phpunit).
fsmaker cronjob
Genera la clase del job y lo registra automáticamente en Cron.php.
fsmaker worker
Genera la clase Worker y la registra en Init.php.
fsmaker migration
Genera el archivo de migración para cambios estructurales en tablas.
fsmaker api
Genera automáticamente los endpoints REST para los modelos del plugin.
fsmaker translations
Actualiza o sincroniza los archivos JSON de traducción en Translation/.
fsmaker upgrade
Actualiza archivos PHP, XML, Twig e INI para adaptarlos a versiones más recientes del framework.
fsmaker zip
Genera un archivo ZIP del plugin listo para distribuir.
| Situación | Recomendación |
|---|---|
| Estructura inicial de un plugin nuevo | Usar fsmaker plugin |
| Nuevo modelo con tabla | Usar fsmaker model — evita errores en el XML |
| Controlador con XMLView | Usar fsmaker controller — genera los dos archivos |
| Test nuevo | Usar fsmaker test — preconfigura el namespace y clase |
| Añadir columnas/lógica al modelo generado | Editar manualmente el archivo generado |
| Extensiones complejas | fsmaker extension genera la base; completar a mano |
Para consultar la documentación oficial completa sobre migraciones en FacturaScripts, invoca el agente docs-expert que te proporcionará detalles completos directamente desde la documentación oficial del framework.
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.