ms-teams-setup（Teams集成设置）Skill 是什么？如何下载安装？

Teams集成设置Skill：一条命令把 Microsoft Teams 接进 AI 工作流，让每日计划与会议准备自动带上聊天上下文

一条命令完成连接：输入 /ms-teams-setup，技能会自动检查连接状态、添加 teams-mcp 桥接器、引导完成 OAuth 2.0 授权、配置优先频道并做连通性测试。
两个已有技能被增强：/daily-plan 增加 Teams 未读聊天与提及摘要，/meeting-prep 增加与参会者的最近对话上下文。
两个新能力自动生效：Teams 摘要自动出现在日常计划中，人员页面自动富集最新 Teams 对话。
隐私按需读取：消息按需获取、总结后即丢弃，不永久存储；OAuth 令牌保存在本机并被 gitignore 忽略，仅能访问本租户内自己账户可见的内容。
可与 Slack 并存：同时连接时两个来源的摘要并排展示、明确标注来源并自动去重，互不影响。

1. 该技能叫什么？如何下载安装 AI 技能提升开发效率？

技能基本信息

中文名：Teams集成设置Skill
英文名：ms-teams-setup
技能ID：11902

它解决什么问题

Microsoft Teams 里的关键信息高度碎片化：未读聊天、@提及、某个项目频道的结论、上次和某位同事或客户的对话，都沉在会话列表深处。做每日计划时要手动翻一遍，开会前又要再翻一遍，耗时且容易漏。Teams集成设置Skill 的作用，就是把 Microsoft Teams 连接到 Dex，通过名为 teams-mcp 的 MCP 服务器、以 OAuth 2.0 方式经 Microsoft Graph API 只读访问聊天、频道与在线状态（presence），让日常计划、会议准备和人员页面都具备跨渠道的上下文感知能力。

换句话说，它不是又一个“聊天客户端”，而是给你的 AI 工作流补上一路数据源——而且是带隐私边界的数据源。

“一键安装”的思路与步骤

该技能的安装入口就是技能本身：在 Dex 中运行 /ms-teams-setup，它会带你走完整条链路。前提与步骤如下：

准备前提：一个 Microsoft 365 / Teams 账户凭据；约 5 分钟时间；视组织策略，可能需要 IT 管理员同意。由于 teams-mcp 以 npx 方式启动，本机需具备可用的 Node.js 环境（具体版本要求以官方说明为准）。
入口命令：输入 /ms-teams-setup。技能会先调用 teams_health_check() 探测是否已连接——已连接则直接跳到频道配置，未连接则进入下一步。
添加 MCP 服务器：若配置中缺少 teams-mcp，技能会提示你把它写入 .mcp.json。可以用 /dex-add-mcp 技能完成，也可以手动编辑，典型配置形如：

{
  "teams-mcp": {
    "command": "npx",
    "args": ["-y", "teams-mcp"],
    "env": {
      "TEAMS_TENANT_ID": "<tenant-id>",
      "TEAMS_CLIENT_ID": "<client-id>"
    }
  }
}

写入后需重启 MCP 服务器使配置生效。

完成 OAuth 2.0 授权：技能会启动认证流程并打开浏览器，你用 Microsoft 365 账户登录，授予读取消息、频道、在线状态的权限（对应 Chat.Read、ChannelMessage.Read、User.Read、Presence.Read 等），令牌随即保存在本机。
配置优先频道并测试：选择对你的工作最重要的 1:1 聊天、部门频道或项目/客户频道；随后技能会跑一次连通性测试。

如何验证是否生效

teams_health_check() 返回健康状态，说明令牌与租户连接正常；
teams_list_chats(limit=3) 能列出最近对话；
teams_search_messages(query="test", count=1) 能返回搜索结果；
运行 /daily-plan，应看到带 “Teams：” 标记的摘要段落。

以上命令与配置项均来自技能说明；若你的环境存在差异（例如企业分发的客户端 ID、代理设置等），以官方说明为准。

2. 该技能的主要功能和特点

能做什么

日常计划增强：Teams 摘要与 Slack 摘要并列，展示未读聊天、@提及和优先频道活动。
会议准备增强：在会议前检索与参会者的最近 Teams 对话、最近线程与频道内的决策内容。
人员上下文富集：人员页面补充“最近在 Teams 中和这个人聊了什么”。
优先频道配置：把有限的注意力聚焦在你指定的频道上，1:1 聊天默认自动包含。
引导式排障：遇到管理员同意、账户不匹配、令牌过期、请求限流（429）等情况时，给出明确的分支提示与重试建议（最多重试 2 次后提供“稍后再来”的选项）。
随时重配置：再次运行 /ms-teams-setup 即可更新优先频道、切换功能开关、重新认证，或一键断开连接。

和普通工具比强在哪

只读、按需、不落库：消息被获取、总结，会话结束后丢弃；不永久存储任何内容，仅可访问本租户内属于你账户的消息。
凭证本地化：OAuth 令牌保存在你的机器上并被 gitignore 忽略，不进入代码仓库。
能力级联而非孤立功能：连接完成后，增强项会“自动长”在已有的每日计划、会议准备、人员页面上，不需要你改变工作习惯去适应一个新工具。
多源共存与去重：Slack 与 Teams 同时启用时，摘要并排显示、按来源标注，同一个人在两处出现时上下文合并并标明来源，避免重复噪音。
声明式的配置落盘：最终写入 System/integrations/config.yaml 的 teams: 段落，只更新该段、保留其他集成配置，便于版本化管理。

3. 如何使用该技能？

首次连接（完整 8 步流程）

触发：在 Dex 中输入 /ms-teams-setup。也可以在你提出“帮我连接 Teams”“希望日常计划里包含 Teams 上下文”时被识别，或在 /integrate-mcp 中提到 Teams 时进入。
查看说明并确认：技能会解释将通过 Microsoft Entra ID（Azure AD）使用 OAuth 2.0 安全访问 Teams，并告知大约 5 分钟、可能需要管理员同意，等待你确认。
添加桥接器：若 teams-mcp 未在配置中，技能会说明“添加一个通过 Microsoft Graph API 读取消息与频道的桥接器”，并给出上述 JSON 片段；写入后重启 MCP 服务器。
授权：按提示在浏览器中登录 Microsoft 365 账户并授予权限，随后技能调用认证命令（如 teams_authenticate()）并用 teams_health_check() 复核。
选择优先频道：例如回答“General、产品研发、ACME 客户群”，或说“显示可用的内容”，技能会调用 teams_list_channels() 列出频道供你挑选。
连通性测试：技能执行 teams_list_chats(limit=3) 与 teams_search_messages(query="test", count=1)，并输出“聊天：找到 N 个最近对话 / 搜索：工作正常”之类的简要结果。任一项失败会先排障再继续。
保存配置：写入 System/integrations/config.yaml，形如：

teams:
  enabled: true
  configured_at: YYYY-MM-DD
  priority_channels:
    - channel-name-1
    - channel-name-2
  features:
    teams_digest: true
    meeting_prep: true
    person_enrichment: true

确认能力变化：技能会回执“Teams 已连接”，并列出刚被增强的 /daily-plan、/meeting-prep，以及新增的 Teams 摘要与人员上下文两项能力。

日常调用示例

输入 /daily-plan → 输出中包含 “Slack：” 与 “Teams：” 两段摘要，Teams 段列出未读聊天、提及你的消息与优先频道动态。
输入 /meeting-prep 并给出会议主题或参会人 → 输出会附上与这些参会者的最近 Teams 对话要点与频道内的相关决策。
打开某位同事的人员页面 → 页面中出现最近 Teams 对话的上下文摘要。

重新配置与断开

再次运行 /ms-teams-setup，技能会先用 teams_health_check() 检查状态、从 config.yaml 读出当前配置，然后给出选项：更新优先频道、切换功能开关、重新认证（令牌过期时）、断开连接。选择断开时，会将 teams.enabled 置为 false，并提示“日常计划与会议准备将不再包含 Teams 上下文，随时可重新运行命令恢复”。

常见故障自查

令牌过期：Microsoft OAuth 令牌通常在 60–90 分钟级别过期（刷新令牌更久），重新运行 /ms-teams-setup 会自动刷新；刷新失败则需重新登录。
需要管理员同意：请 IT 在 Entra ID 的企业应用程序中批准应用及相应权限。
提示 MCP 未找到：重跑 /ms-teams-setup，它会检测并修复。
429 限流：等待几分钟后重试，正常使用中很少发生。
搜索不到消息：确认租户未限制 API 访问、账户具备 Teams 许可证（仅 Outlook 不算），可用 teams_search_messages(query="hello", count=1) 做基础验证。

4. 同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
ms-teams-setup（Teams集成设置Skill）	把 Teams 作为上下文数据源接入 AI 工作流	OAuth 2.0 只读接入；日常计划摘要、会议准备、人员上下文；与 Slack 共存去重	低：一条 `/ms-teams-setup` 引导完成，约 5 分钟，可能需要管理员同意	已在用 Dex 做每日计划与会议准备、希望打通 Teams 的个人与小团队	优势：能力自动级联、按需读取不落库、令牌本地保存；不足：仅只读同步，依赖组织授权策略
Microsoft Teams 原生通知与活动源	Teams 客户端内置的消息提醒	未读标记、@提及提醒、频道关注、活动流	极低：随客户端提供	只想不漏消息的日常使用者	优势：零配置、实时；不足：不跨渠道聚合，不与会议准备和人员信息联动，难以生成摘要
Microsoft 365 Copilot（Teams 内）	微软原生 AI 助手	会话摘要、会议纪要、内容生成	中高：需相应订阅与组织级部署，商务条款以官方说明为准	深度使用微软生态、需要会议纪要与文档生成的团队	优势：原生集成、覆盖广；不足：绑定单一生态，不覆盖 Slack 等外部渠道，无法融入自定义工作流
自动化平台（如 Zapier / Power Automate）	低代码跨应用自动化	触发器+动作，把 Teams 消息转发到其他系统	中：需自行设计流程、维护字段映射与配额	需要把消息推送到工单、表格等目标系统的场景	优势：连接器丰富、可写入；不足：以规则搬运为主，缺少语义摘要，配置与维护成本高
基于 Microsoft Graph API 的自建脚本	完全自定义的集成	按需调用 Graph 接口读取聊天、频道、在线状态	高：需注册应用、处理 OAuth 刷新、节流与权限申请	有工程团队、需求高度定制的组织	优势：最灵活；不足：开发与运维成本高，无现成摘要与工作流整合

选择建议：如果你要的是“让 AI 帮我做计划和会议准备时看到 Teams 上下文”，且不想写代码、不想被单一生态锁死，ms-teams-setup 这类“连接器+能力级联”的方案性价比最高；如果目标是合规归档或把消息写回业务系统，则应考虑自建 Graph 集成或自动化平台。具体价格与授权条件以各官方说明为准。

5. 该技能的典型应用场景与实际体验情况

场景一：研发负责人的晨间计划

角色与痛点：同时盯 3 个项目频道和十几个 1:1 聊天，早上第一件事就是“扫未读”，容易漏掉跨时区同事的提问。

使用方式：把部门频道和项目频道加入 priority_channels，每天输入 /daily-plan。输出中 Teams 段会列出未读聊天、提及你的消息与优先频道活动。

实际体验：一次配置长期受益，摘要替代了手动翻列表；由于只读、按需读取，不用担心聊天被长期留存。注意点：优先频道不要贪多，选 3–6 个最能代表当日重点的即可，否则摘要会变长。

场景二：客户成功经理的会议准备

角色与痛点：会前需要回忆“上次和这位客户在 Teams 里说定了什么”，常常在两个窗口间反复切换。

使用方式：会议前运行 /meeting-prep，技能会检索与参会者的最近 Teams 对话、最近线程和频道内决策。

实际体验：把“翻聊天记录”的 5–10 分钟压缩到几秒，且上下文可直接用于会议开场回顾。注意点：若组织限制了频道消息读取权限，部分频道内容可能无法纳入，需要 IT 侧确认权限（ChannelMessage.Read 等）。

场景三：管理者的团队人员页

角色与痛点：同时管理多人时，很难记住“和小王最近聊到哪一步”。

使用方式：打开人员页面，技能会自动富集该人员最近的 Teams 对话上下文。

实际体验：人员页从“通讯录”变成“关系记忆”，交接和绩效沟通更有据可依。注意点：这是辅助记忆工具，涉及敏感人事话题时应遵循公司内部规范。

场景四：Slack 与 Teams 双渠道并存的团队

角色与痛点：一部分合作方在 Slack、一部分客户在 Teams，信息分裂在两个世界。

使用方式：两个集成都开启后，/daily-plan 并排显示两个摘要并明确标注来源，/meeting-prep 同时检索两处，同一人两处出现时上下文合并标记来源并去重。

实际体验：这是该技能最被低估的能力——它解决的不是“接入 Teams”，而是“跨渠道统一上下文”。注意点：两个来源都要保证授权有效，令牌过期时会同时影响两段摘要。

整体体验小结：上手难度低（跟着引导走即可，主要不确定性来自组织管理员是否放行），效果集中体现在“省掉手动翻聊天”和“会议前不冷场”两件事上。需要提前预期的是：只读、按需、不落库的设计意味着它不会成为聊天归档工具；令牌寿命较短，遇到认证错误重跑一次命令即可。

6. 该技能能为用户带来的价值

时间收益：把每天“扫未读 + 翻历史对话”的重复动作收敛成两个命令（/daily-plan、/meeting-prep）。按每天两次、每次 5–10 分钟估算，一周可回收约 1 小时量级的低价值操作时间。
信息完整性收益：优先频道 + 1:1 自动包含，让“该看到的”不再靠运气；会议准备直接带出参会者相关线程与频道决策，减少会中“我确认一下”的空转。
跨渠道统一：Slack 与 Teams 双源并存、标注来源并去重，避免为了统一上下文而在两个工具间做取舍。
门槛降低：不需要懂 Graph API、不需要写 OAuth 刷新逻辑，一条引导式命令走完连接、授权、频道配置、测试与落盘配置；出问题时技能自带分支排障话术。
风险可控：只读同步、按需获取、总结后丢弃、不永久存储；令牌本地保存并被 gitignore 忽略；可随时一键断开，断开即刻停止纳入上下文。
长期可演进：配置以 YAML 段落形式沉淀，可随团队变化调整频道与功能开关；新能力以“级联增强”的方式挂到已有技能上，升级不会打乱既有习惯。

7. 常见问题 FAQ

Q1：怎么安装 Teams集成设置Skill？需要准备什么？

在 Dex 中运行 /ms-teams-setup 即可启动引导式安装。需要准备：Microsoft 365 / Teams 账户凭据、约 5 分钟时间，以及（视组织策略）IT 管理员的应用批准。若配置中缺少桥接器，技能会提示把 teams-mcp 写入 .mcp.json（或用 /dex-add-mcp 完成），写入后需重启 MCP 服务器。具体客户端 ID、租户 ID 的获取方式以官方说明为准。

Q2：这个技能收费吗？

技能说明中未涉及定价信息。它本身是一个连接器配置流程，费用取决于你所使用的 Dex 版本/订阅方案，以及组织侧 Microsoft 365 与 Teams 许可证的授权情况。请以官方说明与你的组织采购条款为准。

Q3：它会不会把我的聊天记录存下来？隐私怎么保障？

按技能说明，Dex 按需读取 Teams 消息，获取、总结后即在会话结束时丢弃，不永久存储任何内容；仅能访问你所在租户、你账户范围内的消息；OAuth 令牌保存在你本机并被 gitignore 忽略。同步方向为只读（messages、channels、presence），不会修改或发送任何 Teams 内容。

Q4：提示“需要管理员同意”或者连不上，怎么处理？

先确认三点：是否登录了正确的 Microsoft 账户、组织是否使用 Microsoft 365（Teams 需要 M365 许可证）、是否可在浏览器中退出其他 Microsoft 账户后重试。若确属管理员同意问题，可请 IT 在 Entra ID（Azure AD）的企业应用程序中批准应用及 Chat.Read、ChannelMessage.Read、User.Read、Presence.Read 等权限；也可改用个人账户（若是个人版 Teams），或暂时跳过、待批准后再回来。若出现 429 限流，等待几分钟重试即可。

Q5：它和 Teams 原生 Copilot、Zapier 之类怎么选？适合谁用？

如果你要的是“把 Teams 上下文喂给已有的 AI 工作流（每日计划、会议准备、人员页），并支持与 Slack 共存去重”，选 ms-teams-setup 更直接；如果你需要会议纪要与文档生成且全程停留在微软生态，Teams 原生 Copilot 更合适；如果你要把消息写入工单、表格等业务系统，自动化平台或基于 Graph API 的自建方案更匹配。特别注意：本技能为只读接入，不能用于发送消息或归档聊天记录。