7.7 KiB
| name | description |
|---|---|
| ubisam-format-map | Ubisam 협업관리 양식의 공통 enum·스키마·단계↔산출물 슬롯 매핑 레퍼런스. 상태(4종)·일감유형(9종)·진행 6단계(분석/협의·설계·제작·셋업·양산·CS)·일감/프로젝트 필드 스키마·티켓 코드 규칙을 제공. Ubisam 양식으로 산출물을 재생산·재배치·검증하거나, 타사 양식 문서를 Ubisam 단계로 매핑할 때 반드시 이 스킬을 먼저 읽을 것. "Ubisam 양식", "협업관리", "일감 6단계", "산출물 슬롯", "상태/유형 enum" 언급 시 사용. 구분 — 이 스킬은 **조회 전용 사전**이다. 실제로 산출물을 만들거나 고치는 것은 `ubisam-deliverables`(트리 생성)·`ubisam-deliverable-rebuild`(기존 문서 재생산)·`ptop-deliverables`(소스 기준 MD)다. |
Ubisam 협업관리 양식 맵 (Format Map)
타사 양식 산출물을 Ubisam 협업관리 양식으로 재생산·재배치·검증할 때의 단일 기준 사전이다. 근거 원본(스크린샷 분석)은 아래를 참조하며, 값이 갱신되면 이 파일과 원본을 함께 고친다.
docs/[Ubisam산출물]/[분석]/_ubisam-협업관리-용어집(skill-ref).md— enum 사전(원본)docs/[Ubisam산출물]/[분석]/2026_06_29_협업관리-프로젝트관리-분석.md— 단계별 산출물 정의 상세docs/[Ubisam산출물]/ref/— 화면 캡처
⚠ 위 3개 경로는
ubisam-deliverables스캐폴딩 이후에만 존재하며,docs/[Ubisam산출물]/은.gitignore제외 대상이라 clone 직후에는 없다. 없으면 본문 §1~§5를 유일 기준으로 삼고, 본문이 답하지 못하는 항목은미정 — 확인 필요로 남긴다. 없는 파일을 찾다 멈추지 말 것.
1. 상태(Status) enum — 4종 (전이 순서)
해야 할 일 → 분석 진행 → 업무 진행중 → 진행 완료
아래 ARGB는 xlsx 셀 채우기용이다. MD·HTML 뱃지 색은
ubisam-deliverables/references/02-enums.md의 HEX 표를 쓴다 (같은 상태, 다른 용도).
| 상태 | 색(ARGB · xlsx) | 칸반 컬럼 |
|---|---|---|
| 해야 할 일 | FFD9D9D9 (회색) |
Todo |
| 분석 진행 | 미확인 — 원본 스크린샷에서 확인 후 기입 | Select For dev |
| 업무 진행중 | FF8FAADC (파랑) |
InProgress |
| 진행 완료 | FFA9D08E (연두) |
Done |
분석 진행은 이전 판에서업무 진행중과 같은 ARGB(FF8FAADC)로 잘못 적혀 있었다. 같은 색이면 조건부서식이 두 상태를 구분하지 못한다. 실제 값을 확인하기 전까지 지어내지 말고미확인으로 두고, 확인되면 이 표를 고친다. 실제 파일 색이 표와 다르면 파일이 진실원이다.
상태 문자열은 위 4개만 사용한다. 임의 변형(예: "완료", "진행중") 금지 — 칸반/조건부서식 매칭이 깨진다.
ARGB가
미확인인 상태는 셀 채우기 없이 문자열만 기입하고 그 사실을 작업 로그에 남긴다. 색을 지어내면 조건부서식이 잘못 매칭된다.
2. 일감 유형(Type) enum — 9종
오류수정 · 불합리 · 미팅 · 설계 · 개발 · 제작 · 입고셋업 · 적용 및 모니터링 · 요청대응
3. 진행 6단계 ↔ 기본 일감유형 ↔ 산출물 슬롯
| # | 단계 | 기본 유형 | 핵심 산출물(슬롯) |
|---|---|---|---|
| 1 | 분석/협의 | 미팅 | 사양서, CR회의록, 마스터플랜, URS 분석/제어 시나리오 검토 |
| 2 | 설계 | 설계 | HMI 화면정의서·UI 스토리보드·기능명세서 / 시퀀스 다이어그램·인터록 정의서 / 통신맵(Memory·IO·Register)·DB 스키마 / D/R 회의록 |
| 3 | 제작 | 제작 | 개발환경·핵심모듈·UI/메인 시퀀스·시뮬레이션 / 단위·통합 테스트 결과 보고서(Check-List) |
| 4 | 셋업 | 입고셋업 | HW IO/모션 점검 시트 / 파라미터·레시피 백업 / 이슈 로그(Dry Run·Tack Time) / MES 연동 / SAT 결과서 |
| 5 | 양산 | 적용 및 모니터링 | 운영 가이드·매뉴얼(HMI·알람조치) / S/W 최적화 / 최종 버전 동결·마스터 백업 / 프로젝트 완료 보고서 |
| 6 | CS | 요청대응 | 요청대응 이력(가동 후 CS) |
타사 양식 → 슬롯 매핑 원칙: 원본 문서의 목적(요구분석/설계정의/테스트/셋업/운영매뉴얼)을 위 슬롯 키워드와 대조해 단계를 결정한다. 한 문서가 여러 단계에 걸치면 단일 슬롯 배치가 기본값이며 보조 단계를 비고에 병기한다.
단 분할 여부의 최종 판정은 ubisam-analyst.md §4가 소유한다 — 시트/슬라이드 단위로 서로 다른
슬롯에 배치하는 것이 적절한 문서가 있기 때문이다. 이 절과 충돌하면 analyst §4를 따른다.
4. 일감 필드 스키마
| 필드 | 규칙 |
|---|---|
| 제목 | N.단계명 (예: 2.설계) |
| 티켓번호 | {프로젝트코드}-{일련번호} — 프로젝트코드는 _meta/project.yaml에서 읽는다 |
| 유형 | §2 enum 1개 |
| 상태 | §1 enum 1개 |
| 우선순위 | 보통(=Normal) 기본 |
| 담당자/참조자 | 이름(직급) |
| 진행률 | % |
| 등록일/수정일/종료일 | yyyy/mm/dd (또는 yyyy-mm-dd) |
| 예상시간 | 2w 4d 6h 45m 형식 |
| Hashtag | 자유 태그 |
| 첨부파일 | 최대 2.93GB |
5. 프로젝트 메타 스키마
프로젝트명 · 종류(Software) · 프로젝트형식(Kanban) · 코드명 · 사업부/팀 · PL · 등록자 · 계약일/납기 · 권한(책임자→참여자→열람자).
프로젝트 메타의 유일 진실원은 docs/[Ubisam산출물]/_meta/project.yaml이다.
이 스킬에 특정 프로젝트의 값을 적어두지 않는다 — 다른 프로젝트에서 복사해 온 값이 여기 남아 있으면,
그것을 읽은 작성가가 산출물에 그대로 기입하고 검증가는 그 값을 정답으로 대조하게 된다.
즉 하네스가 잡아야 할 "타설비 잔재"를 하네스 스스로 공급하는 꼴이 된다.
project.yaml이 없으면 값을 지어내지 말고 미정 — 확인 필요로 남기고 사용자에게 묻는다.
6. PTOP 채움 시 참고값 (검증 기준 아님)
아래는 이 저장소 한정 참고값이다. §5 원칙대로 프로젝트 메타의 진실원은
_meta/project.yaml이며, qa는 이 절을 정답으로 대조하지 않는다.project.yaml과 어긋나면project.yaml이 우선한다.
설비: 각형 배터리 레이저 용접기(ILSOS OC5 PtoP Welder), Aurora 2.0 / .NET 4.8.1 / WPF.
주요 디바이스: PLC(Mitsubishi Melsec·MX Component), Laser Scanner(RTC), Laser(IO Gate),
Digital IO — 구현 클래스는 PAIX_PTOP(EquipmentSetup.cs:153 등록), 보드 타입은 런타임
IOUnitConfig.BoardType 설정값이다. "Ajin"으로 단정하지 말고 설정을 확인할 것.
메인 시퀀스: SeqAutoRunPTOP. PLC 인터페이스: Machines/ILSOS_PrismaticRD_PTOP/Device/PLC/PLCController.Address.cs.
재생산 산출물의 **출처(코드 경로/커밋)**를 항상 명시한다 — 검증가가 근거 추적에 사용한다.
규약 바인딩. 이 스킬은 enum·양식의 단일 기준이라 여기서 새는 추측은 하류 전체를 오염시킨다.
- 확인하지 않은 값·해석은 문장 앞에
[추론]을 붙인다 (rules.md#15·#16). 확인 후 표기를 떼고파일:심볼로 바꾼다. 검색은\[추론\]로 이스케이프한다(대괄호=정규식 문자클래스).미확인(값을 못 찾음)과[추론](확인 전 서술)은 축이 다르다 — 대체하지 말고 필요하면 병기한다.- 주석·클래스명을 근거로 삼지 않는다 (#1). 위
BoardType이 그 사례다.- 모르면 지어내지 말고 모른다고 한다 (#9).