50 lines
3.7 KiB
Markdown
50 lines
3.7 KiB
Markdown
---
|
|
name: ubisam-deliverable
|
|
description: Ubisam 산출물 재생산 하네스의 오케스트레이터. 타사 양식 산출물(Doc/산출물문서의 xlsx·pptx)을 Ubisam 협업관리 양식(상태4·유형9·6단계 슬롯·필드 스키마)으로 분석·재배치·재생산·검증하는 분석가·작성가·검증가 3에이전트 팀을 구동한다. "Ubisam 산출물 만들어/재생산/재배치", "협업관리 양식으로", "산출물 채움", "이 문서 Ubisam 단계로", 그리고 후속 표현("다시 실행", "재실행", "업데이트", "수정", "보완", "OO만 다시", "이전 결과 기반") 시 반드시 이 스킬을 사용할 것. 단순 양식 질문은 ubisam-format-map만으로 답할 수 있다.
|
|
---
|
|
|
|
# ubisam-deliverable — Ubisam 산출물 재생산 오케스트레이터
|
|
|
|
타사 양식 산출물을 **Ubisam 양식으로 재생산**하는 3에이전트 팀(생성-검증 파이프라인)을 조율한다.
|
|
|
|
- 실행 모드: **에이전트 팀** (분석 → 재생산 ↔ 검증)
|
|
- 팀원: `ubisam-analyst`, `ubisam-producer`, `ubisam-qa` (모두 `model: "opus"`)
|
|
- 공유 스킬: `ubisam-format-map` (양식 enum·스키마·슬롯 매핑 — 모든 팀원이 먼저 읽음)
|
|
- 작업공간: 대상별 `_workspace/`, 최종 산출물은 지정 경로 또는 `docs/[Ubisam산출물]/` 하위
|
|
|
|
## Phase 0: 컨텍스트 확인
|
|
1. 대상 산출물과 작업 디렉토리를 정한다. 기본 작업공간: `docs/[Ubisam산출물]/_workspace/`.
|
|
2. 실행 모드 판별:
|
|
- `_workspace/` 없음 → **초기 실행**(Phase 1부터)
|
|
- `_workspace/` 있음 + 부분 수정 요청 → **부분 재실행**(해당 에이전트만)
|
|
- `_workspace/` 있음 + 새 입력 → **새 실행**(기존을 `_workspace_prev/`로 이동)
|
|
3. `ubisam-format-map` 스킬을 로드해 양식 기준을 확보한다.
|
|
|
|
## Phase 1: 분석 (analyst)
|
|
- `ubisam-analyst`에게 대상 문서를 주고 구조 분석·타설비 잔재 식별·6단계 슬롯 매핑을 요청한다.
|
|
- 산출: `_workspace/01_analyst_{문서}.md`.
|
|
|
|
## Phase 2: 재생산 ↔ 검증 (producer ↔ qa, 점진적)
|
|
- `ubisam-producer`가 매핑·채움 항목으로 산출물을 재생산한다(xlsx=openpyxl, pptx=`ubisam-ppt-make`, md).
|
|
- 각 문서 완성 직후 `ubisam-qa`가 **점진적으로** 검증(enum·슬롯·스키마·잔재·출처·자동화).
|
|
- Critical/Major는 producer가 수정 후 재검증. 통과까지 반복(최대 합리적 횟수, 1회 재시도 원칙).
|
|
|
|
## Phase 3: 종합·보고
|
|
- 최종 산출물 경로, qa 통과 여부, 미정/TBD 항목, 출처를 사용자에게 요약 보고한다.
|
|
- 중간 산출물(`_workspace/`)은 보존(감사 추적).
|
|
|
|
## 데이터 전달 프로토콜
|
|
- 태스크 기반(`TaskCreate`/`TaskUpdate`)으로 진행 추적, 파일 기반(`_workspace/`)으로 산출물 전달, 메시지 기반(`SendMessage`)으로 실시간 조율.
|
|
- 파일명: `{phase}_{agent}_{artifact}.{ext}` (예: `01_analyst_sw점검결과.md`).
|
|
|
|
## 에러 핸들링
|
|
- 에이전트 실패 시 1회 재시도, 재실패하면 해당 결과 없이 진행하고 보고서에 누락을 명시한다.
|
|
- 상충 데이터는 삭제하지 않고 출처를 병기한다.
|
|
|
|
## 테스트 시나리오
|
|
- **정상 흐름**: `23. SW 점검 결과` xlsx → analyst가 SW Version/Gantt를 6단계 슬롯(제작/양산 등)에 매핑 → producer가 Ubisam 양식 시트로 재배치 → qa가 enum/스키마 검증 → 통과 보고.
|
|
- **에러 흐름**: 대상 파일이 편집기 잠금 → producer가 잠금 경고·작업 사본 진행 → qa가 원본 미반영 표시 → 사용자에게 "원본 닫기 후 반영 필요" 보고.
|
|
|
|
## 후속 작업
|
|
- 부분 수정 요청("OO만 다시")은 해당 에이전트만 재호출하고, 이전 `_workspace/` 산출물을 기반으로 변경분만 갱신한다.
|