3.7 KiB
3.7 KiB
| name | description |
|---|---|
| ubisam-deliverable | 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: 컨텍스트 확인
- 대상 산출물과 작업 디렉토리를 정한다. 기본 작업공간:
docs/[Ubisam산출물]/_workspace/. - 실행 모드 판별:
_workspace/없음 → 초기 실행(Phase 1부터)_workspace/있음 + 부분 수정 요청 → 부분 재실행(해당 에이전트만)_workspace/있음 + 새 입력 → 새 실행(기존을_workspace_prev/로 이동)
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/산출물을 기반으로 변경분만 갱신한다.