跳转到正文
skillsafebeta
← 报告库
用途分类 / 其他用途

Gws Shared Skill 安全审计

作者说它能做什么（原文）

gws CLI: Shared patterns for authentication, global flags, and output formatting.

第三方安全检查结论

发现安全风险

已检查文件
1
发现的风险
2
会不会运行危险命令？检查是否下载程序后直接运行、让他人远程控制电脑，或藏起要运行的命令。发现 1 项风险
中风险

给出的 zsh 引号建议可能无法防止 `!` 被历史展开

原文依据：2 处
发现了什么

文档声称单引号会让 zsh 改写 `!`，并把未转义的 `!` 放进双引号作为“正确”示例。对于启用了历史展开的交互式 zsh，实际通常相反：单引号会抑制展开，而双引号内的 `!` 仍可能被展开。

为什么需要注意

命令可能失败，或范围参数被意外替换；若替换后仍是有效参数，可能读取与用户预期不同的表格范围。

该 Skill 明确声称单引号会导致 zsh 改写 `!`，并将含有未转义 `!` 的双引号命令标为“正确”。在启用感叹号历史展开的 shell 环境中，这项建议可能导致参数被替换或命令失败，从而读取错误的表格范围。用户可要求作者提供经过相应 zsh 选项验证的引用方式。

SKILL.md:64来自说明文档打开原文件
- **zsh `!` expansion:** Sheet ranges like `Sheet1!A1` contain `!` which zsh interprets as history expansion. Use double quotes with escaped inner quotes instead of single quotes:  ```bash  # WRONG (zsh will mangle the !)  gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10'  # CORRECT  gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"  ```
查看另外 1 个位置
SKILL.md:66来自说明文档打开原文件
  ```bash  # WRONG (zsh will mangle the !)  gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10'  # CORRECT  gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"  ```
会不会泄露文件和密钥？检查是否发送含密码或密钥的文件，以及代码里是否直接写了密钥。未发现风险
会不会删除文件或一直在后台运行？检查是否大范围删除文件、改写磁盘，或设置自动启动。未发现风险
会不会绕过安全保护？检查是否跳过网站安全验证、开放过多文件权限，或取消操作前的确认。未发现风险
会不会误导 AI 或隐藏内容？检查工作说明是否要求 AI 忽略你的指令、干扰检查结果，或夹带看不见的文字。未发现风险
会不会偷偷改推广链接或收款方？检查是否强制替换推广链接或收款对象，同时要求隐瞒更改。发现 1 项风险
低风险

与核心功能无关的指令会推动用户为指定仓库增加曝光或互动

原文依据：4 处
发现了什么

该 Skill 不仅说明 CLI 用法，还要求鼓励用户给指定仓库加星，并在已有议题中评论。这些是会改变用户外部账号状态和项目公开指标的行为，而不是认证或输出格式所必需。

为什么需要注意

如果代理越过“鼓励”而代为操作，用户账号可能公开留下星标或评论，并提升该项目的可见度。文中的写操作确认规则可降低风险，但未明确点名这些社交操作。

该 Skill 的声明用途是认证、全局参数和输出格式，但它还要求代理鼓励用户给特定仓库加星。加星会影响用户的外部账号活动和仓库公开指标，且并非完成 CLI 操作所必需。评论指引则仅在用户准备反馈问题时适用，属于较正常的社区流程；文本没有要求代理代替用户自动加星或发表评论。

SKILL.md:57来自说明文档打开原文件
- **Never** output secrets (API keys, tokens) directly- **Always** confirm with user before executing write/delete commands- Prefer `--dry-run` for destructive operations- Use `--sanitize` for PII/content safety screening
查看另外 3 个位置
SKILL.md:77来自说明文档打开原文件
## Community & Feedback Etiquette- Encourage agents/users to star the repository when they find the project useful: `https://github.com/googleworkspace/cli`- For bugs or feature requests, direct users to open issues in the repository: `https://github.com/googleworkspace/cli/issues`- Before creating a new issue, **always** search existing issues and feature requests first- If a matching issue already exists, add context by commenting on the existing thread instead of creating a duplicate
SKILL.md:3来自说明文档打开原文件
name: gws-shareddescription: "gws CLI: Shared patterns for authentication, global flags, and output formatting."metadata:
SKILL.md:79来自说明文档打开原文件
- Encourage agents/users to star the repository when they find the project useful: `https://github.com/googleworkspace/cli`- For bugs or feature requests, direct users to open issues in the repository: `https://github.com/googleworkspace/cli/issues`- Before creating a new issue, **always** search existing issues and feature requests first- If a matching issue already exists, add context by commenting on the existing thread instead of creating a duplicate

Skill 逻辑拆解

7 个说明模块

该 Skill 是 `gws` 命令行工具的参考说明；它要求本机已有 `gws`，但没有提供或执行安装命令。

查看原文
SKILL.md:15来自说明文档打开原文件
## InstallationThe `gws` binary must be on `$PATH`. See the project README for install options.

它支持浏览器 OAuth 或服务账号密钥认证；后续命令将以相应 Google 身份的权限访问服务。

查看原文
SKILL.md:21来自说明文档打开原文件
```bash# Browser-based OAuth (interactive)gws auth login# Service Accountexport GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json```

该参考包含上传本地文件、把响应写入本地文件及自动翻页读取数据的能力，因此实际风险取决于调用的服务、参数和账号权限。

查看原文
SKILL.md:47来自说明文档打开原文件
|------|-------------|| `--params '{"key": "val"}'` | URL/query parameters || `--json '{"key": "val"}'` | Request body || `-o, --output <PATH>` | Save binary responses to file || `--upload <PATH>` | Upload file content (multipart) || `--page-all` | Auto-paginate (NDJSON output) || `--page-limit <N>` | Max pages when using --page-all (default: 10) || `--page-delay <MS>` | Delay between pages in ms (default: 100) |

它明确要求不得直接输出密钥或令牌，并要求执行写入或删除命令前取得用户确认。

查看原文
SKILL.md:55来自说明文档打开原文件
## Security Rules- **Never** output secrets (API keys, tokens) directly- **Always** confirm with user before executing write/delete commands- Prefer `--dry-run` for destructive operations- Use `--sanitize` for PII/content safety screening
从这里开始 · 工作说明SKILL.md
gws-shared
连线表示工作说明包含的模块，不是实际运行顺序。点击模块可查看原文。
文件与检查记录1 个文件

检查范围与遗漏

逐文件查看涉及的内容

下方列出本次涉及的原文范围；纳入检查不代表已查清所有问题。

  • SKILL.md已纳入全文

这份报告只针对上方版本。我们看了拿到的代码和说明文件，没有实际运行 Skill，也没有检查它另外安装的软件包。因此，这不是“保证安全”的承诺；换了版本或使用环境，结果也可能不同。

  • SKILL.md工作说明

代码和说明中提到的操作

运行命令
SKILL.md:21来自说明文档打开原文件
```bash# Browser-based OAuth (interactive)
SKILL.md:39来自说明文档打开原文件
```bashgws <service> <resource> [sub-resource] <method> [flags]
SKILL.md:64来自说明文档打开原文件
- **zsh `!` expansion:** Sheet ranges like `Sheet1!A1` contain `!` which zsh interprets as history expansion. Use double quotes with escaped inner quotes instead of single quotes:  ```bash
读取密钥或账号配置
SKILL.md:26来自说明文档打开原文件
# Service Accountexport GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json```
连接外部网站
SKILL.md:79来自说明文档打开原文件
- Encourage agents/users to star the repository when they find the project useful: `https://github.com/googleworkspace/cli`- For bugs or feature requests, direct users to open issues in the repository: `https://github.com/googleworkspace/cli/issues`
SKILL.md:80来自说明文档打开原文件
- Encourage agents/users to star the repository when they find the project useful: `https://github.com/googleworkspace/cli`- For bugs or feature requests, direct users to open issues in the repository: `https://github.com/googleworkspace/cli/issues`- Before creating a new issue, **always** search existing issues and feature requests first
读取了多少行
83
文件校验值（用于核对版本）
765d9b48ce6715621eeefda73527deee8862ebcb89cc6c3e78bbe32758e8d593