NohDoyeon241104 ac954a5ea5 docs: ubisam-deliverables 통합 완료 — build_02설계_pptx.py 참조 전면 반영
- 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>
2026-06-30 16:13:18 +09:00

3.3 KiB

06 · 분석 → 채움 절차

입력: 산출물문서/양식/(빈 양식) 또는 타설비 산출물. 출력: 단계 슬롯에 채운 산출물 + 갱신된 _task.md + 로그.

절차

  1. 분석: 원본 구조 파악(시트/슬라이드/컬럼). 결과를 [분석]/<yyyy_mm_dd>_<주제>-분석.md에 기록.
    • 엑셀 구조 추출(파이썬·Office 없이): unzip -p file.xlsx xl/workbook.xml(시트명), xl/sharedStrings.xml(라벨).
  2. 양식 식별: 타설비 템플릿 잔재 분리. 채울 슬롯 결정 → 04-stage-deliverables.md.
  3. 채움: 이 프로젝트 사실로 값 작성. 출처(원본 파일·코드 경로) 명시.
    • 미확정 디바이스주소·축범위는 (제안) 표기.
  4. 디자인 적용: 08-design-system.md 배너·뱃지·섹션헤더를 삽입한다.
    • MD 최상단: 배너(§1) → 부제 바 순.
    • 상태·유형 필드: 텍스트 대신 뱃지(§2·3) 사용.
    • 진행률: <progress> 바(§4) 병기.
    • 산출물 시트 구분 ## 헤더: <span style="color:#2E75B6"> 적용(§5).
  5. 배치: 해당 NN.단계명/<슬롯>/에 저장.
  6. PPTX 생성: 09-pptx-integration.md 참고.
    • 2.설계 채움 완료 → SW_설계서.pptx (선택)
    • 5.양산 채움 or 명시 요청 → <설비명>_HMI_매뉴얼.pptx (필수)
    • MD 내용 → JSON spec → ubisam-ppt-make/build_deck.py → 슬롯에 저장
    • 임시 spec JSON 생성 후 pptx 완성 즉시 삭제
  7. 카드 갱신: _task.md의 상태·진행률·첨부 매핑 갱신(PPTX 파일명 포함, 02-enums.md).
  8. 기록: [작업일지]/<오늘>.md에 한 일·다음 TODO.

xlsx 재생산 (from scratch · ref 불필요)

  • references/xlsxfill.py — LG PRI 스타일 상수 하드코딩 + scratch-build API.
  • references/build_02설계_xlsx.py — PtoP 데이터 내장, 4종 xlsx 자동 생성.
  • 실행: cwd=repo root, set PYTHONUTF8=1 && py .claude/skills/ubisam-deliverables/references/build_02설계_xlsx.py
  • ref xlsx 없어도 동일 외형 재현. 스타일 상수 변경 시 xlsxfill.py만 수정.

pptx 재생산 (from scratch · ref 불필요)

  • references/build_02설계_pptx.py — 슬라이드 스펙(22슬라이드) 내장, ubisam-ppt-make/build_deck.py 자동 호출.
  • 실행: cwd=repo root, set PYTHONUTF8=1 && py .claude/skills/ubisam-deliverables/references/build_02설계_pptx.py
  • 출력: docs/[Ubisam산출물]/02.설계/설계리뷰_DR/SW_설계서.pptx
  • 임시 spec JSON 자동 생성·삭제. 표 높이 상한 5.3" 적용 — 푸터 비침범 보장.

MD 분할 규칙

  • 모든 산출/분석 MD는 200줄 이내. 초과 시 주제별 분할 + 상호 링크(상대경로)로 매핑.
  • 인덱스 문서(예: [분석] 폴더 README)에 1줄 포인터로 목록 유지.

자기완결 보장 (ref 없이 동작)

  • 이 스킬은 양식 골격을 05-form-schemas.md에 내장한다.
  • ref/가 비어 있어도 트리·enum·양식 골격을 동일하게 생성한다.
  • 새 양식 입수 시: 골격을 추출해 05 파일에 추가 → 이후 ref 없이 재현 가능.