📌 gws-shared 是什么？

Google Workspace 各服务有一些共用的能力：认证、通用工具、配置。gws-shared 是官方技能，让 AI 用好这些公共部分。

它是 Workspace 系列技能的基础层，统一处理 OAuth 授权、通用配置，让其他 gws-* 技能都能正常工作。

🧩 核心功能

认证授权：统一处理 OAuth 授权。

通用工具：共用的配置和工具函数。

基础操作：各服务通用的基础能力。

👍 优点

统一认证：一套授权到处用。

基础层：让其他 gws 技能更稳。

官方维护。

⚠️ 不足与局限

偏底层，需配合具体服务技能用。

授权配置要细心。

单独用价值有限。

🙋 适合谁用

开发者：用 Workspace API 开发。

团队：统一接入。

🛠️ 第一次安装

前提：电脑装了 Node.js（18+），有支持 Skill 的 AI 工具（如 Claude Code）。打开终端执行：

bash
npx skills add googleworkspace/cli --skill gws-shared

CLI 会自动检测你装的 AI 助手，确认安装位置后即可使用。

✍️ 上手：几个真实例子

场景一：配授权

提示词
帮我配置 Google Workspace 的 OAuth 授权，供其他服务调用。

场景二：搭基础

提示词
帮我搭好 Workspace 调用的基础配置。

🎯 典型应用场景

授权配置：OAuth 授权。

基础搭建：通用配置。

服务接入：配合其他 gws 技能。

⚖️ 和类似方案对比

gws-shared 不直接干"业务活"，它的价值是"打地基"——把认证、授权、通用工具这些底层能力统一配好，其他 gws-gmail、gws-drive 等技能才能顺畅工作。就像插座，本身不干活，但没它电器都跑不起来。

💡 常见问题 FAQ

问：要单独用吗？
一般配合其他 gws 技能用。

问：授权范围怎么定？
按最小权限开，用到哪开到哪。

问：token 怎么存？
安全存储、定期刷新。

问：和 OAuth 什么关系？
它封装了 OAuth 的配置和调用。

📌 总结

总的来说，gws-shared 的价值在于把原本繁琐、重复、容易出错的工作，变成几句对话就能搞定。如果你正好是它的目标用户，装一个试试——成本很低，上手只要几分钟，带来的效率提升却实实在在。如果需求比较轻量，也可以先让 AI 演示一遍再决定是否长期使用。

🤖 适合哪些 AI 工具

Google Workspace 官方 Skill，Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。