Manage My skills

跨平台的 AI Agent Skills 统一管理与安全同步工作台

支持 Windows & macOS ｜ 适用于 Claude Code, Cursor, Windsurf, Zed, Trae, Codex 等 20+ 编码助理

Manage My skills 是一个极具设计感、跨平台的本地 Agent Skills 统一管理工具，帮助你在 Claude Code、Cursor、Windsurf、Zed、Codex、Trae 等多个 AI 编码工具之间，一键发现、比对、安全同步和健康诊断你的 Skills，避免优质技能散落各处。

所有文件与链接的变更都经过「预览 → 确认 → 异步执行」流程，由高性能的 Rust 后端负责底层的磁盘与进程操作，安全可控、极速响应。

🖼️ 界面预览 (Screenshots)

💡 点击展开查看全部 11 张功能截图

1. Skills 管理 & 工作区

全局工作区 (Global)	项目工作区 - 初始状态 (Project)

2. 发现技能商店 & 分发流程

技能商店 - 排行榜视图 (Rank)	技能详情与中文自动翻译 (Detail)

技能商店 - 卡片视图 (Store)	技能分发 - Agent 选择 (Distribution)

技能分发 - 生效范围与方式	Git 仓库源配置

3. 系统配置 & 环境健康度

数据与窗口设置 (Settings)	自定义 Agent 注册

关于我们 & 环境健康检查

🌟 特性

• 多平台原生体验与窗口行为：
  • macOS：完美的毛玻璃半透明窗口设计。
  • Windows：深度适配 Windows 11/10，采用高兼容性且极富质感的不透明浅灰雅致主题背景，彻底规避在部分低配或特殊配置机器上因特效冲突导致窗口“完全透明镂空”的渲染缺陷。
  • 系统级托盘与窗口行为：提供精美的系统级托盘菜单，支持通过左键点击一键呼出；支持设置开机自启、静默启动（仅托盘运行）以及关闭时最小化到托盘以常驻后台。
• Agent 图标与状态自动发现：开机自动扫描并盘点本机所有已安装的 AI 编码工具及其内置/外置的 Skills 目录。
• 智能、无感、安全的同步引擎：
  • 支持 全局 (Global) 和 项目级 (Project) 作用域同步。
  • 核心功能在启用/停用同步时自动识别同名物理目录，若内容不一致则采用时间戳重命名安全备份机制（[目录名].bak_YYYYMMDD_HHMMSS），确保你的开发源码 100% 安全。
  • 深度支持 Windows 符号链接 (Symlink) 机制，且自动兼容 Windows 大小写不敏感文件系统中的大小写纠错与两步重命名，消除自删除 Bug。
• 极速 Git 持久缓存与更新检查：
  • 并发限制队列：前端采用 Worker 并发数限制为 3 的工作队列机制，有效消除网络和主渲染线程的拥堵，页面操作（如 Tab 切换）如丝般顺滑。
  • 后端哈希缓存：每个唯一的远程 Git URL 统一哈希并独立缓存在本地 app_data_dir/cache/repos/ 中。
  • 10秒防冲突锁 + 增量 fetch：10 秒内的重复请求直接读取本地缓存，超过 10 秒则仅拉取 git fetch --depth 1 并重置，将更新检查从原本的数分钟瞬间优化到 秒级 响应。
• 技能排行榜与文档智能翻译：
  • 多维排行榜：商店内置“排行榜”与“网格卡片”双视图。排行榜支持对海量在线技能按照 All Time、Trending (24h) 和 Hot 指标进行排序，并直观呈现 8W 活跃度趋势图与总安装次数。
  • 文档自动翻译：详情侧边栏提供智能中文翻译功能，支持一键将英文 Skill 说明文档无缝转换为易读的中文，且支持随时一键恢复英文原版。
• 精细的更新状态与一键升级：
  • 详情页内联展示技能的最新版本状态（checking / available / current / check-failed）。
  • 直观的报错卡片：如果 Git 检查更新失败，将在详情中直接呈现淡红色的详细日志卡片，不用再悬浮看 Tooltip。
  • 手动强刷按钮与重新扫描、Toast 完成提示一应俱全。
• 问题诊断：自动检测孤儿目录、损坏的软链接、重名命名冲突、SKILL.md 元数据缺失等，提供一键重命名修复。

🛠️ 支持的 Agent 编码助理

• Claude Code (.claude/skills/)
• Cursor (.cursor/skills/)
• Zed (.zed/skills/)
• Windsurf (.windsurf/skills/)
• Codex (.codex/skills/)
• Trae, Cline, Gemini CLI, GitHub Copilot, OpenCode, Warp, Qoder, Antigravity, Augment 等 20+ 工具。

🚀 安装

macOS

1. 从 GitHub Releases 下载最新的 Manage My skills_*.dmg。
2. 双击打开并拖入「应用程序」文件夹。
3. 首次启动可能需要在「系统设置 → 隐私与安全性」中手动允许。

Windows

1. 下载打包好的安装包或便携版 .exe 运行即可。
2. 注意：在 Windows 上使用软链接（Symlink）同步时，请以管理员身份运行应用，或在 Windows 系统中开启「开发人员模式」（Developer Mode）。

🏗️ 从源码构建与开发

前置要求

• Node.js ≥ 18
• Rust（推荐通过 rustup 安装）

启动开发环境

git clone https://github.com/你的用户名/manage-my-skills.git
cd manage-my-skills
npm install

# 启动开发服务器（包含前端 HMR 和 Rust 热重载）
npm run tauri:dev

运行测试

# 仅前端
npm run dev

# 运行 Rust 单元测试
npm run test:rust

# 完整冒烟测试（执行打包构建校验 + 运行全部测试用例）
npm run smoke

本地编译打包

编译生产环境安装包（会自动生成符合当前系统平台的文件）：

npm run tauri:build

打包输出路径位于 src-tauri/target/release/bundle/ 下的对应平台目录。

一键升级版本号并打包（自动化脚本）

我们提供了一个高度容错的自动化打包脚本，会自动完成 package.json、src-tauri/tauri.conf.json 和 src-tauri/Cargo.toml 中版本号的同步更新并拉起打包：

# 以 x.x.x 版本为例进行一键更新与构建
npm run release -- 0.2.3

💡 密钥配置说明：

• 若需要发布签名更新包：请在项目根目录下创建 .env 文件（已被 .gitignore 保护拦截），写入您的私钥 and 解密密码：
  copy

  TAURI_SIGNING_PRIVATE_KEY="您的私钥内容"
  TAURI_SIGNING_PRIVATE_KEY_PASSWORD="您的私钥密码"
  

• 无密钥本地构建模式：如果本地没有检测到签名私钥，脚本会自动以「无签名更新包」的本地开发模式进行打包并自动还原配置，绝对不会发生因缺少签名密钥而编译报错中断的情况。

📡 自动化 CI 部署

项目在 .github/workflows/ci.yml 中集成了 GitHub Actions：

• 每次提交代码或提交 PR 到 main 分支时，自动运行 TypeScript 类型校验、前端静态构建与 Rust 测试。
• 后续配合发布 Tag 标签即可自动构建 Windows / macOS 双端 Release 发布包，并将产物自动上传到 GitHub Releases 中，方便用户开箱即用。

💻 技术栈

• 前端 (Frontend)：React 18 + TypeScript + Vite + Tailwind CSS + Lucide Icons + Radix UI
• 客户端 (Client)：Tauri v2 (Rust)
• 核心逻辑 (Core)：Rust (walkdir, serde 序列化映射, tokio 异步执行与多线程底层分流)
• 设计原则 (Design)：Quiet & Native 桌面级效率工具风格

📅 更新日志 (Changelog)

v0.2.3 (2026-06-25)

• ⚡ 体验飞跃与白屏抹平：
  • 在前端与后端之间引入了 app_ready 准备就绪反向通知机制。窗口仅在 Webview 资源解析完毕并画出首帧时才显示，彻底消除了启动瞬间的 WebView 空白画布。
  • 在 React 挂载及缓存读取前提供高精度呼吸扫光骨架屏（Skeleton Loading），消除由缓存异步载入所引起的状态闪烁与空状态引导页的跳变。
• ⚙️ 界面优化与选项瘦身：
  • 移除了顶部的中英文翻译按钮，统一为优雅规范的简体中文。
  • 移除了发现技能页面的“所有技能仓库源”下拉选择，去繁从简，专注直观呈现。
• 🔧 稳定性与开发体验提升：
  • 微调了开发配置，完美支持 tauri dev 期间的前端热更新（HMR）。
  • 优化了技能安装时的冲突判定策略，防止对已存在同名 Skill 的强行覆盖，提升安全性。

v0.2.2 (2026-06-24)

• 🌐 社区与文档建设：
  • 在中英文 README 中新增官方交流 QQ 群一键加群链接、赞赏支持板块。
  • 新增 LINUX DO 社区关联和致谢板块，与开源社区建立紧密纽带。
  • 将 README 中的本地截图相对路径全部替换为云端高性能 OBS 外链，并将图片折叠预览默认设置为展开状态。
• 🐛 细节修正：
  • 修复了 Windows 平台下某些边缘情况下的路径字符串匹配和解析机制。

v0.2.1 (2026-06-24)

• 🖥️ 抹平 Windows 运行黑框：
  • 彻底修复了在 Windows 系统下，点击设置按钮或静默运行外部 CLI 进程（如 Node/Git）时弹出 CMD 黑色命令提示符窗口的问题，提供了真正的后台静默执行体验。
• 🎨 界面与诊断交互升级：
  • 大幅优化了设置面板的卡片布局与响应式尺寸。
  • 新增自定义 Agent 目录的冲突诊断，对重名、同源的 Skill 提供清晰的诊断提醒；支持清理已标记的废弃与临时文件。

v0.1.1 (2026-06-23)

• 🔔 系统级托盘与自启：
  • 引入了桌面开机自启、静默启动（仅常驻系统托盘）以及关闭窗口时最小化到系统托盘的功能。
  • 接入 Tauri v2 官方自动更新插件，生成更新描述文件以支持软件一键增量热升级。
• ⚙️ 自动化构建工具链：
  • 隐藏了打包安装后启动时的控制台黑框。
  • 编写了高度容错的本地一键升级版本号并打包的发布自动化脚本。
  • 接入 GitHub Actions 自动化 CI/CD 打包流水线，支持自动生成 Windows (NSIS) 与 macOS 双端安装包并发布。

v0.1.0 (2026-06-23)

• 🎉 首个开源版本发布：
  • 核心功能就绪：支持跨平台本地 Agent 扫描、Skills 一键同步、符号链接（Symlink）挂载与时间戳安全备份（.bak）。
  • 🔬 解决 WebView 顽固拖拽 Bug：通过引入局部列表状态、延时激活 draggedIndex 以及把手 SVG 穿透，解决了 WebView 环境下拖动排序导致打断或判定禁止放置的顽固问题。
  • 💬 弹出层优化：针对 WebView 屏蔽原生系统 confirm 弹窗的问题，改用了美观的内联气泡确认框；并强制开启 WebView 内部的 WebkitUserDrag 拖曳属性支持。

💬 交流与支持

欢迎加入 AI 交流群（QQ群：1091305103），点击链接加入群聊【AI交流群】：https://qm.qq.com/q/z5iGv1PUoU，反馈问题、交流使用体验或提出新功能建议。

如果 Manage My Skills 帮到了你，可以请我喝杯咖啡，或者随手赞赏支持一下继续维护：

| | |

🔗 社区关联与致谢 (Community Links)

该开源项目与 LINUX DO 社区相关联并获得其认可：

• LINUX DO：https://linux.do/

Manage My skills — 让你的 AI 编码技能融会贯通，不再散落各处。