gws-classroom

gws-classroom 技能概览

gws-classroom 技能能做什么

gws-classroom 技能可以帮助你通过 gws CLI 管理 Google Classroom 对象：课程、名册、邀请、注册，以及与 coursework 相关的操作。它最适合需要可重复的管理或支持流程，而不是一次次在 Classroom 界面里手动点选完成的场景。

适合谁使用

如果你是教育管理员、工作流自动化作者，或需要批量创建、查看、变更 Classroom 数据的支持人员，就应该使用 gws-classroom 技能。对于资源名称、ID 或生命周期步骤已经明确的任务，它比通用提示词更合适。

为什么值得安装

gws-classroom 技能很适合用于安装决策，因为它只聚焦 Google Workspace 的一个表面，并且直接暴露 API 的资源模型。这让你在真正运行命令之前，就更容易判断权限、对象归属和错误类型。

如何使用 gws-classroom 技能

在 gws CLI 中安装该技能

按照技能文件中的命令，在 googleworkspace/cli 生态中安装 gws-classroom：
npx skills add googleworkspace/cli --skill gws-classroom

请先确保 gws 本身可用，因为该技能元数据声明了一个必需的 gws 二进制文件。

先读对文件

先从 skills/gws-classroom/SKILL.md 看起，然后阅读 ../gws-shared/SKILL.md，了解认证、全局标志和安全规则。如果你的仓库检出里还有相关 helper，再查看 README.md、AGENTS.md 以及父技能提到的任何辅助参考资料。

把模糊目标改写成可用提示词

给技能提供准确的 Classroom 资源、方法，以及任何已知的 ID 或归属规则。比如，不要只说“建一个班级”，而是直接要求：

• 为指定拥有者创建一个课程
• 按 course ID 列出课程中的学生
• 接受或拒绝一条邀请
• 为某个 Classroom 资源注册变更通知

当提示词先把对象、动作和约束说明白时，gws-classroom 的效果最好。

按技能预期的命令形式来使用

核心调用方式是：

gws classroom <resource> <method> [flags]

这意味着你应该先按 API 思路来想，再补上用于身份、归属或筛选的最少必要参数。如果你不确定具体方法，先查看 SKILL.md 里的资源部分，不要靠猜。

gws-classroom 技能常见问题

gws-classroom 只适合教育管理员吗？

不完全是，但当你本来就有管理 Classroom 数据的权限时，gws-classroom 在 Education 场景里最强。非管理员用户也可以用它处理自己有权限执行的任务，但归属和访问规则非常关键。

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

普通提示词可以描述 Classroom 任务，但 gws-classroom 技能提供了基于 API 的资源图谱和 CLI 命令模式。这减少了对“能创建、读取还是删除什么”的歧义，也能避免忽略权限的提示词。

依赖它之前应该检查什么？

先确认目标课程、教师或学生的标识符已经明确，并且你的账号拥有正确的 scope 和角色。很多 Classroom 失败都不是语法问题，而是授权问题。

新手也能用吗？

可以，只要从一个范围明确的任务开始。只要你已经知道想要的 Classroom 结果，并且只需要把它映射到正确的 gws classroom 方法，这个技能就很容易上手。

如何改进 gws-classroom 技能

提供具体的 Classroom 上下文

最好的 gws-classroom guide 输入会包含 course ID、owner、teacher、student 或邀请对象，以及你想要的精确结果。“为 X 域中的 Jane Doe 创建一个课程”就比“建一个班级”好得多。

说明权限和归属约束

最常见的失败模式，是默认当前账号什么都能做。如果课程必须归属于其他用户，或者你是以管理员身份操作，请在 gws-classroom usage 请求里明确说明，这样回复才能选出有效的方法和参数组合。

一次只问一个资源家族

不要把课程创建、学生选课和 coursework 清理塞进一个含糊的问题里。把工作拆成课程、邀请、注册或 coursework 任务，这样技能才能返回更紧凑也更安全的命令序列。

从 API 对象出发迭代，不要沿用界面措辞

如果第一次结果太泛，就用 Classroom API 的名词和动作重写提示词：courses.create、courses.get，或者相关资源操作。通常这是提升输出质量、并让 gws-classroom 技能在重复运行时更可靠的最快方式。