1. 项目概述一个桌面端的AI技能管理器如果你和我一样同时在使用Claude Code、Cursor、Windsurf这些AI编程助手那你一定遇到过这个麻烦每个工具都有自己的一套“技能”Skills系统用来扩展AI的代码生成和问题解决能力。这些技能本质上就是一些脚本或配置文件但管理它们却成了噩梦。你可能会在~/.claude/skills/里放几个又在~/.cursor/skills/里放几个时间一长哪个技能更新了、哪个平台还没装根本记不清。skills-manage就是为了解决这个痛点而生的。它是一个用TauriRust Web前端构建的桌面应用核心目标就一个为所有主流的AI编程工具提供一个统一的技能管理中心。你可以把它想象成你电脑上所有AI助手的“应用商店”或“包管理器”但它管理的不是软件而是那些能让你写代码更高效的AI技能。这个项目遵循了Anthropic提出的 Agent Skills 开放模式将~/.agents/skills/目录作为唯一的“真相之源”。所有技能都集中存放在这里然后通过创建符号链接symlink的方式“安装”到各个AI工具如Claude Code、Cursor的专属技能目录中。这样一来你只需要在一个地方更新、管理你的技能库所有关联的工具都能自动同步受益。2. 核心功能与设计思路拆解2.1 为什么需要集中化管理在深入使用细节前我们先聊聊为什么这种“中心化”的设计是合理的。AI编程工具的技能虽然各家格式略有差异但核心都是包含skill.json定义技能名称、描述、触发命令等元数据和一些脚本文件的文件夹。手动复制粘贴到不同目录会带来几个问题版本混乱在A工具里改了一个技能的bug忘了同步到B工具导致行为不一致。空间浪费同样的文件在多个目录存储多份。管理困难想要查找、禁用或删除某个技能需要遍历多个隐藏目录。skills-manage的解决方案非常巧妙一次存储多处链接。所有技能物理上只存在于中心的~/.agents/skills/目录。当你为某个平台如Cursor“安装”一个技能时应用只是在Cursor的技能目录~/.cursor/skills/里创建了一个指向中心文件的符号链接。删除“安装”也只是移除这个链接不会影响中心文件。这保证了数据源的唯一性和一致性。2.2 核心功能模块解析基于上述设计skills-manage提供了以下几大核心功能模块构成了一个完整的管理工作流中央技能库这是应用的主界面展示所有存放在~/.agents/skills/目录下的技能。你可以在这里浏览、搜索、查看技能详情。多平台安装管理应用内置了超过20个AI编程工具和平台的配置。在技能详情页或列表页你可以一键将技能“安装”创建链接到指定的平台或从指定平台“卸载”移除链接。应用会清晰地用图标和状态标识出某个技能在哪些平台已安装。技能详情与预览点击任意技能进入详情页。这里不仅展示基本的skill.json信息还提供了Markdown预览如果技能包含README.md等文档会直接渲染方便理解用法。源代码查看可以直接浏览技能文件夹内的所有文件内容。AI解释生成可选调用配置的AI API如OpenAI、Anthropic让AI为你总结这个技能是做什么的、怎么用。这对于从市场下载的陌生技能特别有用。技能集合你可以创建自定义的“集合”比如“前端开发”、“Python工具”、“代码审查”将相关的技能分组。之后可以一键将整个集合安装到某个平台实现批量化管理。本地发现这个功能很实用。它可以扫描你整个硬盘或指定目录自动发现其他项目里可能存在的、符合规范的技能库即包含skill.json的目录并提示你是否要导入到中央库。这能帮你整合散落在各处的个人技能。市场浏览与GitHub导入应用连接了一个公共的技能市场可以浏览由社区发布的各种技能。更强大的是你可以直接输入任何GitHub仓库的URL应用会尝试解析其结构如果它包含有效的技能就可以一键导入到你的本地中央库。这极大地扩展了技能的来源。2.3 技术栈选型的考量项目选型非常现代且务实平衡了性能、开发体验和最终用户体验桌面框架Tauri 2这是项目的基石。相比ElectronTauri使用Rust编写核心并利用系统自带的Web视图生成的安装包体积极小通常只有几MB内存占用低启动速度快。Rust的后端也保证了本地文件操作、数据库访问的安全性和高性能。前端React 19 TypeScript Tailwind CSS成熟、高效的前端组合。TypeScript保证了大型应用的类型安全Tailwind CSS实现了快速、一致的UI开发。React 19的并发特性为未来大型技能库的流畅交互提供了可能。状态管理Zustand轻量级的状态管理库API简单直观完美契合这类桌面应用的状态管理需求避免了Redux的繁琐。UI组件shadcn/ui这是一套基于Radix UI构建的、可复制粘贴的组件代码。这意味着组件样式完全可控没有沉重的运行时依赖与应用“轻量本地”的哲学一致。后端数据库SQLite via sqlx本地应用的首选。SQLite无需单独服务单个文件~/.skillsmanage/db.sqlite就存储了所有元数据、集合、设置和缓存。使用sqlx这个Rust的异步SQL工具包能进行类型安全的查询并启用WAL模式提升并发读写性能。这个技术栈的选择清晰地指向了“构建一个高性能、轻量级、用户体验接近原生、且便于长期维护的桌面应用”的目标。3. 详细使用指南与实操要点3.1 安装与首次运行目前项目提供了预编译的macOSApple Silicon版本其他平台需要从源码运行。对于macOS用户由于应用尚未进行苹果公证可能会遇到“已损坏”的警告。注意遇到“skills-manage”已损坏的提示时并不意味着应用真的损坏而是macOS的Gatekeeper安全机制在阻止未签名的应用运行。解决方法如下将下载的skills-manage.app拖入“应用程序”文件夹。打开“终端”Terminal。输入以下命令并回车xattr -dr com.apple.quarantine /Applications/skills-manage.app这条命令移除了系统给应用附加的“隔离”属性。再次从“应用程序”文件夹或启动台打开应用即可。首次启动后应用会自动在~/.skillsmanage/目录下创建SQLite数据库文件并初始化必要的表结构。同时它会检查~/.agents/skills/目录是否存在如果不存在则会创建。主界面会引导你进行初始设置。3.2 核心工作流从导入到使用一个典型的使用流程如下步骤一添加技能到中央库方式A本地导入如果你本地已经有写好的技能文件夹直接将其复制或移动到~/.agents/skills/目录下。应用会自动扫描并显示。方式B发现功能点击侧边栏的“发现”扫描你的项目目录。找到的技能会列出来你可以选择“导入到库”应用会将其复制到中央目录。方式CGitHub导入点击侧边栏的“市场”或“导入”粘贴GitHub仓库URL例如https://github.com/某个用户/某个技能仓库。应用会解析仓库识别出技能确认后即可下载到本地中央库。方式D从市场添加在“市场”标签页浏览找到喜欢的技能点击“添加到库”。步骤二为技能安装到指定平台在“技能库”列表中找到目标技能点击进入详情页。在详情页的右侧或底部你会看到一个“平台”区域列出了所有支持的工具如Claude Code, Cursor等。在每个平台名称旁边会有一个开关或“安装”按钮。点击它应用会在后台执行以下操作检查该平台的技能目录如~/.cursor/skills/是否存在若不存在则创建。在该目录下创建指向~/.agents/skills/[技能名]/的符号链接。安装成功后该平台对应的状态会变为“已安装”。此时你打开对应的AI编程工具应该就能在它的技能列表里看到这个新技能了。步骤三使用集合进行批量管理当技能越来越多时逐个管理效率低下。点击侧边栏的“集合”然后“新建集合”。为集合命名如“我的日常工具”并添加描述。在技能库中通过多选或从技能详情页将技能添加到这个集合中。在集合详情页你可以看到一个“安装到平台”的批量操作按钮。选择目标平台如“Cursor”应用会为集合内的所有技能执行安装操作极大地提升了效率。3.3 隐私与安全设置skills-manage在设计上非常注重隐私但仍有几个关键点需要你知晓和配置数据存储所有数据技能元数据、集合、设置、缓存的AI解释都存储在本地~/.skillsmanage/db.sqlite文件中。技能文件本身在~/.agents/skills/。这意味着你的数据从未离开过你的电脑。网络访问应用默认不发送任何遥测数据。网络请求只发生在你主动使用以下功能时同步技能市场数据。从GitHub导入仓库。使用“AI解释”功能需配置API密钥。凭证配置GitHub个人访问令牌PAT如果你需要导入私有仓库或者避免GitHub API的速率限制需要在应用的“设置”中配置一个PAT。这个令牌只需要repo访问私有仓库和read:packages权限即可。令牌会以明文形式保存在本地数据库里请妥善保管你的电脑。AI API密钥如果你想使用“AI解释”功能需要在“设置”中填入OpenAI或Anthropic等支持的API密钥。同样密钥本地存储。建议使用环境变量或仅在使用时临时填入用后清除以遵循最佳安全实践。4. 开发环境搭建与项目贡献如果你想从源码运行或者希望为这个项目贡献代码以下是完整的开发环境搭建步骤。4.1 环境准备首先确保你的系统满足以下先决条件Node.js (LTS版本)推荐使用nvm或fnm进行安装和管理。pnpm这是一个比npm和yarn更快的包管理器。可以通过npm install -g pnpm安装。Rust工具链访问 rustup.rs 按照指引安装。安装后Rust的包管理器cargo会自动可用。Tauri系统依赖根据你的操作系统需要安装一些基础库。macOS: 通常Xcode Command Line Tools已足够。可通过xcode-select --install安装。Linux: 需要安装webkit2gtk、libssl等开发包。具体命令请参考 Tauri官方文档 。Windows: 需要安装Microsoft Visual Studio C构建工具和WebView2运行时。4.2 项目初始化与运行# 1. 克隆仓库 git clone https://github.com/iamzhihuix/skills-manage.git cd skills-manage # 2. 安装前端依赖 (使用pnpm确保依赖树一致) pnpm install # 3. 启动开发服务器 pnpm tauri dev执行pnpm tauri dev后会同时启动两个进程Vite开发服务器运行在http://localhost:24200负责热重载前端代码。Tauri的Rust后端进程负责构建并启动原生窗口。你会看到一个带有开发者工具窗口的桌面应用弹出。任何前端代码的修改都会实时热更新。4.3 项目结构深度解析理解项目结构有助于快速定位代码skills-manage/ ├── src/ # React前端源码 │ ├── components/ # 可复用的UI组件如SkillCard, PlatformBadge │ ├── i18n/ # 国际化文件支持中英文 │ ├── lib/ # 工具函数、API客户端封装 │ ├── pages/ # 对应路由的页面组件如Home, SkillDetail, Marketplace │ ├── stores/ # Zustand状态存储管理技能列表、集合、UI状态等 │ ├── test/ # 前端单元测试 (Vitest React Testing Library) │ └── types/ # 全局TypeScript类型定义 ├── src-tauri/ # Rust后端 │ ├── src/ │ │ ├── commands/ # Tauri命令处理函数是前后端通信的桥梁 │ │ │ ├── skills.rs # 技能扫描、安装、卸载等命令 │ │ │ ├── platform.rs # 平台目录管理命令 │ │ │ ├── github.rs # GitHub仓库导入命令 │ │ │ └── ... │ │ ├── db.rs # 数据库连接、迁移脚本、查询函数 │ │ ├── lib.rs # Tauri应用配置、命令注册 │ │ └── main.rs # 程序入口点 │ └── Cargo.toml # Rust依赖管理 ├── public/ # 静态资源图标等 └── ... (配置文件)前后端通信机制这是Tauri应用的核心。前端React通过tauri-apps/api调用特定的“命令”Command。例如前端调用invoke(scan_local_skills, { path: /some/path })这个请求会被Rust后端src-tauri/src/commands/skills.rs中定义的scan_local_skills函数处理。该函数执行文件系统扫描然后将结果序列化返回给前端。所有文件操作、数据库访问等敏感或高性能任务都在Rust端完成。4.4 代码质量保障与测试项目配备了完善的开发工作流脚本在提交代码前建议运行# 运行前端测试 pnpm test # 进行TypeScript类型检查 pnpm typecheck # 运行ESLint代码检查 pnpm lint # 进入后端目录运行Rust测试 cd src-tauri cargo test # 运行Clippy (Rust Linter) 检查代码质量 cd src-tauri cargo clippy -- -D warnings确保所有检查通过可以维持代码库的健壮性和一致性。5. 高级技巧与疑难问题排查5.1 添加自定义平台支持应用内置了众多平台但如果你使用的工具不在列表中可以手动添加。进入应用“设置”。找到“自定义平台”或类似区域。你需要提供平台名称显示在UI中的名字。技能目录路径该工具期望技能存放的绝对路径。例如如果你的工具叫“MyCoder”技能目录是~/.mycoder/skills/就填这个路径。分类可选如“Coding”、“Lobster”等用于分组。保存后新平台就会出现在技能安装的选择列表里。实操心得在确定路径时最好通过该工具的官方文档或配置文件来确认。有些工具可能允许通过环境变量配置路径这时你需要找到其默认值或实际使用的值。5.2 处理技能冲突与符号链接问题有时安装技能可能会失败或者AI工具读取不到。常见原因和解决方法如下问题现象可能原因排查与解决步骤安装成功但AI工具里看不到技能1. 符号链接创建失败或不被支持。2. AI工具未正确扫描技能目录。3. 技能格式不被该工具识别。1. 检查平台技能目录下是否有对应的符号链接文件ls -la ~/.cursor/skills/。2. 确认链接指向的路径有效。3. 重启AI工具有些工具需要重启才能加载新技能。4. 检查该技能的skill.json格式是否符合目标工具的要求。安装时提示“目录不存在”或“权限不足”目标平台目录无法创建或写入。1. 检查目标路径的父目录是否存在如~/.cursor/。2. 检查当前用户是否有在该路径写入的权限。3. 在“设置”中检查该平台的路径配置是否正确。从中央库删除技能后某些平台仍显示“已安装”应用状态缓存未及时更新或符号链接已被手动移除但数据库记录残留。1. 在应用内尝试刷新技能库或重启应用。2. 手动检查该平台目录下的链接是否真实存在。如果不存在在应用内对该技能执行一次“卸载”操作以同步数据库状态。AI解释功能无法使用API密钥未配置、配置错误或网络问题。1. 在“设置”中确认已正确填写可用的API密钥如OpenAI的sk-...。2. 检查网络连接特别是如果使用了代理。3. 查看开发者控制台F12的网络请求看API调用是否返回错误信息。重要提示在类Unix系统macOS, Linux上符号链接是核心机制。在Windows上Tauri会使用“目录连接点”来模拟类似行为。绝大多数情况下这都能正常工作但如果你在Windows上遇到问题可以尝试以管理员身份运行应用因为创建连接点可能需要更高权限。5.3 性能优化应对大型技能库如果你导入了非常多的技能例如数百个列表渲染和搜索可能会变慢。skills-manage已经采用了一些优化策略虚拟化列表在技能列表页面只渲染当前可视区域内的技能卡片而不是全部极大提升了滚动性能。延迟搜索索引搜索索引的构建是异步和延迟进行的避免在应用启动时造成卡顿。数据库查询优化使用索引和高效的SQL查询来快速过滤数据。如果你仍感觉卡顿可以使用“集合”功能对技能进行分类减少单页浏览的数量。在设置中考虑关闭技能图标的自动加载如果有此选项。确保你的~/.skillsmanage/db.sqlite数据库文件没有异常增大。可以尝试在应用内使用“清理缓存”功能如果有或手动备份后删除该文件应用重启后会重建但会丢失元数据和设置。5.4 技能开发与调试如果你想为自己或社区开发新的技能并与skills-manage良好配合需要遵循以下规范技能结构一个技能必须是一个文件夹包含一个skill.json文件。这是技能的“身份证”。其他文件如Python脚本、README.md等随意放置。skill.json 格式基本遵循 Agent Skills规范 。一个最小化的示例如下{ name: my-awesome-skill, description: 这是一个演示技能用于生成随机的代码注释。, authors: [你的名字], platforms: [cursor, claude-code], // 声明兼容的平台 commands: { generate-comment: { script: python3, args: [main.py], description: 为当前选中的代码生成一个幽默的注释 } } }本地测试将技能文件夹放入~/.agents/skills/然后在skills-manage中刷新即可看到。你可以先安装到某个已安装的AI工具如Cursor的测试模式进行功能调试。发布到GitHub将你的技能仓库设为公开并确保根目录或指定子目录下有有效的skill.json。这样其他人就可以通过skills-manage的GitHub导入功能直接输入你的仓库URL来安装你的技能了。这个工具真正将AI技能的开发、分享和管理流程打通了形成了一个从个人到社区的微循环。我自己在管理几十个常用技能时从之前的混乱不堪到现在的井然有序效率提升是实实在在的。尤其是“集合”和“批量安装”功能在切换不同项目上下文时一键切换技能组合体验非常流畅。如果你也深陷在多AI工具的技能管理泥潭中花点时间部署和使用skills-manage绝对是一项高回报的投资。