CCSW Skills Manager

CCSW Skills Manager 是一个基于 Electron、Vite、React 和 TypeScript 的 cc-switch skills 管理桌面应用，面向 Windows 和 Linux。

它把 ~/.cc-switch/skills 作为主库，支持把 skill 同步到目标 agent 的 skills 目录：

• Claude: ~/.claude/skills
• Codex: ~/.codex/skills
• Agents: ~/.agents/skills
• 自定义 agent 目录

功能

• 扫描 cc-switch 默认 skills 目录并解析 SKILL.md frontmatter。
• 卡片化展示 skill 名称、介绍、版本、标签、文件数、更新时间和目标 agent 状态。
• 自动分类，并支持手动分类覆盖。
• 在详情区查看触发方式、来源信息、依赖、标签和目标 agent 启用状态。
• 在应用内修订 skill 介绍。
• 根据系统设置语言展示本地翻译后的介绍。
• 内置文本编辑器，可编辑 SKILL.md、references/*.md、脚本和 JSON/YAML 等文本文件。
• 同步、启用、关闭、删除目标 agent 中的 skill。
• 支持在设置中配置自定义 agent 的 skills 目录。
• AI 翻译和 AI 分类调用 cc-switch 本地大模型路由，默认地址为 http://127.0.0.1:15721/v1；模型名称可留空，应用会尝试继承 cc-switch 当前 Codex provider 的模型。
• 全局删除时先移入 ~/.cc-switch/skills-manager/trash。
• 将二次开发版本复制并提交到 Git 仓库。
• 对所有 skills、分类、目标 agent 启用/关闭状态进行整体备份与恢复。

安装与运行

npm install
npm run electron:dev

也可以只启动 Web UI 调试：

npm run dev

生产构建：

npm run build

测试

npm test
npm run lint
npm run smoke

当前测试覆盖：

• SKILL.md frontmatter 解析和介绍修订。
• skill 扫描、自动分类、翻译展示、目标 agent 状态。
• 手动分类。
• 同步到目标 agent、关闭、重新启用、删除。
• 文件编辑和路径穿越保护。
• 自定义 agent 目录同步。
• 整体备份和恢复，包括目标 agent 的启用/关闭状态。

数据与安全行为

应用会写入：

• ~/.cc-switch/skills-manager/app-data.json
• ~/.cc-switch/skills-manager/trash
• 用户选择的备份目录
• 用户配置的 Git 仓库目录

AI 翻译/分类设置保存在应用数据中。若本地路由返回 HTTP 404 model_not_found 或 Upstream error，通常是模型名称和 cc-switch 当前上游不匹配；在设置中清空模型名称，或填写 cc-switch 当前 provider 支持的模型即可。

关闭某个目标 agent 中的 skill 时，应用会把目录移动到该 agent skills 目录下的 .disabled/<skill>。重新启用时会移回原位置。

cc-switch 主库中的 skill 不会被“关闭”；主库只支持编辑、备份、Git 同步和删除到回收站。