Community寫作與編輯github.com

studioxvii/modbus-skills

唯讀 Modbus 工程技能與工作流程,適用於 Codex、Claude Code、Cursor 及其他 Agent Plugins 用戶端。

modbus-skills 是什麼?

此技能提供一組唯讀的 Modbus 工程工作流程與檢查表,專為 Codex、Claude Code、Cursor 等 AI 代理程式用戶端設計。其主要功能是執行確定性檢查,驗證 Modbus 映射(map)檔案的正確性,並產出結構化的驗證報告。技能使用 Python 腳本進行運算,根據錯誤、警告及保留(hold)等嚴重程度分組發現,並自動將發現與對應的 Modbus 實體(如路由、單元、區域)關聯。它僅允許讀取功能碼 01 至 04,並嚴格限制單元 ID 為 1 至 247,禁止寫入、廣播、探索或無界輪詢。若發現未解決的錯誤或保留,技能會阻止最終輸出生成,確保映射在進入下一階段前已通過驗證。

相容平台✓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。

相關技能