gws-workflow-file-announce

用途

gws-workflow-file-announce 是 gws-claude-plugin 中的一条跨服务工作效率工作流命令，用途是在 Google Chat 空间中公告一个 Google Drive 文件。它把 Drive 与 Chat 打通，适合需要把已上传文件同步告知团队或某个 Chat 空间的场景。

前置条件

使用前需阅读 ../gws-shared/SKILL.md，其中包含认证方式、全局标志和安全规则。如果该文件不存在，可运行 gws generate-skills 来生成。

主要能力

根据文件 ID 从 Drive 获取文件名，用于构建公告内容。
在指定 Chat 空间（格式为 spaces/SPACE_ID）中发送关于该文件的公告消息。
支持通过 --message 传入自定义公告文案。
支持多种输出格式：json（默认）、table、yaml、csv。

使用方式

命令用法：

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!'

使用提示与限制

这是一条写命令，会实际发送一条 Chat 消息。
建议先用 gws drive +upload 上传文件，然后再用本命令进行公告。
公告内容中的文件名会从 Drive 获取。
本资料未提供认证配置、权限范围、错误处理、速率限制或费用相关信息，暂未提供。

适用场景

需要在 Google Chat 空间内告知成员某个 Drive 文件已就绪或可供查看时，可使用本命令；尤其适合先上传文件、再发送公告的两步流程。

技能介绍

用途