CommunityRédaction et éditiongithub.com

studioxvii/modbus-skills

Compétences Modbus en lecture seule pour Codex, Claude Code, Cursor et autres clients Agent Plugins.

Qu'est-ce que modbus-skills ?

Cette compétence technique fournit des flux de travail Modbus déterministes et en lecture seule, conçus pour les agents d'ingénierie dans des environnements comme Claude Code, Codex et Cursor. Elle se concentre sur l'exécution de vérifications validant des fichiers de planification Modbus (map.json) sans les modifier. Le processus principal exécute un script Python qui génère un rapport structuré (`validation.json`), regroupant les problèmes par gravité (erreur, avertissement, blocage) et par cause racine. Avant de finaliser une génération de plan, la compétence exige que toutes les vérifications soient passées, avec des blocages explicites pour les numérotations de bits tassés non résolues ou les configurations invalides (par exemple, ID d'unité 0). Elle interdit strictement les écritures, les diffusions ou les sondages non bornés, et limite les fonctions de lecture autorisées aux codes 01 à 04. Lorsqu'elle doit passer le relais à un autre agent ou workflow, elle utilise des suggestions prédéfinies comme `review-evidence` (pour des preuves humaines) ou `plan-reads` (lorsque la planification est validée).

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

Installed? Explore more Rédaction et édition skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Plan de vérification

Exécutez des vérifications déterministes et renvoyez des résultats structurés.

Suivez ../../references/interaction-contract.md.

Processus

  1. Exécutez python3 <skill-dir>/scripts/run.py --input <map.json> --output <validation.json>.
  2. Regroupez les résultats par error, warning et hold.
  3. Regroupez les résultats par code et cause racine ; incluez des identités composites représentatives ainsi que la liste complète des identifiants concernés dans l'artefact.
  4. Maintenez la génération finale en attente tant qu'une erreur ou un blocage persiste.

Fichiers de sortie

  • validation.json - Ouvrez ce rapport. Il répertorie les vérifications réussies et regroupe les problèmes par cause racine. Il ne crée ni ne modifie un plan.

La complétion exige que chaque vérification ait une raison de réussite, de résultat ou de saut visible.

Arrêt

  • Maintenez la génération finale en attente tant qu'une erreur ou un blocage persiste, y compris la numérotation en bits tassés.
  • Ne devinez pas l'ordre des octets, l'ordre des bits, la convention d'adressage ou la zone de registre.
  • Acceptez uniquement les IDs d'unité de 1 à 247. L'ID d'unité 0 est interdit car ce package ne génère pas de requêtes de diffusion. Les IDs d'unité 0 et 255 de la passerelle Modbus TCP ne sont pas acceptés dans cette version.
  • Autorisez uniquement les fonctions de lecture 01 à 04.
  • Arrêtez-vous pour les écritures, diffusions, découvertes ou sondages non bornés.

Passage de relais

  • Les résultats nécessitent des preuves humaines : suggérez review-evidence.
  • La numérotation des bits tassés ou des bobines n'est pas résolue : maintenez le blocage ; ne suggérez pas check-byte-order.
  • Le plan est validé et révisé : suggérez plan-reads.
  • La source est encore brute ou mixte : suggérez review-map.

Utilisez la route, l'unité, la zone, le décalage de protocole et l'identifiant de point logique comme identité. Autorisez uniquement les fonctions de lecture 01 à 04.

Skills associés