Community写作与编辑github.com

studioxvii/modbus-skills

适用于 Codex、Claude Code、Cursor 以及其他 Agent 插件客户端的只读 Modbus 工程技能与工作流。

modbus-skills 是什么?

该技能提供了一套针对 Modbus 协议的只读工程工作流,专为 AI 代理(如 Codex、Claude Code、Cursor 等)设计,用于对 Modbus 地图(map)进行确定性检查并返回结构化结果。核心功能是运行一个脚本以验证地图文件,并根据错误、警告和保持(hold)对发现的问题进行分组,同时生成包含受影响 ID 列表的详细报告。该技能严格限制对 Modbus 的读取操作,仅支持功能码 01 至 04,禁止写入、广播、发现或无限制轮询,并强制要求单位 ID 必须在 1 到 247 之间。它通过识别协议偏移、逻辑点等身份标识,帮助开发者快速定位并解决 Modbus 地图中的一致性问题,确保后续读取计划的安全执行。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add studioxvii/modbus-skills

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

检查地图

运行确定性检查并返回结构化结果。

遵循 ../../references/interaction-contract.md。

流程

  1. 运行 python3 <skill-dir>/scripts/run.py --input <map.json> --output <validation.json>。
  2. 将发现的问题按 error、warning 和 hold 分组。
  3. 将发现的问题按代码和根本原因分组;在工件中包含代表性的复合身份标识以及完整的受影响 ID 列表。
  4. 只要存在错误或保持,则自动暂停最终生成。

输出文件

  • validation.json - 打开此报告。它列出已通过的检查并将问题按根本原因分组。它不会创建或修改地图。

完成要求每项检查都有可见的通过、发现或跳过原因。

停止

  • 只要存在错误或保持(包括打包位编号),则暂停最终生成。
  • 不要猜测字节序、位顺序、地址约定或寄存器区域。
  • 仅接受单位 ID 1 到 247。禁止使用单位 ID 0,因为此软件包不会生成广播请求。本版本不接受 Modbus TCP 网关的单位 ID 0 和 255。
  • 仅允许读取功能码 01 至 04。
  • 禁止写入、广播、发现或无限制轮询。

交接

  • 发现的问题需要人工证据:建议使用 review-evidence。
  • 打包位或线圈编号未解决:保持暂停;不要建议 check-byte-order。
  • 地图通过检查并已审查:建议使用 plan-reads。
  • 来源仍为原始或混合状态:建议使用 review-map。

请使用路径、单元、区域、协议偏移和逻辑点标识符作为身份标识。仅允许读取功能码 01 至 04。

相关技能