1. 项目定位与用途
Skills Manager 是一款跨平台桌面应用，定位为 AI 编程助手技能的统一管理中心。其用途是让用户在一个安全的位置集中编写、存储和管理所有 AI 工具（如 Claude Code、Codex、Opencode）所需的技能文件，通过自动化同步机制，实现技能在各工具间的即时共享与更新，消除手动复制和维护多个副本的繁琐工作。
项目档案应用项目
jiweiyeah/Skills-Manager 是什么？用途、安装与使用指南
Skills Manager 是一款专为开发者设计的跨平台桌面应用，通过软链接同步机制统一管理多种 AI 编程助手的技能。本文提供项目定位、核心功能、多平台安装步骤、使用指南及常见问题解答，帮助您快速上手，实现技能一处编写、多处使用。
AI 总结
Skills Manager 是一款跨平台桌面应用，通过软链接同步机制统一管理 Claude Code、Codex、Opencode 等 AI 编程助手的技能，实现一处编写、多处使用，避免文件重复与配置碎片化。
中文项目介绍
Skills Manager 是一款专为开发者设计的现代化桌面应用程序，旨在解决不同 AI 编程助手（如 Claude Code、Codex、Opencode）之间技能配置碎片化的问题。它提供一个中心化的枢纽，让用户无需为每个工具单独管理和复制技能文件。
该应用的核心价值在于其强大的软链接同步机制：用户只需在指定目录编写一次技能，应用便会自动在各 AI 工具的技能路径中创建符号链接，确保所有工具即时使用最新版本，同时节省磁盘空间并简化维护流程。
适用场景包括：同时使用多种 AI 助手并希望统一管理提示词库的开发者；需要确保跨工具技能版本一致且能中心化更新的团队；以及希望对特定工具灵活启用/禁用某些技能而不影响原始文件的用户。应用基于 Rust 与 Tauri 2.0 构建，保证高性能与低资源占用，并原生支持 macOS、Windows 与 Linux 系统。
详细信息与使用说明
2. 解决的问题
该应用主要解决 AI 助手技能配置的碎片化问题。传统方式下，用户需为每个工具单独维护技能目录，导致文件重复、版本不一致且更新困难。Skills Manager 通过符号链接同步，确保技能源文件唯一，任何修改立即生效于所有链接工具，同时支持细粒度控制（按工具启用/禁用），从根本上简化了技能生命周期管理。
3. 适用场景
主要适用于同时使用多种 AI 编程助手的开发者，例如在 Claude Code、Codex 和 Opencode 之间切换工作的用户。也适合团队希望共享标准化技能库的场景，以及个人用户需要快速在不同工具中测试同一技能的情况。此外，对于希望将技能存储在云端或外部驱动器并跨设备同步的用户，其云同步功能（路线图已实现）也提供支持。
4. 安装方式
安装方式为从项目 Releases 页面下载对应平台的安装包：macOS 用户下载 .dmg 文件，Windows 用户下载 .msi 或 .exe 文件，Linux 用户下载 .deb、.AppImage 或 .rpm 文件。Windows 用户若遇软链接创建权限问题，需以管理员身份运行安装程序或应用；Linux 用户若在虚拟机中运行 .AppImage 出现白屏，需通过终端以环境变量 WEBKIT_DISABLE_COMPOSITING_MODE=1 前缀启动。仓库中未明确给出命令行安装指令。
5. 使用方式
首次启动应用时，系统会引导用户选择或创建用于集中存储技能的目录。随后，应用自动检测系统中已安装的 AI 工具（如 Claude Code）并建立软链接同步。用户可在图形界面中浏览、管理技能文件，并对每个工具独立启用或禁用特定技能，所有操作均不影响原始源文件。应用还支持添加自定义工具，配置其路径与图标。
6. 补充说明与实现特点
技术栈上，后端使用 Rust 处理文件系统操作（软链接创建与管理），前端基于 React 19 构建，样式采用 Tailwind CSS v4，UI 组件使用 Radix UI，代码编辑集成 Monaco Editor。应用设计为跨平台，通过 Tauri 2.0 框架适配各系统特性。当前版本为 2.0.1，路线图包括社区中心、插件系统及集成聊天界面等计划。仓库中未明确给出源代码目录结构或构建命令，仅提供发布文件与文档。
思维导图
Skills Manager
核心功能
统一管理
软链接同步
细粒度控制
自定义工具
技术栈
后端：Rust + Tauri 2.0
前端：React 19
样式：Tailwind CSS v4
组件：Radix UI
编辑器：Monaco Editor
平台支持
macOS
Windows
Linux
工具集成
Claude Code
Codex
Opencode
自定义工具
关键机制
符号链接同步
自动工具检测
中心存储目录
用户界面
技能列表管理
工具配置面板
启用/禁用切换
内置代码编辑器
常见问题
Windows 上创建软链接失败或工具检测不到怎么办？
在 Windows 系统上，创建符号链接通常需要管理员权限。请尝试以管理员身份运行 Skills Manager，或启用系统的开发者模式（Developer Mode）。README 中明确提示此问题。
Linux 运行 AppImage 文件时出现白屏如何解决？
这通常是 WebKitGTK 硬件加速问题。请在终端中通过命令 `WEBKIT_DISABLE_COMPOSITING_MODE=1 ./Skills-Manager_*.AppImage` 启动应用，该解决方案在 README 的 Linux 故障排除部分有说明。
Skills Manager 支持哪些 AI 编程工具？
应用开箱即用支持 Claude Code、Codex 和 Opencode。同时，它具备良好的扩展性，允许用户通过配置添加自定义工具，指定其路径与图标。
技能文件实际存储在哪里？同步机制如何工作？
首次启动时，应用会引导用户选择一个中心目录用于存储所有技能的源文件。同步通过创建符号链接实现：应用在用户指定的 AI 工具技能路径下指向中心目录中对应文件的链接，因此原始文件唯一，任何修改立即同步到所有链接处，无需复制。
是否支持云同步或跨设备同步？
是的，云同步功能已在路线图中实现。它允许用户将技能存储在云端或外部驱动器，从而在不同设备间保持同步，实现跨设备的一致技能管理。