Office Lab
하나의 Workspace Repo에서 요구사항, Issue, PR, 네이티브 검토, 프로토타입과 일정을 연결하는 GitHub 방식의 Office 협업.
Office Lab은 **Univer Office SDK**와 Workspace Repo 모드로 구성한 제품·개발 협업 사례입니다. 요구사항 문서, 스프레드시트, 동작하는 프로토타입, Issue와 PR을 같은 프로젝트에 모아 요청과 변경, 결과를 함께 살펴봅니다.
제품 관리자와 개발자는 각자 익숙한 Agent로 자료를 준비하고 확인합니다. 사람은 사용자 경험을 논의하고 변경을 검토하며 최종 전달을 결정합니다.
하나의 프로젝트, 두 가지 관점 · 발견을 실행 가능한 Issue로 만들기 · Worktree와 Compare로 내용 검토하기 · Web App 생성·게시·관리 · Office Lab 체험하기
이미지는 실제 클라우드 Workspace에서 촬영한 가상의 영어 사례입니다. 두 Agent의 역할 분담은 따라 할 수 있는 협업 제안입니다.
하나의 프로젝트, 두 가지 관점
Team Invitations에서는 동료 초대, 역할 선택과 결과 확인을 다룹니다. 대기 중인 이메일의 중복 초대를 개선하며 프로토타입, 승인 기준, 이벤트 측정과 일정을 연결합니다.
| 역할 | Agent 예시 | 기여 |
|---|---|---|
| Maya · 제품 | Codex | 경험, 요구사항, 승인 기준, 측정 계획과 검토. |
| Alex · 개발 | Claude Code | 요구사항과 프로토타입 확인, Issue 작성, 수정과 검증. |
| 자료 | 역할 |
|---|---|
| Product brief · Doc | 목표, 초대 규칙, 승인 기준과 출시 조건. |
| Tracking plan · Doc | 이벤트 트리거, 속성과 측정 규칙. |
| Event catalog · Sheet | 이벤트, 담당자와 준비 상태. |
| Delivery schedule · Sheet | 작업, 담당자, 날짜, 진행 상태와 예상 공수. |
| Invite Prototype / Team Access Console · Web App | 직접 조작하는 초대 양식. |
Repo에서 작업 자료 살펴보기
팀 Space를 Repo 모드로 열면 Code에서 편집 가능한 문서와 앱 파일을 찾고 미리 볼 수 있습니다. 자료 옆에 Issues, Pull requests, Pages, Settings가 있어 같은 맥락에서 협업합니다.
Repo는 기존 Space의 다른 보기이며 콘텐츠와 권한을 그대로 사용합니다. 선택한 Web App을 프로젝트 홈에 표시해 바로 체험할 수도 있습니다.
발견을 실행 가능한 Issue로 만들기
Alex는 중복 초대 안내가 불명확함을 발견하고 Prevent duplicate invitations에 기대 메시지, 차단 이벤트와 QA 작업을 기록합니다. 요구사항, 측정 계획, 이벤트 표와 일정을 연결합니다.
설명, 댓글, 담당자와 레이블로 다음 행동을 명확히 합니다. Issue는 팀 Space 기능이며 Agent도 Workspace CLI로 같은 작업과 자료를 읽습니다. 피드백은 Issue나 관련 문서 댓글에 남깁니다.
PR로 변경 제안하기
PR은 Workspace Worktree를 검토할 수 있는 제안으로 표시합니다. 작업 초안에 기존 문서를 추가하고 수정한 뒤 Ready로 표시합니다. 제목, 요약, 작성자, 상태와 변경 파일을 확인하며 공유 콘텐츠는 계속 사용할 수 있습니다.
화면의 PR은 이벤트 표에 invite_duplicate_blocked를 추가하고 QA 일정을 조정하며 요약에서 Issue #1을 참조합니다. 각 담당자는 별도 초안에서 작업하고 권한 있는 검토자에게 공개해 같은 자료를 기준으로 결과를 확인할 수 있습니다.
Worktree와 Compare로 내용 검토하기
요약을 읽고 Files changed를 엽니다. View는 결과를 읽기 전용으로 보여 주며, Compare는 공식 버전과 제안 버전을 나란히 표시하고 변경 목록에서 해당 위치로 이동합니다.
Worktree가 작업을 분리하고 Compare는 콘텐츠 모델, Snapshot과 Changeset을 사용합니다. 권한 있는 사람이 수정을 요청하거나 병합을 결정합니다. 화면의 두 파일 PR은 Ready 상태로 병합하지 않았습니다.
납기 영향도 함께 검토하기
같은 PR은 Usability and QA 종료일을 11월 9일에서 10일로, 예상 공수를 2일에서 3일로 바꿉니다. 이벤트 변경과 함께 담당자, 날짜와 상태를 확인해 전달에 필요한 작업까지 검토합니다.
Web App 생성·게시·관리
Pages에서 게시된 Web App을 찾고, 열고, 주소를 복사하거나 홈 미리보기를 선택합니다. 기본 페이지 선택은 현재 브라우저에만 적용되며 파일과 접근은 Workspace가 관리합니다.
초대 프로토타입을 Team Access Console로 확장했습니다. 멤버와 역할 목록, 상태 필터, 검색, 초대와 취소, 최근 활동, 인수 기준과 세션 이벤트 수를 한 화면에서 확인할 수 있습니다. 새 예시 이메일은 목록과 대기 수를 함께 갱신하고, 중복 초대는 차단됩니다. 데이터는 메모리에만 유지되며 이메일이나 분석 이벤트를 전송하지 않습니다. 제품 담당자가 동작을 확인하고 발견한 문제를 Issue로 이어갈 수 있습니다.
Office 변경은 Worktree 검토와 병합을 거치며 HTML View는 별도의 저장·게시 승인 흐름을 사용합니다. 예시 프로토타입은 대기 중인 문서 PR과 별도로 게시되었습니다. 실제 Office 데이터 연결은 실험적 Binding을 참고하세요.
팀 협업의 경계 정하기
Settings는 이름, 설명, 공개 범위, 협업자와 휴지통을 제공합니다. 소유자와 관리자가 접근을 정리하고 편집, 검토, 병합에는 현재 사용자의 유효 권한이 적용됩니다.
제품 담당자는 경험과 승인 기준을, 개발자는 구현과 측정을 확인합니다. 권한 있는 사람이 Office 변경을 병합하고 게시된 원형을 확인한 뒤 완료된 Issue를 닫습니다.
Office Lab 체험하기
- 클라우드 Workspace에 로그인하거나 자체 배포를 열고 팀 Space를 만들거나 선택합니다.
- **Application settings → Page theme → Repository (experimental)**를 엽니다. 같은 Space의 표시 방식을 바꾸는 설정이며 현재 브라우저에만 저장됩니다.
- Code에서 문서를 보고, Issues에서 문제를 추적하고, Pull requests에서 변경을 검토하고, Pages에서 게시된 Web App을 엽니다.
자신의 Agent를 쓰려면 Workspace CLI 연결 안내를 따르세요. 각 Agent는 사용자가 승인한 계정으로 작업합니다. 아래 작업 템플릿으로 워크플로를 직접 체험할 수 있습니다.
1. 제품: 공유 맥락 만들기
Team Invitations 팀 Space에 영어 요구사항, 측정 계획, 이벤트 표, 일정과 대화형 초대 Web App 미리보기를 만들어 주세요. 담당자, 날짜와 승인 기준을 명시하고 Office 변경을 Worktree에 유지해 검증한 뒤 검토 링크를 주세요. 병합이나 원형 게시 전에는 제 승인을 기다리세요.2. 개발: 집중된 개선 제안하기
요구사항, 이벤트 표, 일정과 프로토타입을 읽고 대기 중인 이메일의 중복 초대를 확인하세요. 재현 단계와 기대 행동을 Issue로 작성하고 Office 수정은 별도 Worktree, 프로토타입은 전용 게시 흐름으로 준비하세요. 검증 후 PR 요약에서 Issue를 참조하고 사람의 검토를 기다리세요.3. 검토: 변경과 승인 기준 연결하기
Compare로 PR을 검토해 중복 초대 이벤트, 승인 기준과 QA 일정을 확인하고 원형을 체험하세요. 누락을 Issue에 기록해 수정을 요청하고 준비된 부분과 대기 중인 부분을 요약하세요. 승인 전에는 병합하거나 게시하지 마세요.같은 SDK와 Skills로 확장하기
양쪽은 버전에 맞는 CLI Skills를 사용합니다. core는 탐색과 Worktree, doc·sheet는 요구사항과 계획, html-view는 원형을 다룹니다. Agent는 접근 가능한 상대 자료와 Issue 피드백을 읽고 사람은 최종 결정을 내립니다.
Web SDK는 콘텐츠 모델, 편집기와 Headless를, Server SDK는 협업·버전·Worktree를, AI SDK는 조작과 검증을 제공합니다. Workspace는 프로젝트, ID, Issue, Repo와 게시를 구성합니다. 이를 재사용해 제품 연구 공간이나 내부 업무 허브를 만들 수 있습니다.
이 가이드는 어떠셨나요?