4.1 KiB
4.1 KiB
| name | description |
|---|---|
| ptop-deliverables | 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 | 색상 팔레트·배너·뱃지 HTML 템플릿 |
| S | 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 배너·뱃지 템플릿을 적용해 아래 파일을 없으면 생성, 있으면 내용 갱신한다.
| 산출물 | 경로 | 채움 소스 |
|---|---|---|
| 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 플랫폼으로 개발한다."