Skill Studio 是一个本地优先的桌面端 Skill 资产管理工具，用于创建、导入、组织、版本化、对比和同步 AI Agent 技能。它把个人 Skill 工作区、版本快照、外部市场、平台目录、项目空间和团队交付流程整合到同一个应用中，让 Skill 从散落的本地文件变为可追踪、可回滚、可复用、可交付的资产。
支持的平台包括 Cursor、Claude Code、Codex、Windsurf、Roo Code 等 45+ 种 Agent 平台。
当前状态：v0.1.0 已作为跨平台预览版发布。Windows、macOS 和 Linux 安装包可在 Releases 下载。
| 平台 | 推荐下载 |
|---|---|
| Windows | 从 Releases 下载 .exe 或 .msi |
| macOS | 从 Releases 下载 .dmg |
| Linux | 从 Releases 下载 .AppImage、.deb 或 .rpm |
当前安装包是未签名预览版。Windows 和 macOS 可能出现系统安全提示；下载后请使用 Release 附带的 SHA256 文件校验完整性。
总览
技能资产
技能详情
版本对比
市场
平台中心
项目空间
团队空间
| 模块 | 能力 |
|---|---|
| 总览 | 个人 Skill、快照、团队待处理事项和核心资产状态一览。 |
| 技能资产 | 创建、导入、搜索、分类、打标签、批量整理 Skill。 |
| 技能详情 | 浏览文件树、读取和编辑文件、打开外部编辑器、打开所在目录。 |
| 版本快照 | 创建快照、查看历史、对比版本差异、恢复工作副本、设置生效版本。 |
| 市场与导入 | 从本地目录、Git 仓库、内置模板和外部 Skill 市场导入资产。 |
| 平台中心 | 检测 Agent 平台目录，配置同步目录和同步模式。 |
| 项目空间 | 为项目绑定 Skill 和平台目录，生成同步计划，执行项目级同步。 |
| 团队空间 | 团队 Skill 库、提交、差异评审、合并、推荐版本和拉取。 |
| 系统设置 | 主题、语言、发布前恢复点、快照保留上限、数据目录配置。 |
从 Releases 页面下载对应平台的预构建安装包。
说明：每个 release 的正文都会列出各平台安装包、校验文件、自动更新前置条件和预发布限制；详细模板见 docs/release-notes.md。
说明：当前预构建安装包按未签名预览版发布。Windows 和 macOS 可能出现系统安全提示。安装带自动更新能力的基线版本后，后续版本可在应用内检查更新。下载后请对照 Release 附带的 SHA256 校验文件确认文件完整性。
# 环境要求：Node.js 18+、Rust 1.75+、Git、Tauri 系统依赖
git clone https://github.com/liu673/skill-studio.git
cd skill-studio
npm install
npm run tauri devnpm run check # 全量校验
npm test # 仅前端测试| 概念 | 说明 |
|---|---|
| Skill | 可被 Agent 使用的能力包，通常包含 skill.md 和相关文件。 |
| 工作副本 | 当前正在编辑的 Skill 文件目录。可能尚未保存为稳定版本。 |
| 快照 | 某时间点的完整 Skill 目录副本，带序号、变更摘要和修订哈希。 |
| 生效版本 | 当前被认定为可发布、可同步、可交付的快照版本。 |
| 来源记录 | Skill 的来源信息：手动创建、本地导入、Git 导入、市场导入或平台扫描。 |
| 平台连接 | 某 Agent 平台的 Skill 目录配置（如 Cursor、Claude Code、Codex）。 |
| 项目空间 | 面向具体项目的 Skill 编排和平台同步范围。 |
| 团队版本 | 团队库中的稳定 Skill 版本，可评审、推荐和拉取。 |
Skill Studio 内置了 45+ 种 Agent 平台的目录识别规则，并支持自定义平台。内置平台包括：
Cursor · Claude Code · Codex · OpenCode · Antigravity · Amp · Kilo Code ·
Roo Code · Goose · Gemini CLI · GitHub Copilot · OpenClaw · Droid ·
Windsurf · TRAE IDE · Cline · Deep Agents · Firebender · Kimi Code CLI ·
Replit · Warp · Augment · IBM Bob · CodeBuddy · Command Code · Continue ·
Cortex Code · Crush · iFlow CLI · Junie · Kiro CLI · Kode · MCPJam ·
Mistral Vibe · Mux · Neovate · Pochi · Qoder · Qwen Code · TRAE CN ·
Zencoder · AdaL · Hermes Agent
平台同步默认采用目录复制模式，也支持符号链接模式（适用于支持该功能的平台）。
前端模块布局、Rust 后端分层、数据存储和关键设计决策详见 docs/ARCHITECTURE.md。
┌─────────────────────────────────────────┐
│ Desktop Shell (Tauri 2) │
│ ┌───────────────┐ ┌───────────────┐ │
│ │ React 前端 │ │ Rust 后端 │ │
│ │ TypeScript │◄──┼──────────────►│ │
│ │ Tauri IPC │ │ SQLite / FS │ │
│ └───────────────┘ └───────────────┘ │
└─────────────────────────────────────────┘
- Node.js 18 或更高版本
- Rust 1.75 或更高版本
- Git
- 平台构建工具（参考 Tauri 官方文档）
Ubuntu / Debian 系统安装 Tauri 依赖：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
sudo apt update
sudo apt install -y \
pkg-config libwebkit2gtk-4.1-dev libxdo-dev libssl-dev \
libayatana-appindicator3-dev librsvg2-dev fonts-noto-cjknpm install
npm run tauri dev # 完整桌面应用
npm run dev # 仅前端（无桌面功能）| 命令 | 检查内容 |
|---|---|
npm run typecheck |
TypeScript 类型编译 |
npm test |
前端测试（Vitest） |
npm run build |
前端生产构建 |
npm run rust:fmt |
Rust 格式检查 |
npm run rust:check |
Rust 编译检查 |
npm run rust:test |
Rust 测试 |
npm run check |
全部校验 |
npm run tauri build当前 bundle.targets 设为 all，在当前平台构建。如需跨平台发布，请在对应操作系统上分别构建。
| 平台 | 产物 |
|---|---|
| Windows | .msi、.exe 安装包 |
| macOS | .dmg（未签名预览版可能触发 Gatekeeper 提示） |
| Linux | .AppImage、.deb、.rpm |
安装包说明：每个 release 产物应附带 SHA256 校验文件。 Release 正文会同步说明平台安装包、更新元数据和签名文件；正文模板见 docs/release-notes.md。 生成脚本见
scripts/generate_checksums.sh和scripts/generate_checksums.ps1。
- Windows 安装包暂未代码签名，可能显示“未知发布者”或 SmartScreen 警告。
- macOS 安装包暂未签名和 notarization，首次打开可能需要用户手动确认。
- 首次使用自动更新前，需要先手动安装一个已经内置 updater 的基线版本。
- Release 产物需附带 SHA256 校验文件，用于验证下载文件完整性。
src-tauri/tauri.conf.json中已配置 GitHub Releases 更新端点。- Release 构建需要 GitHub Secrets：
TAURI_SIGNING_PRIVATE_KEY，若私钥设置了密码，还需要TAURI_SIGNING_PRIVATE_KEY_PASSWORD。 - 发布时必须同步提升
package.json、src-tauri/Cargo.toml和src-tauri/tauri.conf.json版本号。 - 旧版本若未内置 updater，无法自动升级到新版本，需要用户手动安装一次基线版本。
完整发布流程见 docs/RELEASE.md。
- 默认纯本地存储：所有数据保存在
~/.skill-studio/，不依赖任何云服务 - 网络访问受限：仅市场浏览和 Git 导入产生出站网络请求
- 不自动执行：导入的 Skill 作为文件存储，不会被自动执行
- 同步由用户主导：仅向用户明确配置的目录写入文件
完整安全政策、支持版本和漏洞报告流程见 SECURITY.md。
欢迎提交贡献。提交前请阅读 CONTRIBUTING.md。要点如下：
- 提交 Pull Request 前运行
npm run check，确保全部校验通过 - 提交信息遵循 Conventional Commits 规范
- 新增功能请附带测试用例
- 安全漏洞请私下报告，不要在公开 issue 中描述（参见 SECURITY.md）
Skill Studio 采用 Apache License 2.0 开源许可。详见 LICENSE 和 NOTICE。
Skill Studio 为项目名称及商标。应用中提及的第三方平台名称和标识（如 Cursor、Claude Code、Codex、Windsurf 等）为其各自所有者所有，仅用于识别和互操作，不构成对这些所有者的任何形式的认可或推荐。