gws-people

gws-people 스킬 개요

gws-people 스킬이 하는 일

gws-people 스킬은 googleworkspace/cli 안에서 Google People API 작업을 다루는 워크플로입니다. gws people 계열 명령으로 명령줄에서 연락처, 연락처 그룹, 프로필 관련 레코드를 관리할 수 있게 해줍니다. 한 번 쓰고 끝나는 프롬프트가 아니라, 반복 가능한 연락처 작업이 필요할 때 gws-people 스킬을 사용하세요.

누가 설치하면 좋은가

CRM Operations, 관리자 도구, 자동화 작업처럼 연락처 데이터를 일관되게 조회, 분류, 수정해야 하는 경우에 잘 맞습니다. API 문서를 직접 뒤지거나 요청 형태를 추측하는 대신, Google People을 위한 구조화된 CLI 흐름이 필요할 때 특히 유용합니다.

도입 전에 중요한 점

gws-people의 핵심 가치는 작업 범위를 특정 리소스 집합과 명령 패턴으로 좁혀 준다는 데 있습니다: gws people <resource> <method> [flags]. 반면 가장 큰 제약은 의존성과 맥락입니다. gws 바이너리와 ../gws-shared/SKILL.md에 있는 공통 인증/보안 가이드가 필요합니다. 또한 실제 운영에서 중요한 API 제약도 따르는데, 특히 같은 사용자에 대한 변경 작업은 순차적으로 처리해야 한다는 점을 유념해야 합니다.

gws-people 스킬 사용 방법

공유 설정을 먼저 설치하고 확인하기

npx skills add googleworkspace/cli --skill gws-people로 설치하세요. 무엇을 실행하기 전에 먼저 공통 전제 조건이 갖춰졌는지 확인해야 합니다. 인증, 전역 플래그, 보안 규칙은 ../gws-shared/SKILL.md를 읽어 확인하세요. 작업 공간에 해당 파일이 없다면 먼저 gws generate-skills를 실행하세요. 이 과정이 중요한 이유는 gws-people 사용이 단순히 스킬 폴더만의 문제가 아니라, 공통 CLI 규칙에 의존하기 때문입니다.

명령 패턴에 맞게 요청을 구체화하기

좋은 프롬프트에는 리소스, 메서드, 대상 계정의 맥락, 원하는 결과가 함께 들어가야 합니다. 예를 들어 “내 연락처 그룹을 확인하는 gws people contactGroups list 명령”이라거나 “연락처 그룹을 안전하게 만들고 이름을 바꾸는 순서”처럼 요청할 수 있습니다. CRM Operations용 gws-people라면, 감사(auditing), 정리(cleaning), 세분화(segmenting), 동기화(syncing) 중 무엇인지까지 포함하세요. 그래야 어떤 리소스와 메서드가 맞는지 더 정확해집니다.

먼저 읽어야 할 파일

먼저 SKILL.md를 읽고, 그다음 ../gws-shared/SKILL.md를 확인하세요. 이 스킬이 실제 워크플로에 맞는지 판단하려면, 무엇보다 먼저 SKILL.md의 API 리소스 목록부터 보는 것이 좋습니다. 여기서 실질적인 경계가 드러납니다. contactGroups, otherContacts, people는 지원되지만, 이 스킬은 범용 CRM이 아닙니다.

워크플로 제약을 염두에 두고 사용하기

gws-people는 같은 사용자에 대한 쓰기 작업을 순차적으로 처리하고, API가 잘 지원하지 않는 배치 전제를 피할 때 가장 강합니다. 신호가 분명한 작업을 원한다면, 정확한 리소스, 가장 안전한 메서드, 그리고 변경 후 검증 단계를 함께 요청하세요. 대상 리소스가 불확실하다면 바로 변경으로 들어가지 말고, 먼저 조회용 발견(discovery) 명령을 요청하는 편이 낫습니다.

gws-people 스킬 FAQ

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

아닙니다. CLI 흐름을 따라갈 수 있고, 먼저 공유 gws 설정을 확인할 의지가 있다면 초보자도 사용할 수 있습니다. 이 스킬은 복잡한 코드를 작성하는 문제라기보다, 올바른 리소스와 메서드를 고르는 문제에 더 가깝습니다.

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

폭넓은 CRM 시스템이 필요하거나, UI에서만 처리하는 연락처 관리가 필요하거나, Google이 아닌 데이터 소스를 다뤄야 한다면 사용하지 마세요. People API 모델 밖의 연락처 레코드에 대해 지원되지 않는 자동화가 필요한 경우에도 적합하지 않습니다.

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

일반 프롬프트는 보통 막연한 답변을 내놓을 수 있습니다. 반면 gws-people 스킬은 명령 형태의 작업 흐름, 관련 리소스 집합, 그리고 같은 사용자에 대한 변경 요청은 순차적으로 처리해야 한다는 핵심 제약을 함께 제공합니다. 그 덕분에 Google Workspace 관리자 작업이나 CRM Operations에서 시행착오를 줄일 수 있습니다.

가장 중요한 설치 의존성은 무엇인가요?

핵심 의존성은 gws CLI와 공유 gws 스킬 컨텍스트입니다. 이 기반 계층이 없거나 잘못 설정되어 있으면, gws-people를 설치해도 워크플로를 실제로 쓰기 어렵습니다.

gws-people 스킬 개선 방법

스킬에 정확한 작업 대상을 주기

gws-people에서 가장 좋은 결과를 얻으려면 객체, 작업, 범위를 분명히 적어야 합니다. “현재 인증된 사용자의 모든 연락처 그룹을 나열해 줘”는 “연락처 작업을 도와줘”보다 훨씬 좋습니다. “중복 없이 지정한 연락처 그룹 하나를 업데이트해 줘”는 “내 그룹을 고쳐줘”보다 낫습니다. 이렇게 정확하게 적어야 올바른 People 리소스를 고르고 불필요한 단계를 줄일 수 있습니다.

가장 중요한 운영 제약을 함께 적기

쓰기 작업이 포함된다면, 변경이 안전해야 하는지, 순차적으로 처리되어야 하는지, 감사 가능해야 하는지, 되돌릴 수 있어야 하는지를 명시하세요. 저장소 메모에는 같은 사용자에 대한 순차적 변경 동작이 강조되어 있는데, 이런 세부 정보가 출력 품질을 크게 좌우합니다. CRM Operations라면 작업이 정리(cleanup)인지, 보강(enrichment)인지, 분류(grouping)인지, 프로필 검토(profile review)인지도 함께 적으세요.

발견에서 작업으로 점진적으로 좁히기

좋은 gws-people 가이드는 보통 읽기나 목록 조회 명령으로 시작한 뒤, 단일 변경 작업으로 좁혀 갑니다. 첫 응답이 너무 넓다면, 정확한 gws people 명령, 필요한 플래그, 그리고 변경 후 검증 방법을 다시 요청하세요. 이렇게 해야 한 번에 너무 일반적인 워크플로를 요구하는 것보다 더 나은 gws-people 사용 결과를 얻을 수 있습니다.