comitsrl-skills

Coleccion de skills (formato skills.sh) para agentes que trabajan en proyectos de COMIT SRL, con foco en desarrollo de plugins/modulos para iDempiere (OSGi + Maven/Tycho + ZK + PostgreSQL).

Prerequisitos

• Node.js (LTS recomendado) con npm y npx.
• Verificar instalacion:

node -v
npm -v
npx -v

Si npx no esta disponible, normalmente falta instalar/actualizar Node.js + npm.

Instalacion (skills.sh)

Ver skills disponibles en este repo (no instala nada):

npx skills add comitsrl/comitsrl-skills --list

Tambien funciona con la URL completa del repo (ej: https://github.com/comitsrl/comitsrl-skills).

Instalar una skill (recomendado):

npx skills add comitsrl/comitsrl-skills --skill idempiere-plugin-development

Instalar todas las skills (solo si tiene sentido para tu proyecto):

npx skills add comitsrl/comitsrl-skills --skill '*'

Listar skills instaladas (esto muestra instaladas, no las del repo remoto):

npx skills list

Nota: npx skills add ... --skill <nombre> instala solo esa skill (carpeta skills/<nombre>/), no clona el repo completo.
Para ver todo el contenido del repo, usa GitHub o git clone.

Uso (prompts)

En tu prompt, referencia la skill por nombre (con $):

Usa $idempiere-plugin-development para implementar este requerimiento como plugin iDempiere.

Que skill usar

• Si el cambio es codigo OSGi / procesos / callouts / validators -> idempiere-plugin-development
• Si hay upgrade/migracion de version iDempiere -> idempiere-version-upgrade
• Si hay diccionario/DB/migraciones -> idempiere-db
• Si hay Pack In/Out, handlers 2Pack o instalacion automatica de 2Pack -> idempiere-2pack
• Si hay UI ZK (ZUL/MVVM) o themes Stage/Prod -> idempiere-zk
• Si hay contrato API (OpenAPI) para integraciones/POS/portales -> idempiere-openapi
• Si el trabajo es retail (POS, inventario, promos, devoluciones, e-commerce/omnichannel, analytics) -> idempiere-retail-expert
• Si hay AI (dev, RAG, LLM->SQL, agentes, "conciencia empresarial") -> idempiere-ai
• Si hay CI/CD, versionado, changelog, releases -> comitsrl-ci-release

Convencion de commits (.githooks)

Este repo usa Conventional Commits (validado por ./.githooks/commit-msg).

Para activar los hooks en tu clone:

git config core.hooksPath .githooks

Skills incluidas

idempiere-plugin-development

Desarrollo de plugins/modulos iDempiere desacoplados del core (OSGi bundles + Maven/Tycho).

• Usar cuando: hay que agregar/modificar funcionalidad via plugin (procesos, callouts, validators, event handlers, forms ZK, integraciones OSGi).
• Entregables tipicos: bundle OSGi, registro en AD_* cuando aplique, feature/update-site, instrucciones de instalacion/upgrade.
• Coordina con: idempiere-db (schema/diccionario), idempiere-zk (UI/themes), idempiere-openapi (contratos).

Ejemplo:

Usa $idempiere-plugin-development para crear un SvrProcess nuevo y registrarlo en AD_Process.

idempiere-version-upgrade

Playbook para upgrades/migraciones entre versiones iDempiere (minor/major) con riesgo controlado.

• Usar cuando: hay que actualizar un entorno, migrar desde ADempiere/Compiere, o resolver scripts/errores post-upgrade.
• Entregables tipicos: plan de migracion, restore/rollback, ejecucion iterativa de scripts, verificacion post-migracion.

Ejemplo:

Usa $idempiere-version-upgrade para planificar el upgrade 10 -> 11, con checklist y rollback.

idempiere-db

Cambios de DB y Data Dictionary para iDempiere/plugins (PostgreSQL) con migraciones repetibles.

• Usar cuando: hay DDL, metadata AD_*, data fixes, performance/indices, o necesidad de rollback.
• Entregables tipicos: scripts/mecanismo de migracion, convenciones de EntityType, verificacion en DB limpia y con datos.

Ejemplo:

Usa $idempiere-db para agregar una tabla con auditoria multi-tenant y su migracion PostgreSQL.

idempiere-2pack

Flujo completo de 2Pack en iDempiere: Pack Out/Pack In, handlers OSGi, activators de instalacion automatica y troubleshooting.

• Usar cuando: hay que exportar/importar diccionario o datos por 2Pack, diagnosticar AD_Package_Imp*, o instalar 2Pack.zip / 2Pack_*.zip en plugins o carpetas.
• Entregables tipicos: estrategia de packin, diseno de AD_Package_Exp_Detail, validacion de handlers/orden/versionado, mitigaciones de riesgo (SQL/Shell/JSR223).
• Coordina con: idempiere-db (DDL/diccionario), idempiere-plugin-development (bundle/feature/update-site).

Ejemplo:

Usa $idempiere-2pack para preparar un pack out de diccionario+datos y definir su instalacion incremental en un plugin con 2Pack_*.zip.

idempiere-zk

UI iDempiere en ZK (ZUL/MVVM) y personalizaciones de tema (incluye diferenciacion Stage vs Produccion).

• Usar cuando: hay que crear/modificar pantallas ZK, formularios/componentes, o empaquetar un theme en plugin.
• Entregables tipicos: recursos ZUL/CSS/imagenes dentro del bundle, registro y activacion (ZK_THEME/SysConfig), checklist UX.

Ejemplo:

Usa $idempiere-zk para crear un tema STAGE basado en iceblue_c y empaquetarlo como bundle.

idempiere-openapi

Contrato OpenAPI (3.1 preferido) para APIs iDempiere: integraciones, POS, portales y middleware.

• Usar cuando: se necesita diseno contract-first, schemas, seguridad (OAuth2/JWT), ejemplos, versionado semver.
• Entregables tipicos: spec versionada, coleccion Postman, stubs/SDKs, contract tests (segun el repo).

Ejemplo:

Usa $idempiere-openapi para versionar un contrato /sales/orders con errores 422 y seguridad por scopes.

idempiere-retail-expert

Playbook retail end-to-end sobre iDempiere: POS, inventario/stock, pricing/promos, devoluciones/cambios, e-commerce/omnichannel y analytics (KPIs).

• Usar cuando: el problema es retail (operacion tienda/caja) u omnicanal (online + tiendas) con necesidad de contratos, migraciones y reporting.
• Entregables tipicos: plugin OSGi retail/POS, contrato OpenAPI, migraciones DB/diccionario, vistas/KPIs (y opcional NLQ con guardrails).
• Coordina con: idempiere-plugin-development, idempiere-db, idempiere-openapi, idempiere-ai, idempiere-zk.

Ejemplo:

Usa $idempiere-retail-expert para disenar un POS offline-first con idempotencia y sync, integrarlo a e-commerce por OpenAPI, y definir KPIs retail con vistas semanticas.

idempiere-ai

Adopcion de AI en proyectos iDempiere: productividad de desarrollo y acceso conversacional a datos, con guardrails.

• Usar cuando: queres Copilot/LLMs para acelerar dev, RAG, LLM->SQL, o agentes que ejecutan intenciones con control humano.
• Puntos clave: multi-tenant, whitelists, modelo semantico via views, auditoria/observabilidad, HITL.
• Incluye: marco de "conciencia empresarial" (Percepcion/Memoria/Intencion/Gobernanza) y templates de Control Tower + Data Contract minimo.

Ejemplo:

Usa $idempiere-ai para disenar un chatbot LLM->SQL solo-lectura, con views semanticas y logging completo.

comitsrl-ci-release

CI/CD y releases reproducibles para repos COMIT SRL (iDempiere/plugins): build, tests, artefactos, versionado y notas.

• Usar cuando: hay que crear/ajustar pipeline (GitHub Actions), publicar artefactos (p2/update-site, jars, zips), o estandarizar semver/changelog.
• Entregables tipicos: workflow CI, convencion de tags, generacion de CHANGELOG.md/release notes, gates de calidad.

Ejemplo:

Usa $comitsrl-ci-release para armar un workflow que build/testee Tycho y publique un GitHub Release con changelog.