Skills Hub
Mantra v0.9.0 引入了 Skills Hub，这是 Mantra「统一配置平面」的第二个支柱（与 MCP Hub 并列）。它将分散在各 AI 工具中的 Skills 集中到一处：一次导入，处处可用。
什么是 Skills Hub？
当你同时使用 Claude Code、Cursor、Codex、Gemini CLI 等多个 AI 工具时，每个工具都有各自的 Skills（技能文件）目录。相同的 Skill 需要手动复制到不同工具中，更新时也要逐个同步。
Skills Hub 解决了这个问题。它将所有 Skills 集中存储在 ~/.mantra/data/skills/ 目录中，通过 symlink（符号链接）自动分发到各个 AI 工具的 Skills 目录。你只需在一个地方管理，所有工具立刻生效。
核心能力
多工具 Skills 扫描
Skills Hub 可以自动发现四大 AI 工具中的 Skills，覆盖用户级和项目级目录：
| AI 工具 | 用户级路径 | 项目级路径 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Cursor | ~/.cursor/skills/ | .cursor/skills/ |
| Codex | ~/.codex/skills/ | .codex/skills/ |
| Gemini CLI | ~/.gemini/skills/ | .gemini/skills/ |
三档智能分类
导入前，Skills Hub 会将检测到的 Skills 分为三档：
| 分类 | 含义 | 操作 |
|---|---|---|
| 自动导入 | 全新 Skill，Hub 中不存在 | 直接导入，无需干预 |
| 自动跳过 | 与 Hub 中已有 Skill 完全相同 | 自动跳过，避免重复 |
| 需决策 | 内容有差异，可能存在冲突 | 提示你查看差异并决定 |
安全接管与自动备份
在导入前，Skills Hub 会自动备份原始 Skill 目录。如果导入过程中出现意外，会自动回滚到备份状态。你也可以随时手动从备份恢复。
备份策略：
- 每次接管操作前自动创建备份
- 保留最近 5 个版本
- 过期备份自动清理
- 恢复时校验备份完整性
跨工具 Symlink 分发
导入的 Skills 集中存储在 ~/.mantra/data/skills/，通过 symlink 分发到各 AI 工具的 Skills 目录：
~/.mantra/data/skills/
├── my-coding-standards.md # 源文件
└── project-rules.md # 源文件
~/.claude/skills/
├── my-coding-standards.md → symlink # 指向集中存储
└── project-rules.md → symlink
~/.cursor/skills/
├── my-coding-standards.md → symlink # 指向集中存储
└── project-rules.md → symlink所有工具读取到的是同一份文件，修改一处即全局生效。
跨平台支持
- Linux / macOS：使用标准 symlink
- Windows：自动降级为 junction（目录联接），无需管理员权限
项目级 Skill 关联
Skills Hub 支持灵活的项目关联机制：
- 用户级 Skills：自动关联所有项目
- 项目级 Skills：仅关联来源项目
- 可随时手动关联或取消关联任意 Skill 到任意项目
- 变更后，工具目录中的 symlink 自动同步更新
反向流入检测
当你打开一个项目时，Skills Hub 会自动检测是否有 AI 工具直接创建了新的 Skill 文件（绕过了 Mantra 的管理）。如果检测到，会提示你决定是否将其纳入统一管理。
使用流程
5 步导入向导
Skills Hub 提供引导式的导入流程：
- 扫描：选择要扫描的 AI 工具，自动发现 Skills
- 预览：查看检测到的 Skills 列表和三档分类结果
- 冲突决策：对「需决策」类别的 Skills 进行差异对比和选择
- 执行：确认后执行导入，建立 symlink 分发
- 关联：将导入的 Skills 关联到相关项目
扫描进度
导入向导会按工具显示扫描进度反馈，大量 Skills 时也能清楚了解当前状态。
Skills 管理页面
Skills Hub 提供专属的管理界面：
- 概览指标：总 Skills 数量、关联项目数、备份状态
- 筛选与搜索：按来源工具筛选、按名称搜索
- 视图切换：列表视图 / 网格视图
- 备份摘要：可折叠的备份状态面板
Skill 详情
点击任意 Skill 可查看：
- 完整的元数据（名称、来源、创建时间等）
- Skill 内容预览
- 关联的项目列表
- 删除影响范围预览
- 从备份恢复的选项
项目详情页集成
Skills 卡片嵌入到项目详情页中，展示：
- 已关联的 Skills 列表
- 未管理 Skill 提醒（反向流入检测结果）
- 快捷操作（关联、取消关联、查看详情）
这与 MCP Hub 的项目集成采用对称设计，保持一致的操作体验。
v0.9.1 增强：项目集成体验进一步优化：
- SkillContextCard：新的紧凑概览卡片，显示关联 Skill 数量、来源工具图标，以及可展开的 Skill 列表
- 未管理 Skill 提醒：当检测到未纳入管理的 Skill 时，在卡片内显示橙色横幅，提供一键导入按钮
- 双向跨页导航：Skill 卡片可跳转到关联项目，项目详情可跳回 Skills Hub
- 关联 Skill 搜索：当项目关联 5 个以上 Skill 时，出现搜索框，按名称或描述快速过滤
与 MCP Hub 的关系
Skills Hub 和 MCP Hub 共同构成 Mantra 的统一配置平面：
| 维度 | MCP Hub | Skills Hub |
|---|---|---|
| 管理对象 | MCP 服务（工具能力） | Skills（知识和规范） |
| 工作模式 | 接管 → 集中 → 分发 | 接管 → 集中 → 分发 |
| 存储位置 | SQLite 数据库 | ~/.mantra/data/skills/ |
| 分发方式 | 配置文件改写 | Symlink / Junction |
| 项目关联 | 支持 | 支持 |
| 备份恢复 | 支持 | 支持 |
两者采用相同的设计模式：接管 → 集中存储 → 分发，让你在一个地方管理所有 AI 工具的配置。