9.2 KiB
| name | description |
|---|---|
| ubisam-deliverables | Ubisam 협업관리(칸반) 구조에 맞춰 프로젝트 산출물을 docs/[Ubisam산출물]/ 트리로 구성·관리한다. "산출물 구조 만들기", "Ubisam 양식으로 채우기", "설계/셋업/양산 산출물 정리", "산출물 트리 스캐폴딩" 같은 요청에 사용. 6단계(분석·설계·제작·셋업·양산·CS) 폴더·_meta enum·일감 카드·LGPRI 양식 채움 절차를 제공. 구분 — 이미 있는 타사 문서를 Ubisam 양식으로 재생산하는 것은 `ubisam-deliverable-rebuild`, PTOP 소스코드를 읽어 설계 MD를 뽑는 것은 `ptop-deliverables`, enum 조회만이면 `ubisam-format-map`, **PTOP 아키텍처·구현·빌드 분석**은 `orchestrate-ptop-harness`. 맨손 "업데이트"·"다시 실행"만으로는 이 스킬을 고르지 않는다 — 무엇을 만들지 먼저 확인한다. |
Ubisam 산출물 관리 SKILL
UBISAM 협업관리는 프로젝트(칸반 보드 1개) → 일감(6단계) → 단계별 산출물 로 운영된다.
이 스킬은 그 구조를 소스 레포의 docs/[Ubisam산출물]/ 하위 파일 트리로 미러링하고,
LGPRI 제공 양식을 프로젝트 내용으로 채워 관리한다.
언제 쓰나
- 새 프로젝트에 산출물 트리를 깔 때(스캐폴딩).
docs/[Ubisam산출물]/산출물문서/양식/에 들어온 빈 양식을 프로젝트 내용으로 채울 때. (입력 원본은 저장소 루트Doc/산출물문서/— 읽기 전용이며 이 스킬이 만들지 않는다)- 단계별 일감 상태/진행률을 갱신할 때.
참조 맵 (모두 200줄 이내, 필요한 것만 읽기)
| # | 파일 | 용도 |
|---|---|---|
| 0 | references/00-harness.md | 하네스: 호스트 레포 맞물림·비침습 계약 (먼저 읽기) |
| 1 | references/01-tree.md | 목표 트리·배치 규칙·우선순위 |
| 2 | references/02-enums.md | 상태 4종·유형 9종·티켓코드 규칙 |
| 3 | references/03-schema.md | 일감 필드·프로젝트 메타 스키마 |
| 4 | references/04-stage-deliverables.md | 6단계↔산출물 슬롯 매핑 |
| 5 | references/05-form-schemas.md | 설계 양식 시트·컬럼 스키마 |
| 6 | references/06-procedure.md | 분석→채움 절차·조건서식 보존 |
| 7 | references/07-fill-mapping.md | 프로젝트 분석→산출물 필드 자동 채움 매핑 |
| 8 | references/08-design-system.md | 색상 팔레트·배너·뱃지·진행률 HTML 템플릿 |
| 9 | references/09-pptx-integration.md | PPTX 생성 — ubisam-ppt-make 연동 절차·슬라이드 매핑 |
| T | templates/ | _task 카드·project.yaml 템플릿 |
진입 가드 (먼저 확인)
발화에 무엇을 원하는지가 없으면(예: "산출물 업데이트해줘"·"다시 실행해줘"·"보완해줘") 스캐폴딩을 바로 깔지 말고 되묻는다.
이 스킬은 폴더·_task.md·README.md를 수십 개 만들므로, 오발동 시 되돌리는 비용이 크다.
되물을 것: "① 트리를 새로 깔까요, ② 소스 기준으로 설계 MD를 뽑을까요(ptop-deliverables),
③ 기존 문서를 Ubisam 양식으로 재생산할까요(ubisam-deliverable-rebuild)?"
생성할 폴더·파일 목록을 제시하고 승인을 받은 뒤 A단계를 시작한다 (rules.md #2).
실행 순서 (오케스트레이션)
0. 하네스 진입 (항상 먼저)
00-harness.md의 비침습 계약 확인 → 호스트 CLAUDE.md·소스에서 프로젝트 사실 읽기 → project_code/project_name 자동 추정(실패 시 질문).
A. 스캐폴딩 (트리 생성)
- 생성할 폴더·파일 목록을 사용자에게 제시하고 승인을 받는다 (
rules.md#2). 이 단계는 수십 개 파일을 만들므로 되돌리는 비용이 크다. - 소스 레포 루트의
.claude/·CLAUDE.md·rules.md는 건드리지 않는다. docs/[Ubisam산출물]/아래에 01-tree.md의 트리를 생성:_meta/(enum·스키마) ← 02·03 내용으로 채움.01.분석협의 ~ 06.CS/6단계 폴더 + 각_task.md(템플릿: templates/_task.template.md).- 각 단계 산출물 슬롯 하위폴더 +
.gitkeep← 04. docs/[Ubisam산출물]/산출물문서/(+양식/드롭존),ref/,[분석]/,[작업일지]/.저장소 루트
Doc/산출물문서/와 다른 곳이다. 전자는 스캐폴딩이 만드는 트리 내부, 후자는 입력 원본 드롭존(스캐폴딩 대상이 아니며 읽기 전용).
RULES.MD(산출물 영역 규칙) +README.md(트리 한눈에 + 단계별 현황 뱃지 표)를 루트에 작성._meta/project.yaml의{...}토큰은 프로젝트 정보로 교체. 모르면 그대로 두고 사용자에게 질문.- 디자인 적용: 08-design-system.md —
_task.md는 §7 완성 템플릿을 그대로 적용하고,README.md는 §7 템플릿이 없으므로 §1 배너 + §2·§3 뱃지 + §4 진행률 바를 조합해 단계별 현황 표를 만든다.
B. 양식 채움 (산출물 생성)
06-procedure.md 절차를 따른다: 분석 → 타설비 잔재 식별 → 프로젝트 내용 채움(출처 명시) → 슬롯 배치 → _task.md 진행률 갱신 → [작업일지] 기록.
- 자동 채움: 호스트 분석 사실을 07-fill-mapping.md 매핑으로 산출물 필드에 기입.
- 디자인 적용: 생성하는 모든 MD에 08-design-system.md 배너·뱃지·섹션헤더 삽입.
- 양식의 시트·컬럼 골격은 05-form-schemas.md 참조(ref 불필요).
- 상태/유형 값은 02-enums.md enum만 사용(임의 신규값 금지).
C. PPTX 생성 — ubisam-ppt-make 스킬에 위임 (직접 생성 금지)
이 스킬은 PPTX를 직접 생성하지 않는다. PPTX 렌더링은 반드시
ubisam-ppt-make스킬의build_deck.py를 통해서만 수행한다. 이 스킬의 역할은 ① 슬라이드 spec JSON 준비 ②build_deck.py호출 ③ 결과 슬롯 배치.
상세 절차 → 09-pptx-integration.md
- 2.설계 완료 →
SW_설계서.pptx:PYTHONUTF8=1 py .claude/skills/ubisam-deliverables/references/build_02설계_pptx.py - 5.양산 완료 or 명시 요청 →
<설비명>_HMI_매뉴얼.pptx: MD → spec JSON →ubisam-ppt-make/build_deck.py - 레이아웃·디자인 토큰은 ubisam-ppt-make/SKILL.md 기준. 이 스킬에서 재정의 금지.
불변 규칙 (항상 지킴)
- MD 200줄 상한 (
rules.md#4): 새 문서가 길어지면 분할하고 상호 링크([[...]]/상대경로)로 매핑. - enum 고정: 상태·유형은 회사 공통 마스터. 새 값 발견 시
_meta/*.enum.md먼저 갱신. - 출처 명시: 채운 내용은 원본 파일·코드 경로를 문서에 남긴다.
- 추론 표기: 원본을 확인하지 않고 판단으로 채운 값·해석은 문장 앞에
[추론](rules.md#15·#16). 자동 채움 단계가 게이트 없이 값을 만들 수 있는 유일한 경로이므로 여기서 표기가 빠지면 이후 검증가가 잡을 근거가 없다. 확인 후에는 표기를 떼고 출처로 바꾼다. 검색은\[추론\]로 이스케이프한다(대괄호=문자클래스). - 디자인 의무: 생성하는 모든 산출물 MD에 08-design-system.md 배너·뱃지 적용. 텍스트 단독 표기 금지.
- xlsx 재생산 (
ptop-deliverables경로 한정 — rebuild 경로는xlsxfill기반 신규 스크립트):references/build_02설계_xlsx.py+xlsxfill.py로 완전 독립 생성(ref 불필요). 스타일 상수는 xlsxfill.py에 하드코딩. 저장소 루트에서PYTHONUTF8=1 py .claude/skills/ubisam-deliverables/references/build_02설계_xlsx.py한 줄 실행 (cd금지 — 출력 경로가 어긋난다). - pptx 재생산:
references/build_02설계_pptx.py로 완전 독립 생성(ref 불필요). 슬라이드 스펙 내장,build_deck.py자동 호출.PYTHONUTF8=1 py .claude/skills/ubisam-deliverables/references/build_02설계_pptx.py한 줄 실행. 이 스크립트는__file__기준 절대경로를 쓰므로 cwd와 무관하다 (xlsx 쪽은 상대경로라 반드시 저장소 루트에서 실행). - 루트 보호: 레포 루트
rules.md> 본 산출물RULES.MD(스코프 하위).
단독 호출로 마무리할 때: 보고는
rules.md#11~13 출력 형식(수정 줄=초록 화살표, 단어=주황, 미변경=기본색)을 따르고, 끝에 관련.md를 갱신할 부분이 있는지 묻는다(rules.md#6).