learn-integrations

用途

这是一个 Nexus 的入门引导技能（ONBOARDING SKILL），优先级较高，用于主动向用户介绍 Nexus 的集成能力。它教会用户集成在 Nexus 中如何工作——集成是什么、有哪些可用、何时以及如何添加。技能完成后，用户应理解 MCP 是什么及其重要性、有哪些可用集成、何时添加集成而非独立工作、以及如何设置第一个集成。预计耗时 10-12 分钟。

主动触发机制

该技能会在用户配置文件中检查 learning_tracker.completed.learn_integrations 是否为 false。若为 false，则在以下情况主动建议：用户提到任何外部工具（GitHub、Slack、Notion、Airtable、Google Drive、Linear 等）；用户说“I use...”或“I work with...”后跟工具名；用户询问连接、同步或自动化外部服务；用户抱怨在工具间复制数据；用户问“can you access...”或“can you connect to...”；用户在任何语境下提到 MCP、API 或集成；在完成另一个入门技能后作为下一步建议。

建议话术示例：💡 I notice you haven't learned about integrations yet. Understanding how Nexus connects to external tools (like [tool they mentioned]) takes about 10 minutes and will help you work more efficiently. Would you like to run 'learn integrations' now? (You can always do it later)

若 learning_tracker.completed.learn_integrations 为 true、用户明确拒绝学习技能、或用户正专注于其他任务时，则不建议。

工作流程

步骤 1：为什么需要集成？ 询问用户当前是否使用外部工具（如 GitHub、Notion、Slack、Airtable、Google Drive、Linear），倾听其使用的工具、方式和痛点，并据此回应。

步骤 2：什么是 MCP？ 展示说明：MCP（Model Context Protocol）像一个通用适配器，让 AI 能连接外部工具并直接操作。无 MCP 时用户需手动复制粘贴数据；有 MCP 时 AI 可直接查询。可将 MCP 理解为在 Nexus 与工具之间搭建桥梁。

步骤 3：可用集成。 展示核心集成列表：

内置（可直接配置）：

Notion → “connect notion” → 数据库、页面、搜索
Airtable → “connect airtable” → 基础表、记录、自动化
Slack → “connect slack” → 消息、频道、团队沟通
Google → “connect google” → Gmail、Docs、Sheets、Calendar、Drive、Tasks、Slides
HubSpot → “connect hubspot” → CRM、联系人、交易
Beam.ai → “beam” 命令 → AI 智能体工作流

MCP 服务器（通过 add-integration 技能）：

GitHub → 仓库、issue、PR、actions
Linear → issue、项目、路线图
PostgreSQL → 直接数据库查询
Filesystem → 本地文件操作
以及通过 MCP 目录提供的 50 多个其他服务器

步骤 4：何时集成。 决策框架：

✅ 应添加集成的情况：频繁从某工具复制粘贴数据；想要自动化工作流（如从任务创建 GitHub issue）；需要实时数据（如查看 Slack 消息）；该工具是日常工作核心。

❌ 应跳过集成的情况：很少使用该工具；手动复制粘贴已足够快；该工具不支持 MCP；偏好保持系统独立。

要点：Nexus 可完全独立运行，集成是增强项而非必需。

步骤 5：如何添加集成。

方法 1：内置主技能，直接说命令，如 “connect notion” 打开 Notion 设置向导，“connect airtable” 打开 Airtable 设置向导。

方法 2：MCP 服务器设置，说 “add integration”，引导完成：安装 MCP 服务器、获取 API 凭证、配置连接、测试、记录到 Memory。每个集成约 10-20 分钟。

步骤 6：快速示例。 以 Notion 集成为例：无集成时用户需手动复制格式化文本到 Notion；有集成时 AI 可直接在 Notion 中创建任务。其他用例包括查询 Notion 项目数据库、同步会话报告到 Notion、搜索笔记等。

步骤 7：下一步。 询问用户是否现在设置集成。若是，根据选择加载对应技能：Notion → notion-connect；Airtable → airtable-connect；Slack → slack 技能（来自 google 文件夹）；Google 系列 → google 技能；其他 → add-integration 技能。若否，告知用户日后可通过 “connect notion”、“connect airtable”、“connect slack”、“connect google”、“add integration” 等命令设置。

步骤 8：完成。 在 user-config.yaml 中标记技能完成：

learning_tracker: completed: learn_integrations: true # ADD THIS LINE

展示完成信息，列出已理解内容与下一步命令，并提示用户说 “done” 保存进度。

成功标准

用户理解 MCP 是什么；知道有哪些可用集成；理解何时集成与独立工作；知道添加集成的命令；user-config.yaml 中 learning_tracker.completed.learn_integrations 为 true。

资源

MCP 文档：https://modelcontextprotocol.io/ MCP 服务器目录：https://github.com/modelcontextprotocol/servers

限制

资料未提供该技能的具体收费、价格、平台支持范围或实际效果数据。

技能介绍

用途

主动触发机制

工作流程

成功标准

相关技能

资源

限制