Nopal

nopal for Codex

Read these first:

• $PLUGIN_ROOT/skills/nopal/references/gws-shared.md

Load as needed (필요한 서비스만):

• $PLUGIN_ROOT/skills/nopal/references/gws-gmail.md
• $PLUGIN_ROOT/skills/nopal/references/gws-calendar.md
• $PLUGIN_ROOT/skills/nopal/references/gws-drive.md
• $PLUGIN_ROOT/skills/nopal/references/gws-docs.md
• $PLUGIN_ROOT/skills/nopal/references/gws-sheets.md
• $PLUGIN_ROOT/skills/nopal/references/gws-slides.md
• $PLUGIN_ROOT/skills/nopal/references/gws-chat.md
• $PLUGIN_ROOT/skills/nopal/references/gws-tasks.md
• $PLUGIN_ROOT/skills/nopal/references/gws-meet.md
• $PLUGIN_ROOT/skills/nopal/references/recipes.md
• $PLUGIN_ROOT/skills/nopal/references/workflows.md

Use this skill when the user wants Google Workspace work orchestrated from natural language.

Questioning policy: $PLUGIN_ROOT/shared/questioning-policy.md §A + §1 + §2c.

• Codex CLI has no structured question card UI. When a decision is needed, output numbered-options-in-chat per §A.
• Infer what you can; ask only what is genuinely unknown (§1). If the request is already concrete, skip clarification and proceed (§2c).

규칙

• 모든 질문은 §A 번호 블록으로 채팅에 출력한다. 존재하지 않는 카드 UI를 가정하지 않는다.
• gws CLI를 통해서만 Google Workspace와 상호작용한다. 직접 HTTP 호출 금지.
• 읽기 전용 단순 조회(일정 확인, 메일 확인 등)는 확인 없이 바로 실행한다. 쓰기/변경 작업만 사용자 확인을 받는다.

지원 서비스 (9개)

Workflow

Step 0: 환경 확인 (자동)

gws CLI 설치 여부와 인증 상태를 자동으로 확인한다. 사용자에게 묻지 않는다.

0-1. gws CLI 설치 확인

command -v gws 실행.

• 미설치: npm install -g @googleworkspace/cli 자동 설치. 완료 후 gws --version 확인.
• 설치 실패 시: $PLUGIN_ROOT/skills/nopal-setup/SKILL.md 내용을 기반으로 수동 안내 후 중단.
• 설치된 경우: 0-2로 진행.

0-2. 인증 상태 확인

gws auth status 실행.

• 인증 안 된 경우: gws auth setup은 인터랙티브 TUI이므로 셸 도구로 실행할 수 없다. $PLUGIN_ROOT/skills/nopal-setup/SKILL.md 기반으로 설정 안내(5단계 setup → login → credentials export)를 채팅에 출력하고 중단. 사용자가 설정 완료 후 재실행하면 0-2부터 재확인 후 Step 1로 진행.
• 인증 완료: Step 1로 진행.

Step 1: 요청 파싱

요청이 주어진 경우 — 사용자의 자연어 요청을 그대로 오케스트레이션 입력으로 사용하고 Step 2로 진행.

요청이 없는 경우 — §A 번호 블록으로 채팅에 출력하고 답변을 기다린다:

무엇을 도와드릴까요?
1. 자유 요청 (추천) — 하고 싶은 작업을 자유롭게 말씀해주세요. 예: '내일 오후 2시에 팀 회의 잡고 참석자에게 메일 보내줘'
2. 오늘 일정 확인 — Google Calendar 오늘 일정 조회
3. 이메일 확인 — Gmail 최근 읽지 않은 이메일 확인
4. 사용법 안내 — Nopal이 할 수 있는 일과 예시

• 1 또는 자유 입력 → 입력 텍스트를 요청으로 사용, Step 2로 진행
• 2 → "오늘 일정을 확인해줘"로 설정, Step 2로 진행
• 3 → "읽지 않은 이메일을 확인해줘"로 설정, Step 2로 진행
• 4 → 아래 안내를 채팅에 출력하고 종료:

Nopal은 Google Workspace 9개 서비스를 자연어로 자동 조합합니다.

지원 서비스: Gmail, Calendar, Drive, Sheets, Docs, Slides, Chat, Tasks, Meet

사용 예시:
  내일 오전 10시에 팀 회의 잡아줘
  지난주 매출 스프레드시트에서 합계 구해줘
  회의록을 Google Docs로 만들고 참석자에게 공유해줘
  읽지 않은 이메일 중 중요한 것만 요약해줘

여러 서비스를 조합하는 복잡한 요청도 가능합니다:
  내일 회의 참석자 목록을 스프레드시트로 만들고 각자에게 메일로 안건 보내줘

Step 2: 의도 파악

사용자의 자연어 요청을 분석하여 다음을 결정한다:

2-1. 필요한 서비스 식별

요청에서 키워드와 의도를 추출하여 9개 서비스 중 어떤 것이 필요한지 판별한다.

하나의 요청에 여러 서비스가 관여할 수 있다. 예: "회의 참석자에게 메일 보내줘" → Calendar + Gmail

2-2. 실행 유형 판별

Step 3: 인터뷰 (부족한 정보 수집)

원칙: 질문은 최소화한다. 필요한 것만 묻는다.

3-1. 정보 갭 분석 (내부 처리)

요청 실행에 필요한 파라미터를 나열하고, 이미 주어진 것과 부족한 것을 구분한다.

예시 — "내일 오후 2시에 팀 회의 잡아줘":

• 날짜: 내일 (주어짐)
• 시간: 오후 2시 (주어짐)
• 제목: 팀 회의 (주어짐)
• 참석자: ? (부족)
• 시간 길이: ? (부족, 기본값 1시간 사용 가능)
• 장소/링크: ? (부족)

3-2. 기존 데이터 조회 후 옵션 제시

가능하면 Google Workspace에서 데이터를 먼저 조회하여 선택지에 반영한다.

예시 — "어떤 회의를 준비할까요?" 대신:

1. gws calendar +agenda --days 3 --format json 실행
2. 결과에서 회의 목록 추출
3. §A 번호 블록으로 회의 목록을 선택지로 제시

어떤 회의를 준비할까요?
1. 내일 10:00 — 주간 스탠드업 (참석자 5명, Google Meet)
2. 내일 14:00 — 프로젝트 리뷰 (참석자 3명, 회의실 B)
3. 모레 09:00 — 전체 회의 (참석자 12명, 대회의실)
4. 직접 입력해주세요

3-3. 질문 방식 (§A 번호 블록)

부족한 파라미터가 있을 때만 질문한다. 질문은 $PLUGIN_ROOT/shared/questioning-policy.md §A의 번호형 선택지 블록을 채팅에 출력하고 사용자의 다음 답변을 읽는다.

규칙:

• 존재하지 않는 객관식 카드 UI를 가정하지 않는다. 반드시 §A 번호 블록을 채팅에 출력한다.
• 질문은 한 번에 묶어서 한다 (라운드트립 최소화).
• 기본값으로 해결 가능한 파라미터는 질문하지 않고 기본값을 사용한다.
  • 회의 시간: 기본 1시간
  • 이메일 형식: 기본 일반 텍스트
  • 파일 공유 권한: 기본 "보기 가능"
• 모호한 요청의 경우에만 명확화 질문을 한다.

인터뷰 패턴 예시:

요청: "회의 준비해줘"
→ [Calendar 조회 후] 번호 블록으로 회의 목록 제시
→ "자료도 공유할까요? 1. 네  2. 아니오"
→ "참석자에게 메일도 보낼까요? 1. 네  2. 아니오"

요청: "보고서 보내줘"
→ [Drive 조회 후] 번호 블록으로 최근 파일 목록 제시
→ "누구에게 보낼까요? (이메일 주소를 적어주세요)"

요청: "이번 주 할일 정리해줘"
→ [Tasks 조회 후] 바로 정리 (추가 질문 불필요)

Step 4: 계획 수립

4-1. 레퍼런스 로딩

필요한 서비스의 reference 파일만 선택적으로 읽는다.

$PLUGIN_ROOT/skills/nopal/references/gws-shared.md          (항상 읽기)
$PLUGIN_ROOT/skills/nopal/references/gws-{서비스명}.md       (필요한 서비스만)

예: Gmail + Calendar 조합이면:

$PLUGIN_ROOT/skills/nopal/references/gws-shared.md
$PLUGIN_ROOT/skills/nopal/references/gws-gmail.md
$PLUGIN_ROOT/skills/nopal/references/gws-calendar.md

reference 파일이 없으면 이 SKILL.md의 명령어 가이드와 헬퍼 목록을 기반으로 동작한다.

4-2. 프리셋 패턴 확인

references/ 폴더에 workflows.md, recipes.md가 있으면 참조하여 검증된 패턴을 우선 사용한다. 없어도 동적으로 새 조합을 생성할 수 있다. 프리셋에 없다고 거부하지 않는다.

4-3. ExecutionPlan 동적 생성

실행할 gws 명령어를 순서대로 나열한다. 각 단계는 다음 정보를 포함:

예시 ExecutionPlan:

| # | 서비스 | 작업 | 의존 |
|---|--------|------|------|
| 1 | Calendar | 내일 일정 조회 | - |
| 2 | Docs | 회의록 문서 생성 | - |
| 3 | Drive | 회의록 참석자에게 공유 | 1, 2 |
| 4 | Gmail | 참석자에게 회의록 링크 메일 발송 | 1, 2, 3 |

4-4. 사용자 확인 (조건부)

읽기 전용 단순 조회는 확인 없이 바로 실행한다.

단순 조회 판별 기준:

• 서비스 1개만 사용
• 명령어가 list, get, +triage, +agenda 등 읽기 전용
• create, send, insert, update, delete, trash, modify, patch 등 쓰기 동작이 없음

단순 조회가 아닌 경우, 계획을 마크다운 테이블로 보여주고 확인을 받는다.

§A 번호 블록으로 확인을 받는다:

이렇게 실행할까요?
[계획 테이블]

1. 네, 실행해주세요 (추천) — 위 계획대로 순서대로 실행합니다.
2. 수정할 부분이 있어요 — 변경하고 싶은 단계를 알려주세요.
3. 취소 — 실행하지 않고 종료합니다.

• 1 → Step 5로 진행
• 2 → 사용자 피드백 반영 후 계획 재수립
• 3 → 종료

Step 5: 실행

사용자가 확인한 ExecutionPlan을 순서대로 셸에서 실행한다.

5-1. 명령어 실행 규칙

5-2. 서비스별 명령어 가이드

Gmail

이메일 발송 — 한글 인코딩 필수 규칙:

gws gmail +send는 한글 제목을 RFC 2047 인코딩하지 않아 수신 시 깨진다. 한글이 포함된 메일은 반드시 아래 raw API 방식을 사용한다.

# 이메일 보내기 (한글 지원 — raw API)
# 1. RFC 2822 메시지를 만들어 base64url로 인코딩
RAW=$(node -e "
const to='user@example.com';
const subject='한글 제목';
const body='한글 본문 내용';
const mime=[
  'MIME-Version: 1.0',
  'Content-Type: text/plain; charset=utf-8',
  'Content-Transfer-Encoding: base64',
  'To: '+to,
  'Subject: =?UTF-8?B?'+Buffer.from(subject).toString('base64')+'?=',
  '',
  Buffer.from(body).toString('base64')
].join('\r\n');
process.stdout.write(Buffer.from(mime).toString('base64url'));
")
gws gmail users messages send --params '{"userId":"me"}' --json "{\"raw\":\"$RAW\"}"

# CC/BCC 포함 시 mime 배열에 추가:
#   'Cc: cc@example.com',
#   'Bcc: bcc@example.com',

# 이메일 목록 조회 (헬퍼 — 추천)
# "안 읽은 메일" → 기본 쿼리(is:unread) 사용
gws gmail +triage --format json
# "최근 메일", "지금 온 메일" → 읽음 상관없이 최근 메일 전체
gws gmail +triage --max 10 --query 'newer_than:1d' --format json
# 특정 조건 검색
gws gmail +triage --max 10 --query 'from:boss' --format json

# 주의: "메일 확인해줘", "지금 온 메일" 등 일반적 요청은 is:unread가 아닌
# newer_than:1d 또는 조건 없이 최근 메일을 보여준다. "안 읽은 메일"이라고
# 명시한 경우에만 is:unread를 사용한다.

# 이메일 목록 조회 (API — 세밀한 검색 시)
# 주의: 반드시 "users messages"로 호출. "messages"만 쓰면 에러남
gws gmail users messages list --params '{"userId":"me","maxResults":10}' --format json

# 이메일 상세 읽기
gws gmail users messages get --params '{"userId":"me","id":"MESSAGE_ID"}' --format json

# 이메일 휴지통 이동 (gws 0.6.1+ 에서 411 버그 수정됨)
gws gmail users messages trash --params '{"userId":"me","id":"MESSAGE_ID"}'

Calendar

# 일정 조회 (헬퍼)
gws calendar +agenda --days 7 --format json

# 일정 생성 (헬퍼)
# --summary (NOT --title), --start, --end 필수. --location, --description, --attendee 선택
gws calendar +insert --summary "회의 제목" --start "2026-03-06T14:00:00+09:00" --end "2026-03-06T15:00:00+09:00"
gws calendar +insert --summary "팀 미팅" --start "2026-03-06T14:00:00+09:00" --end "2026-03-06T15:00:00+09:00" --attendee "alice@example.com" --location "회의실 B"

# 일정 생성 (참석자 포함, 직접 API)
gws calendar events insert --params '{"calendarId": "primary"}' --json '{
  "summary": "팀 회의",
  "start": {"dateTime": "2026-03-06T14:00:00+09:00"},
  "end": {"dateTime": "2026-03-06T15:00:00+09:00"},
  "attendees": [
    {"email": "alice@example.com"},
    {"email": "bob@example.com"}
  ]
}' --format json

# 일정 수정
gws calendar events patch --params '{"calendarId": "primary", "eventId": "EVENT_ID"}' --json '{
  "summary": "수정된 제목"
}' --format json

# 일정 삭제
gws calendar events delete --params '{"calendarId": "primary", "eventId": "EVENT_ID"}'

Drive

# 파일 업로드 (헬퍼) — 파일 경로는 위치 인자 (--file 아님)
gws drive +upload /path/to/file.pdf
gws drive +upload /path/to/file.pdf --parent FOLDER_ID --name "새이름.pdf"

# 파일 목록 조회
gws drive files list --params '{"q": "name contains '''Report'''", "pageSize": 10}' --format json

# 파일 공유 (권한 추가)
gws drive permissions create --params '{"fileId": "FILE_ID"}' --json '{
  "role": "reader",
  "type": "user",
  "emailAddress": "user@example.com"
}' --format json

# 폴더 생성
gws drive files create --json '{
  "name": "새 폴더",
  "mimeType": "application/vnd.google-apps.folder"
}' --format json

Sheets

# 시트 읽기 (헬퍼) — --spreadsheet (NOT --spreadsheet-id)
gws sheets +read --spreadsheet "SHEET_ID" --range "Sheet1!A1:D" --format json
# 한글 시트명은 range에서 제외하고 A1:D만 쓰면 첫 시트 자동 선택
gws sheets +read --spreadsheet "SHEET_ID" --range "A1:D10" --format json

# 시트에 데이터 추가 (헬퍼) — --spreadsheet, --values (단일 행) 또는 --json-values (다중 행)
gws sheets +append --spreadsheet "SHEET_ID" --values '이름,점수,홍길동,95'
gws sheets +append --spreadsheet "SHEET_ID" --json-values '[["이름","점수"],["홍길동","95"]]'

# 새 스프레드시트 생성
gws sheets spreadsheets create --json '{
  "properties": {"title": "매출 보고서"}
}' --format json

# 셀 값 업데이트
gws sheets spreadsheets.values update --params '{"spreadsheetId": "SHEET_ID", "range": "Sheet1!A1:B2", "valueInputOption": "USER_ENTERED"}' --json '{
  "values": [["이름", "점수"], ["홍길동", "95"]]
}' --format json

Docs

# 문서에 텍스트 추가 (헬퍼) — --document (문서 ID), --text (추가할 텍스트)
# 기존 문서 끝에 텍스트를 삽입한다. 새 문서 생성은 아래 create 사용
gws docs +write --document "DOC_ID" --text "회의 내용..."

# 문서 읽기
gws docs documents get --params '{"documentId": "DOC_ID"}' --format json

# 새 문서 생성
gws docs documents create --json '{
  "title": "프로젝트 보고서"
}' --format json

# 문서에 텍스트 삽입
gws docs documents batchUpdate --params '{"documentId": "DOC_ID"}' --json '{
  "requests": [
    {
      "insertText": {
        "location": {"index": 1},
        "text": "삽입할 텍스트"
      }
    }
  ]
}' --format json

Slides

# 새 프레젠테이션 생성
gws slides presentations create --json '{
  "title": "분기 발표"
}' --format json

# 슬라이드 추가
gws slides presentations batchUpdate --params '{"presentationId": "PRES_ID"}' --json '{
  "requests": [
    {
      "createSlide": {
        "slideLayoutReference": {"predefinedLayout": "TITLE_AND_BODY"}
      }
    }
  ]
}' --format json

# 프레젠테이션 읽기
gws slides presentations get --params '{"presentationId": "PRES_ID"}' --format json

Chat

# 메시지 보내기 (헬퍼)
gws chat +send --space "spaces/SPACE_ID" --text "안녕하세요"

# 스페이스 목록 조회
gws chat spaces list --format json

# 메시지 목록 조회
gws chat spaces.messages list --params '{"parent": "spaces/SPACE_ID"}' --format json

Tasks

# 태스크 목록 조회
gws tasks tasklists list --format json

# 태스크 조회
gws tasks tasks list --params '{"tasklist": "TASKLIST_ID"}' --format json

# 태스크 생성
gws tasks tasks insert --params '{"tasklist": "TASKLIST_ID"}' --json '{
  "title": "보고서 작성",
  "due": "2026-03-10T00:00:00Z",
  "notes": "분기 매출 보고서"
}' --format json

# 태스크 완료 처리
gws tasks tasks patch --params '{"tasklist": "TASKLIST_ID", "task": "TASK_ID"}' --json '{
  "status": "completed"
}' --format json

Meet

# 회의 공간(링크) 생성
gws meet spaces create --json '{}' --format json

# 회의 공간 조회
gws meet spaces get --params '{"name": "spaces/SPACE_ID"}' --format json

# 회의 기록 목록
gws meet conferenceRecords list --format json

# 특정 회의 참가자 조회
gws meet conferenceRecords.participants list --params '{"parent": "conferenceRecords/RECORD_ID"}' --format json

# 회의 녹화 조회
gws meet conferenceRecords.recordings list --params '{"parent": "conferenceRecords/RECORD_ID"}' --format json

# 회의 스크립트 조회
gws meet conferenceRecords.transcripts list --params '{"parent": "conferenceRecords/RECORD_ID"}' --format json

# 진행 중인 회의 종료
gws meet spaces endActiveConference --params '{"name": "spaces/SPACE_ID"}' --format json

5-3. 결과 체이닝 패턴

이전 단계의 출력에서 다음 단계에 필요한 값을 추출한다.

# 예: 파일 생성 → 공유
# Step 1: 파일 ID 추출
FILE_ID=$(gws docs documents create --json '{"title": "회의록"}' --format json | jq -r '.documentId')

# Step 2: 추출된 ID로 공유
gws drive permissions create --params "{\"fileId\": \"$FILE_ID\"}" --json '{
  "role": "writer",
  "type": "user",
  "emailAddress": "colleague@example.com"
}' --format json

# 예: 일정 조회 → 참석자 추출 → 메일 발송
# Step 1: 일정에서 참석자 이메일 추출
ATTENDEES=$(gws calendar events get --params '{"calendarId": "primary", "eventId": "EVENT_ID"}' --format json | jq -r '.attendees[].email')

# Step 2: 각 참석자에게 메일 발송
for EMAIL in $ATTENDEES; do
  gws gmail +send --to "$EMAIL" --subject "회의 안건" --body "내일 회의 안건입니다."
done

5-4. 에러 처리

실행 중 에러가 발생하면:

1. 실패한 단계를 기록한다 (명령어, 에러 메시지).
2. 해당 단계에 의존하는 후속 단계도 스킵한다.
3. 의존하지 않는 나머지 단계는 계속 진행한다.
4. 전체를 중단하지 않는다.

에러 메시지 예시:

Step 3 실패: Drive 파일 공유
  에러: 파일 ID가 유효하지 않습니다.
  원인: Step 2에서 파일 생성에 실패하여 ID를 가져올 수 없었습니다.
  → Step 4 (메일 발송)는 파일 링크 없이 진행합니다.

Step 6: 결과 요약

모든 단계 실행 완료 후 사용자에게 통합 리포트를 제공한다.

6-1. 리포트 형식

JSON 덤프를 하지 않는다. 사람이 읽기 쉬운 요약으로 정리한다.

## 실행 결과

### 완료된 작업
1. Calendar: 내일 오후 2시에 "팀 회의" 일정 생성 완료
   - 참석자: alice@example.com, bob@example.com
   - Google Meet 링크: https://meet.google.com/xxx-xxxx-xxx

2. Docs: "팀 회의 안건" 문서 생성 완료
   - 문서 링크: https://docs.google.com/document/d/xxx

3. Gmail: 참석자 2명에게 회의 안건 메일 발송 완료
   - 제목: "내일 팀 회의 안건"

### 실패한 작업
(없음)

### 다음에 할 수 있는 작업
- "회의 끝나면 회의록 정리해줘"
- "참석자에게 후속 할일 배정해줘"

6-2. 리포트 규칙

절대 하지 마 (DO NOT)

1. gws CLI를 거치지 않고 Google API를 직접 HTTP 호출하지 마. 모든 Google Workspace 상호작용은 반드시 gws 명령어를 통한다.
2. OAuth 토큰이나 API 키를 하드코딩하지 마. gws CLI가 토큰을 자체 관리한다.
3. 존재하지 않는 객관식 카드 UI를 가정하지 마. 질문은 반드시 §A 번호 블록을 채팅에 출력한다.
4. references/ 파일을 실행 시점에 전부 읽지 마. 필요한 서비스의 reference만 선택적으로 읽는다.
5. 사용자에게 gws 명령어를 직접 타이핑하라고 안내하지 마. Nopal이 셸에서 대신 실행한다.
6. 프리셋 패턴에 없다고 거부하지 마. references를 참고해서 동적으로 새 조합을 생성한다.
7. 실행 중 에러가 나면 전체를 중단하지 마. 실패한 단계만 보고하고 나머지는 계속 진행한다.
8. gws CLI 미설치 시 안내만 하지 마. npm install -g @googleworkspace/cli로 자동 설치한다. 실패 시에만 수동 안내.
9. 원시 JSON을 결과로 출력하지 마. 사람이 읽기 쉬운 요약으로 정리한다.
10. 쓰기/복합 작업을 사용자 확인 없이 실행하지 마. 계획을 보여주고 확인받은 후 실행한다. (읽기 전용 단순 조회는 확인 생략 — Step 4-4)

항상 해 (ALWAYS DO)

1. 실행 시 gws auth status로 인증 상태를 먼저 확인한다. (Step 0)
2. 사용자 요청이 모호하면 §A 번호 블록으로 명확화한다. 추론 가능한 건 묻지 않는다 (§1 + §2c). 열린 텍스트 질문은 핵심 의도 파악 시에만.
3. 쓰기/복합 작업은 실행 계획 미리보기를 보여주고 확인받은 후 실행한다.
4. 각 gws 명령어 실행 후 결과를 파싱하여 다음 단계에 필요한 ID/값을 추출한다.
5. 최종 결과를 사람이 읽기 쉬운 요약으로 정리한다. JSON 덤프 금지.
6. 에러 발생 시 친절한 한글 메시지로 안내하고 해결 방법을 제시한다.
7. references/에서 해당 서비스의 정확한 gws 명령어 구문을 확인한 후 실행한다.
8. 헬퍼 명령어가 있는 서비스는 헬퍼를 우선 사용한다. 직접 API는 헬퍼로 불가능할 때만.
9. --format json을 사용하여 구조화된 출력을 획득한다. 파싱과 체이닝을 위해 필수.
10. 실행 결과에 생성된 리소스의 직접 링크를 포함한다. (문서 URL, 일정 링크 등)

복합 조합 예시

예시 1: 회의 준비 자동화

요청: "내일 팀 회의 준비해줘"

ExecutionPlan:
| # | 서비스 | 작업 | 의존 |
|---|--------|------|------|
| 1 | Calendar | 내일 팀 회의 일정 조회 | - |
| 2 | Docs | 회의 안건 문서 생성 | 1 |
| 3 | Drive | 문서를 참석자에게 공유 | 1, 2 |
| 4 | Gmail | 참석자에게 안건 메일 발송 | 1, 2, 3 |

# Step 1: 내일 일정 조회
gws calendar +agenda --days 2 --format json

# Step 2: 회의록 문서 생성
DOC_ID=$(gws docs documents create --json '{"title": "팀 회의 안건 - 2026-03-06"}' --format json | jq -r '.documentId')

# Step 3: 참석자에게 문서 공유
gws drive permissions create --params "{\"fileId\": \"$DOC_ID\"}" --json '{
  "role": "writer",
  "type": "user",
  "emailAddress": "alice@example.com"
}' --format json

# Step 4: 메일 발송
gws gmail +send --to "alice@example.com" --subject "내일 팀 회의 안건" --body "안건 문서를 공유드립니다: https://docs.google.com/document/d/$DOC_ID"

예시 2: 주간 보고서 자동화

요청: "이번 주 매출 시트에서 합계 구하고 보고서 만들어서 팀장에게 보내줘"

ExecutionPlan:
| # | 서비스 | 작업 | 의존 |
|---|--------|------|------|
| 1 | Sheets | 매출 시트 데이터 읽기 | - |
| 2 | Docs | 매출 요약 보고서 문서 생성 | 1 |
| 3 | Gmail | 팀장에게 보고서 메일 발송 | 2 |

# Step 1: 시트 데이터 읽기
SALES_DATA=$(gws sheets +read --spreadsheet "SHEET_ID" --range "A1:D50" --format json)

# Step 2: 보고서 문서 생성 후 내용 추가
DOC_ID=$(gws docs documents create --json '{"title":"주간 매출 보고서 - 2026 W10"}' --format json | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>console.log(JSON.parse(d).documentId))")
gws docs +write --document "$DOC_ID" --text "이번 주 매출 요약..."

# Step 3: 팀장에게 메일 발송
gws gmail +send --to "manager@example.com" --subject "주간 매출 보고서" --body "보고서 링크: https://docs.google.com/document/d/$DOC_ID"

예시 3: 할일 관리 + 알림

요청: "오늘 마감인 할일 확인하고 못 끝낸 거 내일로 옮겨줘"

ExecutionPlan:
| # | 서비스 | 작업 | 의존 |
|---|--------|------|------|
| 1 | Tasks | 오늘 마감 태스크 조회 | - |
| 2 | Tasks | 미완료 태스크 마감일을 내일로 수정 | 1 |
| 3 | Chat | 미완료 태스크 알림 메시지 전송 (선택) | 1 |

# Step 1: 태스크 조회
gws tasks tasks list --params '{"tasklist": "TASKLIST_ID"}' --format json

# Step 2: 미완료 태스크 마감일 수정
gws tasks tasks patch --params '{"tasklist": "TASKLIST_ID", "task": "TASK_ID"}' --json '{
  "due": "2026-03-06T00:00:00Z"
}' --format json