- SKILL.md: C항목 2.설계 PPTX를 한 줄 실행 명령으로 교체, 불변규칙에 pptx 재생산 추가 - 06-procedure.md: xlsx 재생산과 동등한 pptx 재생산 절차 섹션 추가 - 09-pptx-integration.md: 자동 재생산(build_02설계_pptx.py)과 수동 절차를 구분 기재 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
6.0 KiB
6.0 KiB
| name | description |
|---|---|
| ubisam-deliverables | Ubisam 협업관리(칸반) 구조에 맞춰 프로젝트 산출물을 docs/[Ubisam산출물]/ 트리로 구성·관리한다. "산출물 구조 만들기", "Ubisam 양식으로 채우기", "설계/셋업/양산 산출물 정리", "산출물 트리 스캐폴딩" 같은 요청에 사용. 6단계(분석·설계·제작·셋업·양산·CS) 폴더·_meta enum·일감 카드·LGPRI 양식 채움 절차를 제공. |
Ubisam 산출물 관리 SKILL
UBISAM 협업관리는 프로젝트(칸반 보드 1개) → 일감(6단계) → 단계별 산출물 로 운영된다.
이 스킬은 그 구조를 소스 레포의 docs/[Ubisam산출물]/ 하위 파일 트리로 미러링하고,
LGPRI 제공 양식을 프로젝트 내용으로 채워 관리한다.
언제 쓰나
- 새 프로젝트에 산출물 트리를 깔 때(스캐폴딩).
산출물문서/양식/에 들어온 빈 양식을 프로젝트 내용으로 채울 때.- 단계별 일감 상태/진행률을 갱신할 때.
참조 맵 (모두 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 템플릿 |
실행 순서 (오케스트레이션)
0. 하네스 진입 (항상 먼저)
00-harness.md의 비침습 계약 확인 → 호스트 CLAUDE.md·소스에서 프로젝트 사실 읽기 → project_code/project_name 자동 추정(실패 시 질문).
A. 스캐폴딩 (트리 생성)
- 소스 레포 루트의
.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. 산출물문서/(+양식/드롭존),ref/,[분석]/,[작업일지]/.
RULES.MD(산출물 영역 규칙) +README.md(트리 한눈에 + 단계별 현황 뱃지 표)를 루트에 작성._meta/project.yaml의{...}토큰은 프로젝트 정보로 교체. 모르면 그대로 두고 사용자에게 질문.- 디자인 적용: 모든
_task.md와README.md에 08-design-system.md § 7 템플릿 적용.
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 연동)
09-pptx-integration.md 절차를 따른다.
- 2.설계 채움 완료 →
SW_설계서.pptx(선택):set PYTHONUTF8=1 && py .claude/skills/ubisam-deliverables/references/build_02설계_pptx.py한 줄 실행 - 5.양산 채움 or 명시 요청 →
<설비명>_HMI_매뉴얼.pptx(필수): MD 내용 → JSON spec →build_deck.py - 마스터 배경(#F4F7FA + accent 바)은
build_deck.py가 자동 적용. 표 높이 상한 5.3" — 푸터 비침범 보장.
불변 규칙 (항상 지킴)
- MD 200줄 상한: 새 문서가 길어지면 분할하고 상호 링크(
[[...]]/상대경로)로 매핑. - enum 고정: 상태·유형은 회사 공통 마스터. 새 값 발견 시
_meta/*.enum.md먼저 갱신. - 출처 명시: 채운 내용은 원본 파일·코드 경로를 문서에 남긴다.
- 디자인 의무: 생성하는 모든 산출물 MD에 08-design-system.md 배너·뱃지 적용. 텍스트 단독 표기 금지.
- xlsx 재생산:
references/build_02설계_xlsx.py+xlsxfill.py로 완전 독립 생성(ref 불필요). 스타일 상수는 xlsxfill.py에 하드코딩.set PYTHONUTF8=1 && py build_02설계_xlsx.py한 줄 실행. - pptx 재생산:
references/build_02설계_pptx.py로 완전 독립 생성(ref 불필요). 슬라이드 스펙 내장,build_deck.py자동 호출.set PYTHONUTF8=1 && py build_02설계_pptx.py한 줄 실행. - 루트 보호: 레포 루트
RULES.md> 본 산출물RULES.MD(스코프 하위).