gws-workflow

gws-workflow 스킬 개요

gws-workflow가 하는 일

gws-workflow 스킬은 gws CLI를 위한 Google Workspace 자동화 레이어입니다. 원시 API 구조를 먼저 추측하지 않아도 회의 준비, 스탠드업 요약, 이메일을 작업으로 전환, Drive에서 Chat 공지 생성 같은 교차 서비스 워크플로를 실행할 수 있게 도와줍니다.

누가 설치하면 좋은가

이미 gws를 사용하고 있고, 일회성 프롬프트가 아니라 반복 가능한 운영 워크플로가 필요하다면 gws-workflow를 설치하세요. Gmail, Calendar, Tasks, Drive, Chat을 하나의 결과로 엮어야 하는 에이전트에 특히 잘 맞습니다.

무엇이 다른가

gws-workflow 스킬의 핵심 가치는 실행 전에 명령을 찾아보고 입력을 올바르게 구성하도록 안내한다는 점입니다. 워크플로 실패는 대개 작업 자체보다 필수 파라미터 누락, 잘못된 resource-method 조합, 스키마 단계 생략 때문에 발생하기 때문입니다.

gws-workflow 스킬 사용 방법

설치 및 사전 준비

gws-workflow install을 사용할 때는 CLI 스킬 설치 흐름을 따르고, 먼저 공유 인증 계층이 준비되어 있는지 확인하세요. 이 스킬은 명시적으로 ../gws-shared/SKILL.md에 의존하므로, 해당 파일이 없다면 gws generate-skills를 실행해 인증, 전역 플래그, 보안 규칙을 먼저 사용 가능하게 만들어야 워크플로 호출을 진행할 수 있습니다.

먼저 명령을 확인하기

가장 빠른 gws-workflow usage 패턴은 다음 순서입니다: SKILL.md를 읽고, gws workflow --help를 실행한 뒤, gws schema workflow.<resource>.<method>로 대상 메서드를 확인하세요. 이렇게 하면 --params나 --json을 만들기 전에 필요한 파라미터, 타입, 기본값을 가장 안전하게 파악할 수 있습니다.

대략적인 목표를 실행 가능한 프롬프트로 바꾸기

“회의 준비해줘”처럼 느슨한 요청도 리소스, 원하는 출력, 제약 조건을 함께 적으면 훨씬 잘 실행됩니다. 예: “gws workflow calendar.events list와 관련 메서드를 사용해 내일 1:1 회의 브리프를 준비해줘. 참석자, 아젠다 맥락, 연결된 문서를 포함해줘.” 목표가 구체적일수록 에이전트가 엉뚱한 helper 명령을 고를 가능성이 줄어듭니다.

먼저 읽어야 할 파일

먼저 SKILL.md를 읽고, 작업이 번들 워크플로 중 하나와 맞아떨어질 때는 skills/gws-workflow-* 아래에 연결된 helper 명령을 따라가세요. 실무적으로는, 상위 가이드에서 일반화하려 하기보다 현재 업무와 가장 가까운 helper skill부터 읽는 편이 더 정확합니다.

gws-workflow 스킬 FAQ

gws-workflow는 고급 사용자만 쓰는 건가요?

아닙니다. 이 스킬은 Google Workspace API에 익숙하지 않아도 유용합니다. 명령을 찾고 스키마를 확인하는 방법을 알려주기 때문에, 필드 이름을 임의로 가정하지 않아도 되기 때문입니다. 특히 초보자는 파라미터를 즉흥적으로 만들기보다 스키마 단계를 따를 때 가장 큰 도움을 받습니다.

언제 gws-workflow를 쓰지 말아야 하나요?

그냥 자연어 요약이 필요하거나, 실제 Workspace 작업 없이 단발성 응답만 있으면 굳이 쓰지 마세요. gws 명령을 실행할 필요가 없다면 이 스킬은 불필요한 오버헤드입니다.

일반적인 프롬프트와 무엇이 다른가요?

일반적인 프롬프트는 결과를 설명할 수 있지만, gws-workflow는 실행 가능한 워크플로 탐색에 맞춰 설계되어 있습니다. 특히 여러 Google 서비스를 가로질러 올바른 메서드와 플래그가 중요한 경우, 재현 가능한 gws workflow 호출이 필요할 때 더 유리합니다.

더 넓은 Workflow Automation 용도의 gws-workflow에 적합한가요?

네, 다만 자동화가 지원되는 gws 리소스와 메서드에 기반할 때만 그렇습니다. Google Workspace API 범위를 벗어난 커스텀 비즈니스 로직이 필요하다면, 외부 스크립팅이나 오케스트레이션이 여전히 필요합니다.

gws-workflow 스킬 개선 방법

정확한 워크플로 대상을 먼저 제시하기

가장 좋은 gws-workflow 결과는 서비스, 리소스, 원하는 결과를 처음부터 정확히 적을 때 나옵니다. “캘린더”보다 “내일 고객 통화용 Calendar 이벤트 조회”처럼 쓰는 편이 훨씬 낫습니다. 이렇게 하면 명령 탐색 범위가 좁아지고, 첫 결과가 바로 쓸 수 있을 가능성이 높아집니다.

필요한 출력 형태를 함께 적기

요약이 필요한지, 작업이 필요한지, 초안 메시지가 필요한지, 구조화된 명령 호출이 필요한지 분명히 말하세요. 예를 들어 “회의, 열려 있는 작업, 장애 요인을 포함한 스탠드업 요약을 반환해줘”라고 하면, “내 하루를 분석해줘”보다 훨씬 명확한 목표가 됩니다.

실행 전에 스키마를 확인하기

흔한 실패 원인 중 하나는 어떤 메서드가 다른 Google API와 같은 필드를 받는다고 가정하는 것입니다. 입력 구조가 조금이라도 불분명하면 gws schema workflow.<resource>.<method>를 매번 사용하세요. 특히 --params와 --json에서 이 습관이 재시도 횟수를 줄이고, 조용히 어긋나는 매칭을 막아줍니다.

처음부터 새로 만들지 말고 helper 워크플로에서 반복하기

첫 시도가 너무 넓다면 +meeting-prep나 +email-to-task 같은 가장 가까운 helper 명령으로 옮겨서 거기서부터 다듬으세요. 이런 경로는 워크플로 의도를 더 직접적으로 담고 있기 때문에, 새로운 프롬프트를 즉석에서 발명하는 것보다 대개 더 낫습니다.