gws-peopleGoogle官方放心用让 AI 替你查、增、改、删 Google 通讯录里的联系人与分组。
该技能把 Google People API v1 包装成 `gws people <resource> <method>` 命令，覆盖 people、contactGroups、otherContacts 三类资源。AI 可以列出、搜索、创建、更新和删除联系人及分组，把「其他联系人」复制到「我的联系人」，批量导入或修改联系人，还能设置或删除头像。若 Google Workspace 已开启目录，也支持查询域内人员和资料。授权、全局参数和安全规则统一由 `gws-shared` 处理，无需单独配置 People API 凭证。
适合经常维护 Gmail 或 Google Workspace 通讯录的场景，例如批量导入客户名片、统一更新团队联系方式、按项目整理分组等。前提是你已安装 `gws` CLI 并完成 `gws-shared` 的授权。注意：同一用户的写操作应串行执行，分组名不能重复（重复会报 409），搜索联系人前要先发一次空查询做缓存预热，「其他联系人」的同步令牌 7 天后会过期。
在下面找到你用的工具，复制命令粘进终端就装好了：
npx skills add googleworkspace/cli装好后不用任何配置，直接在对话里说：
把我 Google 通讯录里名字带‘张’的联系人都列出来，并分组显示。AI 检测到任务匹配时会自动加载这个 Skill，不需要手动开关。
SKILL.md 先安装 `gws` CLI 并阅读 `gws-shared/SKILL.md` 完成 OAuth 授权和全局参数设置；`gws-people` 依赖这套鉴权，无法单独调用 People API。
Google 要求同一用户的分组名必须唯一，且写操作需要串行执行；重复名称或并发修改会触发 409 错误。
People API 的 `searchContacts` 与 `searchOtherContacts` 需要先发送空查询来更新缓存，否则可能返回不完整结果。