前言¶
在 Microsoft Teams 上做一个 bot，通常要同时处理几件事：消息路由与卡片交互、AI 模型接入（Claude 或 OpenAI）、Microsoft Graph API 调用，以及把这些拼成一个可维护的工程。散落的示例代码和文档容易让人在框架选型和接口调用上反复踩坑。下面介绍的这个 Skill，就是把这些常见工作组织成一个可复用的工程入口。
这是什么¶
Microsoft Teams Apps Skill 是一个面向 Teams 应用开发的工程 Skill，版本 1.0.0，由企业来源（enterprise）发布，维护方为 RealQ，坐标 @org-eyw2ohcx/alinaqi-maggy-ms-teams-apps，归类在 dev-programming。
它解决的问题是：在 Teams 上开发 bot 和 AI agent 时，把模型接入、卡片渲染、Graph API 调用这些高频环节固化为可复用的工程约定，减少从零搭脚手架的重复劳动。
核心功能¶
根据 SkillHub 官方简介，这个 Skill 覆盖的能力包括：
- Microsoft Teams bots 与 AI agents 的工程化搭建；
- 接入 Claude 或 OpenAI 作为模型后端；
- 使用 Adaptive Cards 渲染交互界面；
- 调用 Microsoft Graph API 完成 Teams 侧数据与权限操作。
标签显示 requires_api_key=true，说明使用过程中需要配置对应的 API Key（模型服务或 Graph API 的密钥）。
安装与启用¶
已抓取的官方资料中没有列出具体的安装命令和配置字段。Skill 基于通用 SKILL.md 格式，通用启用方式如下：
- 将 Skill 放入本地 Skills 目录（如 Cursor 的
.cursor/skills、Claude Code 的.claude/skills，或 Codex CLI 对应的 skills 目录），目录名与 Skill 坐标一致； - 在会话中通过 Skill 名称触发，或按客户端规则自动加载；
- 按页面标注配置
requires_api_key所需的密钥。
具体的安装与配置项以官方页面为准：https://www.skillhub.cn/skills/org-eyw2ohcx/alinaqi-maggy-ms-teams-apps
典型用法¶
已抓取的资料中没有提供官方可复现的示例代码。可以确认的用法方向是：以这个 Skill 为工程起点，搭建一个 Teams bot，由它接收用户消息，调用 Claude 或 OpenAI 生成回复，用 Adaptive Cards 渲染交互卡片，并在需要读写 Teams 资源时通过 Microsoft Graph API 完成。
适用场景与注意¶
适合的场景：需要在 Teams 内交付 bot 或 AI agent、希望直接使用 Adaptive Cards 和 Graph API、不想从零搭建脚手架的开发者或团队。
需要注意的点：
- 该 Skill 要求 API Key，涉及模型调用和 Graph API 调用的费用与权限配额，需要提前规划；
- Graph API 的调用受 Microsoft Graph 权限模型约束，部分接口需要管理员同意或租户策略开放；
- SkillHub 页面显示安装数为 0、版本停留在 1.0.0，说明它在社区内的验证程度有限，建议在内部测试环境先跑通再用于生产；
- Claude 与 OpenAI 的接入方式、Adaptive Cards 的具体 schema 仍需按各自官方文档核对，Skill 本身不替代这些文档。
结尾¶
这个 Skill 的价值在于把 Teams bot + AI agent 开发中的几块拼图（模型接入、Adaptive Cards、Graph API）整理成一个明确的工程入口，省去重复搭架子的时间。如果你正在做 Teams 侧的 AI 应用，可以把它作为脚手架起点，再按实际需求补齐。官方地址：https://www.skillhub.cn/skills/org-eyw2ohcx/alinaqi-maggy-ms-teams-apps
