用途
add-integration 是 Nexus 系统中的一个技能，用于将 API 文档转化为完整、可投入生产的集成。它通过网页搜索发现可用的 API 端点，提供给用户选择，规划集成架构，并通过 create-project 技能创建实现项目。
主要能力
- 通过 WebSearch 发现目标服务的官方 API 文档、认证方式、分类端点以及速率限制与要求。
- 解析并分类呈现发现的 API 端点，支持用户按编号、按类别或核心 CRUD 方式选择。
- 收集认证细节（Base URL、认证类型、环境变量名）并确认。
- 创建集成项目并生成配置文件 integration-config.json、overview.md、steps.md 等。
- 遵循 master/connect/specialized 架构模式，规划出 master 技能、connect 元技能以及每个端点对应的操作技能。
使用方式
工作流分为八个步骤：
- 初始化 TodoList；
- 交互式询问要集成的服务；
- 网页搜索该服务的 API 文档；
- 加载 create-project 技能创建集成项目：
python 00-system/core/nexus-loader.py --skill create-project； - 解析并呈现可用端点；
- 用户选择要实现的端点；
- 收集认证细节并最终确定项目；
- 提示用户关闭会话并开始实现。
在开始前，AI 需检查 stats.pending_onboarding 中是否包含 learn_integrations，若包含则建议用户先学习集成教程（10 分钟），覆盖 MCP（Model Context Protocol）概念、可用集成模式以及何时使用集成。
用户完成规划后说“done”关闭会话，之后开启新会话并说“work on {service} integration”来执行实现项目。执行时 execute-project 技能会加载 integration-config.json 并运行：
python 00-system/skills/system/add-integration/scripts/scaffold_integration.py \
--config 02-projects/{id}-{service_slug}-integration/02-resources/integration-config.json
适用场景
适用于需要为 Nexus 接入带 REST API 的第三方服务时，例如 HubSpot、Stripe、Twilio、Airtable、Slack、GitHub、Linear、Notion 等。
模板与脚本
模板位于 templates/ 目录，包括 master-skill.md.template、connect-skill.md.template、operation-skill.md.template、api-client.py.template、config-check.py.template、setup-wizard.py.template、operation-script.py.template 以及 references/*.template。脚本位于 scripts/ 目录，主要为 scaffold_integration.py。
限制
若网页搜索失败，用户可提供 API 文档 URL、手动提供 Base URL 与认证类型，或更换服务名。若找到文档但无法解析具体端点，可尝试抓取其它文档页面或由用户手动提供端点列表。用户取消时进度不会保存。API 的具体收费、价格、平台支持等信息暂未提供。
版本：2.0，更新于 2025-12-11。主要变更为：现在创建项目用于实现，而非在单次会话中完成全部工作。