前言¶
在 Microsoft 365 上做办公自动化，绕不开 Microsoft Graph API。问题是 Graph 的 endpoint 分散、鉴权流程固定且繁琐，读写邮件、日历、Teams 消息、用户、文件、站点、任务各有不同的调用方式。直接对接 Graph，每个项目都要重复处理 OAuth 授权、token 获取、分页、错误处理这些基础设施。
Teams-Automation 这个 Skill 的价值在于把这些统一封装成一层能力：声明要做什么，Skill 负责调用 Graph。下面介绍它的定位、已核实的能力范围，以及适用场景。
这是什么¶
Teams-Automation 是一个基于通用 SKILL.md 格式的 Agent Skill，定位是 Microsoft Graph API 的统一调用封装，提供 Microsoft 365 办公自动化能力。
- 出品方：user_c334ae17
- 来源：community（社区）
- 分类：office-efficiency
- 版本：1.0.2
- 坐标：@user_c334ae17/teams-automation
- 官方地址：https://api.skillhub.cn/user_c334ae17/teams-automation
它解决的问题是：让 Agent 在需要查询/发送邮件、查看日历、读取/发送 Teams 消息、搜索用户、查看在线状态、访问 SharePoint/OneDrive 文件时，有一个现成技能直接触发，而不用每次从 Graph 的 endpoint 和鉴权细节做起。
核心功能¶
根据官方简介，该 Skill 支持读取及发送以下已授权操作：
- 邮件：查询和发送。
- 日历：查看日历。
- Teams 消息：读取聊天和频道消息，发送消息，包含私聊发送。
- 用户搜索：按条件查找组织内用户。
- 在线状态：查看用户在线状态。
- 文件：访问文件。
- SharePoint 站点：访问 SharePoint 站点。
- 任务：读写任务。
注意范围限定是「全部已授权操作」。也就是说，实际能调用到哪个租户、哪些数据，取决于 Agent 运行环境被授予的 Graph 权限。超出授权范围的调用不会由 Skill 本身绕过。
安装与启用¶
已抓取资料中没有提供具体的安装命令、目录路径或配置字段。可以确认的是：
- 该 Skill 带 requires_api_key=true 标签，启用前需要配置 API Key。
- 官方页面地址为 https://api.skillhub.cn/user_c334ae17/teams-automation，SkillHub 页面为 https://www.skillhub.cn/skills/user_c334ae17/teams-automation。
- 具体在 Cursor、Codex CLI 还是 Claude Code 中如何安装，以及 API Key 的配置项名称，资料中未给出，需以官方页面说明为准。
本次抓取时官方页面无法访问，因此无法核对安装细节。建议先打开官方地址确认，再执行安装。
典型用法¶
官方简介给出的触发方式是：当用户需要查询/发送邮件、查看日历、读取/发送 Teams 消息、搜索用户、查看在线状态、访问 SharePoint/OneDrive 文件时，此技能被触发。
据此，典型调用形态是让 Agent 用自然语言下达办公操作指令，例如：
- 「帮我查一下这周的日历安排」——触发日历读取。
- 「给张三发一条 Teams 私聊消息，内容是……」——触发 Teams 私聊发送。
- 「在 SharePoint 站点上找一下 XX 项目的文件」——触发 SharePoint 站点与文件访问。
- 「查一下李四现在是否在线」——触发在线状态查询。
具体的请求格式、参数字段和返回结构，资料中未提供示例代码。这些属于 Graph 层面的行为，建议在启用后用一个最小请求实测一次，确认授权范围和返回格式。
适用场景与注意¶
适合谁：
- 需要在 Microsoft 365 环境里做邮件、日历、Teams 消息、用户、文件、站点、任务自动化的 Agent 应用开发者。
- 希望跳过 Graph 直连成本，直接通过 Skill 声明式调用的团队。
限制和坑：
- 授权范围决定能力上限。能否读到邮件、能否发送 Teams 消息，取决于运行环境被授予的 Graph 权限，Skill 不会扩大授权。
- 需要 API Key。requires_api_key=true，启用前必须先准备好凭证。
- 安装细节资料缺失。本次抓取官方页面失败，安装命令、配置字段、各编辑器差异均未核实，不要照抄任何未经确认的命令。
- 评分与下载量是平台数据，不代表功能质量。已抓取资料显示评分 100000、下载 1250、安装 0。安装数为 0 意味着社区使用反馈样本很少，稳定性需自行验证。
- 这是社区来源（community）的 Skill，不是官方 Microsoft 出品。涉及企业数据时，先确认数据合规要求再启用。
结尾¶
Teams-Automation 的价值在于把 Microsoft Graph 的分散能力收敛成一个统一入口，让 Agent 用自然语言完成 Microsoft 365 里的常见办公操作，省去每个项目重复对接 Graph 的成本。它的能力边界由授权范围决定，安装细节需到官方页面确认。
官方地址：https://api.skillhub.cn/user_c334ae17/teams-automation
SkillHub 页面：https://www.skillhub.cn/skills/user_c334ae17/teams-automation
