---
name: ptop-deliverables
description: >-
  LGES OC5 PtoP Welder 전용 산출물 자동 생성·갱신 스킬.
  프로젝트 소스를 분석해 docs/[Ubisam산출물]/ 하위 MD 산출물(색상 디자인 포함)을
  생성하거나 최신화한다. 다른 PC에서 Git clone 후 이 스킬 한 번으로 전체 산출물
  재생산 가능. "ptop 산출물", "산출물 업데이트", "/ptop-deliverables" 요청 시 사용.
---

# PTOP 산출물 자동 생성 SKILL

LGES OC5 PtoP Welder(`ILSOS_PrismaticRD_PTOP`) 전용.
소스를 분석해 6단계 산출물 MD를 **Ubisam 디자인 시스템**(배너·뱃지·진행률 포함) 기준으로 생성한다.

## 참조 맵

| # | 파일 | 용도 |
|---|---|---|
| D | [references/design-system.md](references/design-system.md) | 색상 팔레트·배너·뱃지 HTML 템플릿 |
| S | [references/source-map.md](references/source-map.md) | 소스 파일 → 산출물 필드 매핑 |

## 소스 진실원 — 읽는 순서

다른 PC에서 실행 시 아래 파일을 순서대로 읽어 산출물을 채운다.

| 순서 | 파일 경로 | 추출 정보 |
|---|---|---|
| 1 | `Machines/ILSOS_PrismaticRD_PTOP/Device/PLC/PLCController.Address.cs` | BIT/WORD 신호 enum 전수 |
| 2 | `Machines/ILSOS_PrismaticRD_PTOP/EquipmentSetup.cs` | 디바이스 등록·메뉴·뷰 목록 |
| 3 | `Machines/ILSOS_PrismaticRD_PTOP/Sequences/SeqAutoRunPTOP.cs` | 시퀀스 노드·인터락·TactTime |
| 4 | `Machines/ILSOS_PrismaticRD_PTOP/Device/IO/PAIX_PTOP.cs` | DI/DO 채널 맵 |
| 5 | `docs/architecture.md` | 플랫폼·모션·디바이스 개요 |
| 6 | `docs/[Ubisam산출물]/_meta/project.yaml` | 프로젝트 코드·팀 정보 |

## 실행 절차

### STEP 0 — 진입 체크
`docs/[Ubisam산출물]/` 폴더 존재 여부 확인.
없으면 `/ubisam-deliverables` 스캐폴딩을 먼저 실행 후 재진입.

### STEP 1 — 소스 분석
소스 진실원 6개를 순서대로 읽어 추출한다:
- PLC BIT/WORD 신호 목록 (eBitInput/Output, eWordInput/Output)
- 등록 디바이스 (PLC·IO·Laser·Scanner·Motion·Vision)
- 메뉴·뷰 트리 (RegisterViews — 권한 레벨 포함)
- 시퀀스 노드 흐름 + 인터락 조건 + 정지/에러 처리
- TactTime 상수 (지연 ms, 타임아웃 s, 루프 슬립)
- DI/DO 채널 번호·신호명·설명 (PAIX_PTOP.cs)

### STEP 2 — 산출물 MD 생성/갱신

[design-system.md](references/design-system.md) 배너·뱃지 템플릿을 적용해
아래 파일을 **없으면 생성, 있으면 내용 갱신**한다.

| 산출물 | 경로 | 채움 소스 |
|---|---|---|
| PLC-PC 신호정의서 | `02.설계/IO_DB설계/PLC_PC_인터페이스_신호정의서.md` | PLCController.Address.cs |
| 모션축·IO 맵 정의서 | `02.설계/IO_DB설계/모션축_IO맵_정의서.md` | EquipmentSetup + PAIX_PTOP |
| 기능명세서 | `02.설계/UIUX_기능설계/기능명세서.md` | EquipmentSetup.RegisterViews |
| 시퀀스·인터락 정의서 | `02.설계/시퀀스_인터록/제어시퀀스_인터락_정의서.md` | SeqAutoRunPTOP.Builder |
| TactTime 산정서 | `02.설계/시퀀스_인터록/TactTime_산정서.md` | SeqAutoRunPTOP 지연 상수 |

각 파일 구조: **배너(진네이비) → 부제(파랑) → 내용 테이블/mermaid → enum 요약**

### STEP 3 — _task 카드 갱신
`01~06` 각 `_task.md` 상태·진행률을 현황 반영해 갱신.
적용 디자인: 상태 뱃지 + 유형 뱃지 + `<progress>` 진행률 바.

### STEP 4 — 분석 로그 기록
`[분석]/YYYY_MM_DD_PTOP설계산출물-분석.md` 작성.
내용: 소스→필드 매핑 표 + 미확정 항목 목록 + 진실원 인덱스.

## 불변 규칙
- **비침습**: `docs/[Ubisam산출물]/` 밖은 읽기만. 소스·CLAUDE.md 수정 금지.
- **MD 200줄 상한**: 초과 시 분할 + 상대경로 링크.
- **출처 명시**: 채운 값마다 `— 출처: 파일명:심볼` 주석.
- **미확정 표기**: 주소·행정·속도 등 미확정값 → `(제안)`.
- **멱등**: 재실행 시 배너·뱃지는 교체, 테이블 데이터는 행 추가/갱신.
- **Aurora 고정 문구**: "운영 SW는 LG PRI의 Aurora 플랫폼으로 개발한다."