Community라이팅 & 에디팅github.com

studioxvii/modbus-skills

Modbus 엔지니어링을 위한 읽기 전용 스킬 및 워크플로우로, Codex, Claude Code, Cursor 등 다양한 Agent Plugins 클라이언트에서 사용할 수 있습니다.

modbus-skills란 무엇인가요?

이 스킬은 Modbus 통신 프로토콜을 사용하는 산업 자동화 엔지니어링 작업을 지원합니다. 주로 읽기 전용(Read-only) 기능에 초점을 맞추며, Modbus 맵 검증, 체계적인 검사 실행, 오류 및 경고 분석을 자동화합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 동작하도록 설계되었습니다. 입력 JSON 맵 파일을 기반으로 검증 스크립트를 실행하고, 오류(error), 경고(warning), 보류(hold) 세 가지 범주로 결과를 그룹화하여 구조화된 보고서를 생성합니다. 특정 조건(예: 오류나 보류가 남아있는 경우)에서는 최종 생성물을 자동으로 보류하여 품질을 보장합니다. 또한 Modbus 프로토콜의 세부 규칙(예: 유닛 ID 1~247만 허용, 읽기 기능 코드 01~04만 지원)을 엄격히 준수하며, 사람의 개입이 필요한 경우 `review-evidence`나 `review-map` 같은 핸드오프 제안을 제공합니다.

지원 대상✓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에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

검사 맵(Check Map)

결정론적 검사를 실행하고 구조화된 결과를 반환합니다.

../../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까지만 허용합니다.

관련 스킬