CommunityEscrita e Ediçãogithub.com

studioxvii/modbus-skills

Habilidades de engenharia Modbus somente leitura para Codex, Claude Code, Cursor e outros clientes Agent Plugins.

O que é modbus-skills?

Esta skill oferece um conjunto de habilidades de engenharia Modbus somente leitura, projetadas para clientes de agentes de IA como Codex, Claude Code e Cursor. Ela permite executar verificações determinísticas em mapas Modbus, gerando relatórios estruturados de validação. A skill é útil para engenheiros que precisam validar configurações Modbus de forma automatizada e confiável, agrupando problemas por gravidade (erro, aviso, retenção) e por causa raiz. Suporta funções de leitura 01 a 04, aceita IDs de unidade de 1 a 247, e impõe regras rigorosas para evitar suposições sobre ordem de bytes, bits ou convenções de endereçamento. O fluxo de trabalho inclui a execução de um script Python, análise de resultados e sugestões de próximos passos (como revisão de evidências ou planejamento de leituras), garantindo que o processo pare automaticamente na presença de erros ou retenções não resolvidas.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add studioxvii/modbus-skills

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Mapa de Verificação

Execute verificações determinísticas e retorne descobertas estruturadas.

Siga ../../references/interaction-contract.md.

Processo

  1. Execute python3 <skill-dir>/scripts/run.py --input <map.json> --output <validation.json>.
  2. Agrupe as descobertas por error, warning e hold.
  3. Agrupe as descobertas por código e causa raiz; inclua identidades compostas representativas mais a lista completa de IDs afetados no artefato.
  4. Mantenha a geração final em espera automaticamente enquanto um erro ou retenção persistir.

Arquivos de saída

  • validation.json - Abra este relatório. Ele lista verificações aprovadas e agrupa problemas por causa raiz. Ele não cria ou modifica um mapa.

A conclusão exige que cada verificação tenha uma aprovação, descoberta ou motivo de pular visível.

Parar

  • Mantenha a geração final em espera enquanto um erro ou retenção persistir, incluindo numeração de bits compactados.
  • Não adivinhe ordem de byte, ordem de bit, convenção de endereço ou área de registro.
  • Aceite IDs de unidade 1 a 247 apenas. O ID de unidade 0 é proibido porque este pacote não gera requisições de broadcast. IDs de unidade 0 e 255 para gateway Modbus TCP não são aceitos nesta versão.
  • Permita apenas funções de leitura 01 a 04.
  • Pare para escritas, broadcasts, descoberta ou polling ilimitado.

Transferência

  • Descobertas precisam de evidência humana: sugira review-evidence.
  • Numeração de bits compactados ou coils não resolvida: mantenha a retenção; não sugira check-byte-order.
  • O mapa passa e é revisado: sugira plan-reads.
  • A fonte ainda está crua ou mista: sugira review-map.

Use rota, unidade, área, deslocamento de protocolo e identificador de ponto lógico como identidade. Permita apenas funções de leitura 01 a 04.

Habilidades Relacionadas