CommunityRedacción y edicióngithub.com

studioxvii/modbus-skills

Habilidades de ingeniería Modbus de solo lectura para Codex, Claude Code, Cursor y otros clientes Agent Plugins.

¿Qué es modbus-skills?

Este skill proporciona herramientas para realizar verificaciones deterministas en mapas Modbus, generando informes estructurados con hallazgos agrupados por gravedad (error, advertencia, retención) y por causa raíz. Es útil para ingenieros que trabajan con protocolos Modbus en entornos de IA agente, ya que automatiza la validación de mapas, identifica problemas comunes como convenciones de byte/bit no resueltas o IDs de unidad no permitidos, y detiene la generación automática hasta que se resuelvan los errores. Compatible con Codex, Claude Code, Cursor y otros clientes Agent Plugins, ejecuta scripts de Python locales y produce archivos `validation.json` agrupando los hallazgos. El skill impone restricciones estrictas: solo acepta IDs de unidad del 1 al 247, solo funciones de lectura 01-04, y no permite escrituras, broadcasts o sondeos ilimitados. Además, facilita la transición entre fases del flujo de trabajo sugiriendo acciones como 'review-evidence' para hallazgos que requieren evidencia humana, 'plan-reads' cuando el mapa pasa la validación, o 'review-map' si la fuente está en bruto o mezclada.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add studioxvii/modbus-skills

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Mapa de Verificación

Ejecuta verificaciones deterministas y devuelve hallazgos estructurados.

Sigue ../../references/interaction-contract.md.

Proceso

  1. Ejecuta python3 <skill-dir>/scripts/run.py --input <map.json> --output <validation.json>.
  2. Agrupa los hallazgos por error, warning y hold.
  3. Agrupa los hallazgos por código y causa raíz; incluye identidades compuestas representativas más la lista completa de IDs afectados en el artefacto.
  4. Detiene la generación final automáticamente mientras permanezca un error o retención.

Archivos de salida

  • validation.json - Abre este informe. Lista las verificaciones aprobadas y agrupa los problemas por causa raíz. No crea ni modifica un mapa.

La finalización requiere que cada verificación tenga un pase, hallazgo o razón de omisión visible.

Detenerse

  • Detén la generación final mientras permanezca un error o retención, incluida la numeración de bits empaquetados.
  • No supongas el orden de bytes, orden de bits, convención de direcciones o área de registro.
  • Acepta solo IDs de unidad del 1 al 247. El ID de unidad 0 está prohibido porque este paquete no genera solicitudes de difusión. Los IDs de unidad 0 y 255 de puerta de enlace Modbus TCP no se aceptan en esta versión.
  • Permite solo funciones de lectura 01 a 04.
  • Detente para escrituras, difusiones, descubrimiento o sondeo ilimitado.

Transferencia

  • Los hallazgos necesitan evidencia humana: sugiere review-evidence.
  • La numeración de bits empaquetados o bobinas no está resuelta: mantén la retención; no sugieras check-byte-order.
  • El mapa pasa y se revisa: sugiere plan-reads.
  • La fuente aún está en bruto o mezclada: sugiere review-map.

Usa ruta, unidad, área, desplazamiento de protocolo e identificador de punto lógico como identidad. Permite solo funciones de lectura 01 a 04.

Skills relacionados