用途
gws-workflow-file-announce 是 Google Workspace CLI（命令前缀 gws）下 workflow 类别的跨服务工作流命令，用途单一明确：把一个 Google Drive 文件公告到某个 Google Chat 空间。它把 Drive 与 Chat 两个服务串联起来，省去手动查文件名、再手工发消息的步骤。
主要能力
- 根据 --file-id 指定的 Drive 文件 ID，从 Drive 获取该文件的名称，用来自动构建公告内容。
- 向 --space 指定的 Chat 空间发送这条公告消息。
- 支持通过 --message 传入自定义公告文本；若不传，则依据文件信息生成默认公告。
- 支持输出格式选择：json（默认）、table、yaml、csv。
使用方式
前置条件：阅读 ../gws-shared/SKILL.md，了解认证方式、全局标志与安全规则；如果该文件不存在，运行 gws generate-skills 生成它。
命令语法：
gws workflow +file-announce --file-id <ID> --space <SPACE>
参数说明：
- --file-id（必需）：要公告的 Drive 文件 ID。
- --space（必需）：Chat 空间名称，例如 spaces/SPACE_ID。
- --message（可选）：自定义公告消息。
- --format（可选）：输出格式，json（默认）、table、yaml、csv。
示例：
gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123 gws workflow +file-announce --file-id FILE_ID --space spaces/ABC123 --message 'Check this out!'
适用场景
- 把刚上传到 Drive 的文件快速通知到相关 Chat 空间。
- 在自动化脚本或工作流中，把「上传文件」与「通知团队」两步串联起来。
- 需要以编程方式批量发布文件公告的场合。
使用提示与限制
- 这是写命令，会实际向 Chat 空间发送一条消息，使用时需注意权限与影响范围。
- 官方建议先用 gws drive +upload 上传文件，再用本命令进行公告。
- 公告内容中的文件名取自 Drive，因此文件必须可被访问获取。
- 命令依赖 gws-shared 提供的认证与安全规则配置，未完成认证配置时无法使用。
- 关于具体的认证方法、全局标志细节和安全规则，属于 gws-shared 文档内容，本文资料未展开。
相关命令
- gws-shared：全局标志与认证。
- gws-workflow：所有跨服务生产力工作流命令。