review-plc

name review-plc description CODESYS ST 코드 리뷰. PR의 PLC 코드를 Infrastructure 아키텍처, 네이밍 규칙, 시퀀스 데드락, 모듈화 관점으로 분석. 사용법: /review-plc <PR_URL> argument-hint <pr_url> [--no-post] [--no-save] allowed-tools Bash(python3 *), Read, Grep, WebFetch /review-plc - CODESYS ST PLC 코드 리뷰 PR URL을 입력받아 CODESYS Structured Text 코드를 PLC 도메인 전문 관점으로 분석하고, 구조화된 리뷰 코멘트를 PR에 자동으로 게시합니다. 대상 코드 CODESYS V3.5 Structured Text (.ST) PLCOpenXML (.xml) Infrastructure Library V2.0 기반 모듈 코드 UnifyPlasma 프로젝트 코드 옵션 옵션 설명 (없음) 리뷰 + PR 코멘트 게시 + 로컬 MD 저장 --no-post PR 코멘트 게시 생략 (분석만) --no-save 로컬 MD 저장 생략 필수 실행 워크플로우 아래 단계를 반드시 순서대로 실행하세요. 건너뛰지 마세요. Step 1: 인자 파싱 사용자 입력에서 PR URL과 옵션을 파싱합니다. 입력: <pr_url> [--no-post] [--no-save] Step 2: PR 데이터 수집 python3 ../review-pr/scripts/review_pr.py fetch <pr_url> JSON 출력을 분석합니다. diff_file 키가 있으면 diff가 별도 파일로 저장된 것이므로 Read 도구로 해당 파일을 읽으세요. Step 3: 코드 분석 & 리뷰 작성 diff 전체를 읽고 reference.md 의 10가지 PLC 전문 관점 으로 분석합니다. plc-architecture-guide.md 의 아키텍처 패턴, 네이밍 규칙, 표준 실행 패턴을 기준으로 코드를 검증합니다. 특히 다음에 집중합니다: Infrastructure 아키텍처 패턴 준수 여부 네이밍 규칙 (C/T/E 접두사, 리소스 접두사) 시퀀스 로직 데드락 가능성 모듈 생명주기 (Types → Interface → Class → Resources → Registration) 표준 실행 패턴 (IsReady → ProcessControlData → StateMachine → ProcessMonitoringData) reference.md 의 출력 포맷 에 맞춰 구조화된 리뷰를 작성합니다. /tmp/review_pr_{id}.md 에 임시 저장합니다. 리뷰 언어 : 한국어로 작성합니다. Step 4: PR에 코멘트 게시 --no-post 옵션이 없는 경우 에만 실행합니다. python3 ../review-pr/scripts/review_pr.py comment <pr_url> < /tmp/review_pr_{ id }.md Step 5: 로컬 MD 저장 --no-save 옵션이 없는 경우 에만 실행합니다. 파일명 정보 조회: python3 ../review-pr/scripts/review_pr.py save <pr_url> /tmp/review_pr_{id}.md 내용을 reviews/{filename} 에 저장합니다. reviews/ 디렉토리가 없으면 생성합니다. Step 6: 결과 요약 사용자에게 결과를 요약하여 보여줍니다: 리뷰한 PR 정보 (제목, 브랜치, 작성자) 발견한 이슈 수 (머지 전 확인 필요 / 개선 권장) 최종 판정 (APPROVED / APPROVED with suggestions / CHANGES REQUESTED) 코멘트 게시 여부 및 URL MD 저장 경로 추가 리소스 PLC 아키텍처 가이드 (리뷰 기준): plc-architecture-guide.md PLC 리뷰 관점 및 출력 포맷: reference.md 사용 예시: ../review-pr/examples.md API 헬퍼 스크립트: ../review-pr/scripts/review_pr.py