技能與聯結器

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（工作區）