技能与连接器

MindMux 把两类扩展能力拆成两个独立入口：技能（Skills） 和 连接器（Connectors）。它们都在 Settings 里管理，但职责完全不同。

Skills（技能）

Skill 是一份场景化的 AI 行为规则手册（Markdown rulebook），用来塑造 agent 在特定情境下如何工作。

主要特征

• Markdown 定义：每个 skill 都是一份带 frontmatter 的 Markdown 文件，包含名称、简介、适用场景和详细规则。
• 三层作用域：
  • Built-in（内建）：应用自带，所有 workspace 都可用，用户可单独启用或禁用。
  • Global（全局）：用户自定义，跨 workspace 共享。
  • Workspace（项目级）：放在 brain/skills/，只对当前项目生效。
• 按需加载：会话开始时只在 system prompt 里列出可用 skill 清单；agent 判断需要时，才通过 invoke_skill 加载完整规则。
• 可禁用内建 skill：用户可在 Settings > Skills 关闭不需要的内建 skill，避免无关规则污染 system prompt。

与 Pages 的边界

不要把项目设计说明写成 skill，也不要把 AI 执行规则写成 page。

Connectors（连接器）

Connectors 是 MCP 连接器层，负责把外部系统接到 MindMux。它们让 agent 在对话中调用外部服务提供的工具。

当前范围

• Official connectors：GitHub、Notion、Linear、GitLab。
  • GitHub / Linear：hosted HTTP + Bearer Token。
  • Notion / GitLab：OAuth-first connector。
• Custom MCP V1：支持 stdio、legacy SSE（通过本地 stdio bridge）、streamable HTTP；鉴权支持 none、bearer、api key header、custom headers。

管理入口

• Settings > Connectors：手动添加、启用、禁用、测试、授权连接器。
• 配置专家（configuration expert）：对话式配置入口，与 Connectors 页面共享同一套连接器状态机。

为什么两者要分开

• Skills 改变 MindMux 的行为方式（AI 怎么思考、怎么沉淀知识）。
• Connectors 改变 MindMux 能连接哪些外部系统。

把两者混在一起会让“插件”概念变得模糊。拆开后，产品架构和设置入口都更清晰。

设置入口

Settings 左侧栏为扁平 6 项：

1. General（通用）
2. Runtime（运行时 / Provider Profile）
3. Experts（专家角色）
4. Connectors（连接器）
5. Skills（技能）
6. Workspace（工作区）