gws-people

gws-people 技能概览

gws-people 技能能做什么

gws-people 技能是 googleworkspace/cli 里的 Google People API 工作流。它让你可以通过命令行，使用 gws people 系列命令管理联系人、联系人组和与个人资料相关的记录。需要的是可重复执行的联系人操作时，就用 gws-people 技能，而不是一次性的临时提示词。

适合谁安装

如果你的工作涉及 CRM Operations、管理工具或自动化任务，而且需要稳定地查看、分组或更新联系人数据，这个技能很合适。它最适合想要用结构化 CLI 流程处理 Google People，而不是手动翻 API 文档或猜请求格式的人。

采纳前最重要的点

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，了解认证、全局 flags 和安全规则。如果你的 workspace 里还没有它，先运行 gws generate-skills。这一步很重要，因为 gws-people 的使用依赖的是共享 CLI 约定，而不只是技能文件夹本身。

按命令模式来组织你的需求

一个有效的提示词应该明确说明资源、方法、目标账号上下文和期望结果。比如，你可以要求生成“一个用于查看我联系人组的 gws people contactGroups list 命令”，或者“一个先创建再重命名联系人组的安全操作顺序”。如果你是为了 CRM Operations 使用 gws-people，还要注明你的目标是审计、清理、分群还是同步联系人，因为这会直接影响应该选用哪个资源和方法。

先看对的文件

先读 SKILL.md，再查看 ../gws-shared/SKILL.md。如果你是在判断这个技能是否适合你的工作流，应该先看 SKILL.md 里的 API 资源列表。那里会清楚地划出实际边界：支持 contactGroups、otherContacts 和 people，但它不是通用 CRM。

在工作流约束下使用这个技能

gws-people 最适合的场景，是你能接受同一用户的写操作按顺序执行，并避免 API 并不擅长支持的批处理假设。对于高信号任务，最好直接要求精确的资源、最安全的方法，以及变更后的验证步骤。如果你不确定目标资源，先让它给出发现类命令，而不要直接跳到修改操作。

gws-people 技能常见问题

gws-people 只适合高级用户吗？

不是。只要能跟着 CLI 流程走，并愿意先检查共享的 gws 环境，初学者也能用。这个技能更强调选对资源和方法，而不是写复杂代码。

什么情况下不该用 gws-people？

如果你需要的是完整 CRM 系统、只能在界面里操作的联系人管理，或者非 Google 数据源，就不适合用它。它也不适合用于 People API 模型之外、没有明确支持的联系人自动化任务。

它和普通提示词有什么不同？

普通提示词可能只给你一个泛泛的答案。gws-people 技能会给你一套命令形态的工作流、相关的资源集合，以及一个关键约束：对同一用户的修改请求应当顺序执行。这样一来，在 Google Workspace 管理或 CRM Operations 场景下做事，试错会少很多。

最主要的安装依赖是什么？

核心依赖是 gws CLI，以及共享的 gws 技能上下文。如果基础层缺失或配置不正确，只装 gws-people 也不足以让整个工作流真正可用。

如何改进 gws-people 技能

给技能一个明确的操作目标

gws-people 想要获得好结果，提示词里最好同时说明对象、动作和范围。“列出当前认证用户的所有联系人组”就比“帮我处理联系人”更好。“更新一个指定名称的联系人组并避免重复”也比“修一下我的分组”更清楚。目标越精确，技能就越容易选对 People 资源，也越能避免不必要的步骤。

加上最关键的操作约束

如果你的任务涉及写入，就要说明这次变更是否必须安全、顺序执行、可审计或可回滚。仓库说明里提到，同一用户的变更具有顺序性，这类细节会实质性影响输出质量。对于 CRM Operations，也要注明任务是清理、补全、分组还是资料审核。

先发现，再执行

高质量的 gws-people 指南通常会先从 read 或 list 命令开始，再收窄到单次修改。如果第一次输出还是太宽泛，就继续要求给出精确的 gws people 命令、所需 flags，以及变更后的验证检查。这样得到的 gws-people 使用方式，通常比一次性要求一个完全泛化的工作流更好。