Switch Skill 技能

技能简介

Switch 是由 Flint AI 打造的开源协作工作区，专门解决 AI Agent 在团队协作场景下的「上下文碎片化」问题。传统的 AI 编程工具在工作时会生成独立的会话上下文，一旦任务交接或团队成员变化，后续参与者只能从零开始向 Agent 重新解释项目背景，效率极低。Switch 的做法是将 AI Agent 直接引入团队已有的协作工具（Slack、Microsoft Teams、Discord、Telegram）中，让 Agent 以命名参与者的身份加入频道，与团队成员共享相同的对话历史和项目上下文，实现无缝的任务交接与协作。

Switch 的核心价值在于「不改变团队工作习惯」——团队成员不需要学习新工具、不需要切换到独立的 AI 界面，AI Agent 就在你们平时沟通的 Slack 频道或 Discord 服务器里，像一个真实的团队成员一样参与讨论、接收任务、更新进度。

核心能力

将 AI Agent 接入团队协作工具：Agent 以命名参与者身份加入 Slack、Teams、Discord 或 Telegram 频道，所有对话内容、历史上下文和项目文件对 Agent 完全可见，Agent 的回复也直接出现在频道中，团队无需在多个工具之间跳转。

房间级上下文隔离：每个频道对应一个独立的上下文空间，Agent 仅能访问当前房间的相关信息，不会混淆不同项目的背景，适合同时推进多个产品或功能的团队。

多框架 Agent 兼容：支持接入 Claude Code、OpenAI、Google ADK、LangChain、Amazon Bedrock 以及自定义开发的 Agent，团队可以继续使用已有的 AI 编程工具，无需替换。

一次性接入、多项目复用：同一个 Agent 只需连接一次，即可在多个频道（项目）中复用，每个频道拥有独立的参与者列表、上下文内容和协作规则。

开源可自托管：代码完全开源（GitHub 仓库），支持完全自托管部署，数据保存在自有基础设施中，满足数据主权和隐私合规要求，部署时间在几分钟内。

共享决策与工作记录：所有团队与 Agent 之间的讨论、决策和任务更新集中保存在频道历史中，新成员加入时可以直接查阅完整上下文，无需从零了解项目背景。

安装配置

前置准备：需要有一台可以运行 Node.js 的服务器（或本地开发机），并准备好要接入的 Agent 的访问凭证（API Key 或认证信息）。

方式一：通过 CLI 快速部署。在终端运行 npm install -g @flintai/switch 安装 Switch CLI，运行 switch init 初始化项目配置，按提示填写团队协作工具的 Webhook 地址和 Agent 凭证。CLI 会输出需要在 Slack/Discord 中配置的 App Webhook URL。

方式二：Docker 部署（推荐生产环境）。从 GitHub Releases 下载最新的 Docker 镜像，运行 docker run -p 3000:3000 flintai/switch，配置环境变量 SLACK_BOT_TOKEN、DISCORD_BOT_TOKEN、AGENT_CONFIG_PATH 等完成部署。

接入 Slack：在 Slack API 网站创建 App，启用 Bot 功能，将 Bot Token 填入 Switch 配置。在 Slack 工作区中添加 Bot 到目标频道，Bot 即以参与者身份出现。

接入 Discord：在 Discord Developer Portal 创建 Application，配置 Bot Token 和 Intent 权限，将 Bot 添加到目标服务器和频道。

使用步骤

第一步：部署 Switch 服务。完成 CLI 安装或 Docker 部署，确保 Switch 服务运行在可访问的地址（本地或云端）。

第二步：配置并接入 Agent。在 Switch 配置文件中声明要接入的 Agent 类型和凭证。例如接入 Claude Code：在 config.yaml 中添加 provider: claude-code, api_key: xxx。保存后 Agent 激活并加入默认频道。

第三步：创建项目频道并邀请 Agent。在 Slack 或 Discord 中为目标项目创建一个新频道，将 Switch Bot 添加为成员。在频道中 @Agent 名称 即可与 Agent 对话。

第四步：跨 Agent 生态协作。如果团队同时使用多个 AI 框架（Claude Code 写代码、LangChain 做检索、Google ADK 做分析），可以将这些 Agent 都接入同一个 Switch 实例，在对应频道中协同工作。

第五步：利用上下文进行任务交接。当某个成员需要将任务交接给同事时，只需在频道中 @Agent 描述任务背景和当前状态，同事加入频道后可以直接从历史记录中了解完整上下文，继续推进。

适用场景

多成员产品团队希望共享 AI 编程工具的工作上下文、同时推进多个产品线需要 Agent 在隔离环境中处理不同任务、AI 工程师团队需要在交接时保留完整的项目背景、分布式远程团队希望在异步沟通工具中引入 AI 协作能力、对数据隐私有要求的企业希望 AI Agent 在自有基础设施上运行而非第三方平台。

适用人群

AI 工程师与软件开发者、使用 Slack/Discord 进行团队协作的技术创业公司和中大型企业产品/工程团队、分布式远程团队、希望在同一协作界面中集成多个 AI 框架的 AI 平台工程师。

工作原理

Switch 服务作为协作工具（Slack/Discord/Teams）和 AI Agent 之间的中间层运行。协作工具的 Webhook 将频道消息实时推送到 Switch，Switch 根据房间（Channel）标识加载对应的上下文历史，将消息组装为 Agent 可理解的输入格式，调用 Agent 的 API 接口获取回复，再将回复以协作工具原生消息的形式发布到频道中。

上下文管理通过房间维度的向量数据库实现：每条消息经过 Embedding 后存储，支持跨会话的语义检索。Agent 可以在当前房间中引用历史讨论、代码片段或决策记录，实现真正的「记忆」而非每次对话从零开始。

官方链接

官网：https://switch.ai（或 https://flintai.com/switch） GitHub：https://github.com/flintai/switch 文档：https://docs.switch.ai