skills-manage：多平台 AI Coding Agent 的技能中央厨房

如果你同时使用 Claude Code、Cursor、Gemini CLI 等多个 AI 编程工具，肯定会遇到一个痛点：同一个编程能力（比如"熟练使用 React"或"掌握 Docker"），需要在每个工具里单独配置一遍。改一处要改 N 处，不同平台 skill 的格式还不统一，维护成本极高。

skills-manage 就是来解决这个问题的——它是一个基于 Tauri v2 构建的桌面应用，在你的本地创建一个中央技能库，再通过符号链接将 skill 分发到各个 AI coding 平台，实现"一处配置、多端生效"。

从一个开发者的困境说起

2024 年下半年，随着 Claude Code、Cursor、Cline 等 AI coding 工具的爆发式增长，开发者们开始意识到：这些工具的能力边界，很大程度上取决于你给它们配置的"技能"（skills）。一个好的 skill，可以让 AI 准确理解项目结构、掌握编码规范、调用正确的工具链。

但问题随之而来：

• 你在 Claude Code 里配置了一套 TypeScript + React 的 skill
• 切到 Cursor 工作时，这些 skill 完全不通用，需要重新配置
• 你发现某个 skill 有 bug，修了 Claude Code 的，Cursor 的还在用旧版
• 不同平台的 skill 格式、目录结构各不相同，无法直接迁移

skills-manage 的作者 iamzhihuix 正是遇到了这个困境，决定做一款统一管理工具。

核心技术架构

项目采用 Tauri v2 + React + TypeScript + Rust 的现代混合架构：

• 前端：React 18 + TypeScript + TailwindCSS + Zustand 状态管理 + i18next 多语言
• 后端：Rust（通过 Tauri IPC 与前端通信），核心逻辑包括 SQLite 数据库操作、文件系统操作（skill 目录读写、符号链接管理）
• 数据存储：SQLite（通过 sqlx 驱动），存储 skill 元数据、平台配置、用户偏好

前端目录结构（src/）：

• pages/ — 页面组件（Library、Marketplace、Discover、Settings 等）
• components/ — 可复用 UI 组件
• stores/ — Zustand 全局状态
• hooks/ — React 自定义 hooks
• lib/ — 工具函数库
• data/ — 静态数据（平台配置、marketplace 数据）

Rust 后端目录结构（src-tauri/src/）：

• lib.rs — 核心库入口
• main.rs — 应用入口
• db.rs — SQLite 数据库操作（skill 索引、平台关联）
• commands.rs — Tauri IPC 命令（前端调 Rust 的桥梁）
• path_utils.rs — 跨平台路径工具

关键依赖：

• @tauri-apps/plugin-fs — 文件系统访问（读写 skill 目录）
• @tauri-apps/plugin-dialog — 原生对话框
• @tauri-apps/plugin-shell — 终端 shell 调用
• @tauri-apps/plugin-sql — SQLite 数据库
• gray-matter — 解析 skill 目录中的 YAML frontmatter
• cmdk — 命令面板（⌘K 快速搜索）
• shadcn/ui — UI 组件库

图1：中央技能库视图，支持搜索、过滤和批量操作

核心功能体验

1. 中央技能库

应用将 ~/.agents/skills/ 作为 canonical 目录（与 Anthropic 的 Agent Skills 规范兼容），所有技能以 Markdown + YAML frontmatter 格式存储在本地。应用提供图形化界面管理这些 skill：

• 列表视图展示所有 skill，支持按平台、语言、标签过滤
• Markdown 预览模式直接渲染 skill 说明文档
• 源码模式查看原始 YAML + Markdown 内容
• AI 解释生成（亮点功能）：点击后调用 LLM 对 skill 内容生成通俗解释，帮助不熟悉该技术栈的开发者快速理解

2. 平台分发与符号链接

不同 AI coding 工具的 skill 目录不同：

• Claude Code：~/.claude/skills/
• Cursor：~/.cursor/skills/
• Cline：~/.cline/skills/

skills-manage 通过符号链接（symlink）将中央技能库的 skill"安装"到各平台目录，而非复制文件。这样既保证了多端共享同一份 skill，又避免了大量文件重复存储。

安装/卸载操作均有图形化确认界面，避免误操作。

图2：按平台查看已安装技能，状态一目了然

3. Marketplace 探索

应用内置 skill marketplace，浏览社区发布的 skill 集合，按发布者、语言、技术栈筛选。感兴趣的可一键导入到本地技能库。

4. 本地项目扫描（Discover）

在本地项目目录下扫描是否存在 .claude/skills/、.cursor/skills/ 等项目级 skill 配置，自动发现项目特有的 AI 助手指南。

图3：Discover 功能扫描本地项目，识别各平台的 skill 配置

5. 技能集合（Collections）

将多个相关 skill 打包成"集合"，实现批量安装/卸载。比如"前端开发套件"集合可以包含 TypeScript、React、TailwindCSS、Vitest 四个 skill，一键安装后所有工具立即获得前端开发能力。

图4：技能集合管理，支持打包批量安装

6. GitHub 仓库导入

输入 GitHub 仓库 URL，自动解析仓库结构和 skill 配置，支持带认证 token 的私有仓库导入，带重试机制。

上手门槛

维度	说明
安装难度	需本地安装 Rust + Node.js + pnpm，编译 Tauri 应用（非 MVP 用户需自行 build）
使用门槛	低，图形界面友好，支持中文
目标用户	同时使用 2 个以上 AI coding 工具的开发者
依赖要求	无 GPU、无服务器，纯本地桌面应用

局限与挑战

1. 构建门槛较高：没有提供预编译二进制包，普通用户需要自行 clone + build（Tauri 应用特性，跨平台分发困难）
2. 平台兼容性问题：各 AI coding 工具的 skill 格式规范并不统一，Claude Code、Cursor 等工具的 skill 结构存在差异，symlink 分发方案可能需要针对不同平台做适配
3. skill 格式标准化：依赖 Anthropic Agent Skills 的目录规范，其他平台若不遵循该规范则无法直接使用
4. Windows 支持存疑：符号链接在 Windows 上需要管理员权限或开发者模式，可能影响 Windows 用户体验

行业意义

skills-manage 反映了 2024-2025 年 AI coding 工具生态的一个重要趋势：从单一工具使用到工具链协同。随着 Claude Code、Cursor、Copilot Workspace、Gemini CLI 等工具的涌现，开发者开始需要在多个工具间切换，但每个工具的 skill 系统各自为政。

这个项目本质上是在做"skill 格式标准化 + 分发自动化"的工作，类似的探索还包括：

• Anthropic Agent Skills 规范本身
• Continue 的跨 IDE skill 共享方案
• 各平台的 skill marketplace 尝试

如果 Agent Skills 规范能够获得更多平台采纳，skills-manage 这类工具的价值会进一步放大。

---

技术标签：Tauri v2 · React 18 · TypeScript · Rust · SQLite · Zustand · TailwindCSS

项目亮点：多平台 skill 统一管理、符号链接分发、AI 解释生成、命令面板快速搜索