1. 项目定位与用途
Skills Manager 是一款专为 macOS 平台开发的本地化桌面应用程序，定位为多编码代理技能的统一管理平台。其核心用途是为使用多种 AI 编程助手的开发者提供一站式的技能插件管理体验，覆盖从发现、安装、测试到维护的完整生命周期。应用通过图形化界面替代各代理分散的命令行或手动配置方式，显著提升技能管理效率。
项目档案应用项目
yibie/skills-manager 是什么？用途、安装与使用指南
yibie/skills-manager：Skills Manager 是一款 macOS 原生应用，用于统一管理 Claude Code、Cursor、Copilot CLI 等多款 本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
Skills Manager 是一款 macOS 原生应用，用于统一管理 Claude Code、Cursor、Copilot CLI 等多款 AI 编码代理的技能插件，提供发现、安装、沙盒测试、集中管理和实时监控的全流程能力。
中文项目介绍
Skills Manager 是专为 macOS 开发者设计的桌面应用程序，旨在解决不同 AI 编码代理技能格式分散、安装路径不统一导致的管理的痛点。
该应用通过集中式界面，将 Claude Code、Cursor、Copilot CLI、OpenAI Codex CLI 和 Gemini CLI 等主流编码代理的技能插件整合在一起，实现跨代理的统一管理。
主要适用场景包括：同时使用多个编码代理的开发者需要在一个界面中浏览和安装技能；在将技能正式安装到代理前，先在沙盒中测试其效果；批量更新或移除已安装技能，并收藏常用技能；实时监控各代理的技能目录变化和运行状态。
技术实现上，采用纯本地架构，无后端服务，除沙盒测试的 LLM 调用外完全离线工作。基于 SwiftUI 和 SwiftData 构建，要求 macOS 14 (Sonoma) 或更高版本。应用直接读写各代理的本地配置文件，并通过 Git 操作与技能市场仓库同步。
详细信息与使用说明
2. 解决的问题
项目主要解决 AI 编码生态中技能管理的碎片化问题。不同编码代理（如 Claude Code、Cursor 等）采用各异的技能格式、安装路径和配置机制，导致开发者需要在多个位置查找、安装和维护技能，过程繁琐且易出错。Skills Manager 通过抽象统一的技能模型和适配器模式，屏蔽各代理的差异，实现"一次发现、多端安装"的集中管理，消除格式不兼容和管理界面分散的痛点。
3. 适用场景与用户群体
主要面向同时使用多个 AI 编码代理的 macOS 开发者。典型场景包括：在多代理间切换的开发者需要统一查看和安装技能；在正式部署前，需在隔离环境中验证技能的实际效果；希望批量管理已安装技能（更新、卸载、星标）以提高效率；需要实时监控各代理技能目录状态和变更。此外，技能创作者也可通过内置沙盒快速测试插件功能。
4. 安装方式与系统要求
安装方式有两种：一是从 GitHub Releases 页面下载最新发布的应用包，直接拖拽至 Applications 文件夹完成安装；二是从源码构建，通过 git clone 克隆仓库后，使用 Xcode 打开 SkillsManager.xcodeproj 项目并运行。系统要求为 macOS 14 (Sonoma) 或更高版本，并需至少安装一款支持的编码代理（Claude Code、Cursor、Copilot CLI、Codex 或 Gemini CLI）。仓库中未提供 Homebrew 或其他包管理器的安装方式。
5. 核心功能与使用流程
核心功能分为五大模块：Discover（发现）从技能市场和社区源浏览插件；Install（安装）支持一次性安装到单个或多个代理；Test（测试）在内置 LLM 沙盒中验证技能效果；Manage（管理）提供更新、移除、星标收藏等操作；Monitor（监控）实时显示各代理技能目录状态。使用流程为：打开应用后浏览发现页，选择技能并指定目标代理安装，可在沙盒页测试，最后在库页管理已安装技能，侧边栏支持按代理、来源或星标筛选。
6. 技术架构与实现特点
采用纯本地架构，无后端依赖，除沙盒 LLM 调用外完全离线。技术栈为 SwiftUI + Swift 6 与 SwiftData，利用 FSEvents 监听文件变更，通过 Process 调用 git CLI 与 GitHub API 交互。关键模块包括：MarketplaceService 负责从 GitHub 拉取市场索引；InstallService 处理插件下载、解压和安装；SkillStore 作为中央状态管理器；LLMService 封装沙盒测试的 LLM 调用；FileWatcher 实时监控技能目录。适配器模式通过 AgentAdapter 协议统一不同代理的目录结构和配置格式差异。
思维导图
Skills Manager
Adapters (适配层)
AgentRegistry.swift
ClaudeCodeAdapter.swift
UniversalAdapter.swift
Models (数据模型)
AgentAdapter.swift
Skill.swift
MarketplacePlugin.swift
SandboxSlot.swift
AppSettings.swift
Services (核心服务)
MarketplaceService
InstallService
SkillStore
LLMService
FileWatcher
GitService
SkillParser
Views (用户界面)
ContentView
DiscoverView
SandboxView
SkillListView
SkillDetailView
SidebarView
SettingsView
应用入口
SkillsManagerApp.swift
AppDelegate.swift
常见问题
Skills Manager 支持哪些编码代理？
根据 README 的 Supported Agents 表格，当前已支持 Claude Code、Cursor、Copilot CLI、OpenAI Codex CLI 和 Gemini CLI 五款编码代理，状态均为 ✅。
如何安装 Skills Manager？
提供两种安装方式：从 GitHub Releases 页面下载最新应用包并拖拽至 Applications 文件夹；或从源码构建，克隆仓库后用 Xcode 打开 SkillsManager.xcodeproj 项目运行。仓库中未提供 Homebrew 等其他安装方式。
应用是否需要网络连接？
应用采用纯本地架构，大部分功能可离线使用。但技能市场发现功能需要网络连接以访问 GitHub API，沙盒测试功能也需要网络调用 LLM 服务。本地已安装技能的管理和监控完全离线。
如何测试技能效果？
应用内置 LLM 沙盒功能，用户可在 Sandbox 视图中选择技能并进行测试。该功能通过 LLMService 封装 LLM 调用，允许在安全隔离的环境中验证技能的实际效果，无需正式安装到目标代理。
是否支持团队协作或技能同步？
根据 Roadmap，团队同步功能（Team sync via shared marketplace fork）是计划中的未来特性，当前版本未明确给出。现有版本主要关注个人用户的本地技能管理，未提及团队共享或同步机制。