项目概览
skills-manage 是一款基于 Tauri v2 的跨平台桌面应用，用于在一个统一界面中管理 28+ 个 AI 编程代理（Coding Agent）平台的 Skills（技能/插件）。它由社区开发者志辉（@iamzhihuix）开发，于 2026 年 4 月 20 日发布首个公开版本 v0.8.0，采用 Apache 2.0 开源协议。该应用通过“中央技能库 + 符号链接分发”的机制，将 Skills 统一存放在 ~/.agents/skills/ 目录，并通过 symlink 链接到各平台目录，实现零副本、零同步延迟的管理。它内置 Skills 市场，支持从 GitHub 仓库一键导入，并提供 AI 自动解释功能以降低理解门槛。应用采用本地优先策略，所有数据存储在本地 SQLite 中，无需账号和云服务。当前预编译包仅支持 macOS，Windows/Linux 需从源码构建。
解决什么问题
随着 AI 编程工具的爆发式增长，Claude Code、Cursor、Gemini CLI、Codex、Hermes、OpenClaw 等 28+ 个平台各自拥有独立的 Skills 系统，且存储路径完全不同。传统管理方式存在五大痛点：一是重复安装，同一个 Skill 需要在多个平台各装一次，修改后无法自动同步；二是路径混乱，28+ 个平台的 Skills 目录散落在 ~/ 下 28 个不同子目录，没有统一入口；三是发现困难，好的 Skill 散落在 GitHub 仓库、社区论坛、X 帖子中，缺乏统一的“Skill 市场”；四是理解成本高，安装前需要阅读 SKILL.md、理解触发条件、检查依赖关系，对新用户门槛很高；五是项目级 Skills 难追踪，每个项目可能有专属 Skills，散落在各个代码仓库中，难以集中查看和复用。
工作方式
skills-manage 的核心思想是“一个中央仓库 + 符号链接分发 = 28+ 平台的 Skills 单一事实来源”。所有 Skills 统一存放在中央技能库 ~/.agents/skills/，安装到平台时通过创建 symlink 链接到各平台目录，而非复制文件，因此修改中央库的 Skill 文件后所有平台立即生效。应用遵循 Anthropic 的 Agent Skills 开放规范，每个 Skill 的标准结构包含 SKILL.md（必须）和 prompt.md（可选）。技术栈为 Tauri v2 + React 19 + Rust + SQLite，前端使用 Zustand 状态管理、react-i18next 国际化、Catppuccin 主题系统，后端使用 Rust 处理文件系统操作和网络请求。数据存储在本地 SQLite（WAL 模式），无需账号和云服务。
核心能力
- 中央技能库管理：读写
~/.agents/skills/目录，扫描/索引/搜索本地 Skills，提取 SKILL.md frontmatter 元数据 - 平台安装引擎：识别 28+ 个平台的 Skills 目录，创建/删除 symlink，检测 symlink 状态（有效/断链/非 symlink）
- 市场与导入系统：浏览官方推荐 + 社区 Skills，GitHub 仓库一键导入，支持 GitHub PAT 鉴权 + 镜像回退重试
- 发现与扫描引擎：递归扫描本地磁盘的项目级 Skills，缓存扫描结果，支持配置扫描根目录
- AI 解释生成器：调用 AI API 自动解释 Skill 功能，缓存解释结果，拒绝空白/损坏缓存
- 集合与批量管理：创建 Skill 集合（Collection），批量安装/卸载，组织和管理 Skill 分组
- 性能优化：延迟查询、懒加载索引、虚拟列表，确保大规模 Skills 库也能流畅操作
- 本地优先：所有数据存储在本地 SQLite，无需注册、无需云服务、无遥测，隐私友好
使用前需要了解
- AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
- 当前预编译包仅支持 macOS（Apple Silicon），Windows/Linux 需从源码构建。应用无版本管理功能，Skills 没有语义化版本控制，无法回滚到旧版本。无依赖解析，Skill 之间的依赖关系需要用户自行处理。无自动更新，已安装的 Skills 不会自动检测更新。仅桌面端，没有 CLI 工具或 Web 界面。macOS 构建未经过 Apple 公证，需要手动绕过 Gatekeeper。symlink 在 Windows 上需要管理员权限或开发者模式，且某些文件系统（FAT32）不支持 symlink。Marketplace 上的 Skills 没有经过安全审核，安装前应检查 SKILL.md 的内容。应用管理的是 Skills 文件（symlink），不是 Agent 本身，Agent 的安装和配置仍然各自独立。symlink 确保文件系统层面的即时生效，但已运行中的 AI Agent 进程可能缓存旧版 Skill，需要重启或刷新。
