
如何为 skills-manage 贡献代码开发环境搭建、验证命令与 PR 规范完整开发者指南【免费下载链接】skills-manageDesktop app to manage AI coding agent skills across Claude Code, Cursor, Gemini CLI, Codex, and 20 platforms from one place.项目地址: https://gitcode.com/gh_mirrors/sk/skills-manage本文是skills-manage 开源项目的完整代码贡献指南。这是一个基于 Tauri 的 AI 技能管理桌面应用下文将带你走完开发者的完整链路搭建开发环境→ 本地跑通应用 → 执行验证命令→ 按PR 规范提交 Pull Request帮助新手顺利发出自己的第一个贡献。一、先认识 skills-manage它是什么skills-manage 是一款面向开发者的AI 技能管理工具让你从同一个入口管理 Claude Code、Cursor、Gemini CLI、Codex 等 20 个 AI 编码平台上的 Agent 技能。它的核心设计是中央技能库以~/.agents/skills/作为技能的唯一真实来源一键安装到平台通过符号链接把技能分发到各平台的技能目录技能市场 GitHub 导入远程浏览技能、从仓库批量导入技能集合把常用技能分组支持批量安装它的架构是清晰的三层结构React 前端 (src/) ──Tauri IPC──▶ Rust 后端 (src-tauri/src/) ──SQLx──▶ SQLite前端用 React TypeScript Tailwind CSS 编写后端用 Rust 实现数据保存在本地 SQLite。在动手改代码之前先理解这个结构会少走很多弯路。二、开发环境搭建4 个工具 3 条命令启动应用2.1 前置工具清单工具版本要求用途Node.js当前 LTS 版本前端构建工具链pnpm最新版仓库指定的包管理器RustStable 工具链编译 Tauri 桌面端后端Tauri 系统依赖参照 Tauri v2 官方前置条件文档系统级窗口与 WebView 依赖库2.2 克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/sk/skills-manage cd skills-manage pnpm install2.3 启动桌面应用pnpm tauri dev首次启动会同时触发前端依赖安装和 Rust 编译请耐心等待几分钟。成功启动后你会看到类似这样的应用窗口 提示本地开发时 Vite 开发服务器运行在24200 端口配置见 vite.config.ts。如果只想单独调试前端界面可以直接运行pnpm dev。三、提交代码前必会的 5 条验证命令项目的验证命令集中定义在 package.json官方 CONTRIBUTING.md 要求你在提交 PR 之前本地跑通以下全部检查pnpm test # 运行全部前端测试Vitest370 pnpm typecheck # TypeScript 类型检查 pnpm lint # ESLint 代码规范检查 cd src-tauri cargo test # 运行全部 Rust 后端测试214 cd src-tauri cargo clippy -- -D warnings # Rust Lint警告视为错误修改某个模块时也可以只跑对应的单测效率更高pnpm test -- src/test/skillStore.test.ts # 只跑单个前端测试文件 cd src-tauri cargo test db:: # 只跑 db 模块的 Rust 测试完整命令清单含调试模式说明整理在 CLAUDE.md 中。四、动手改代码前先看懂项目结构熟悉目录布局是避免改着改着找不到北的关键。项目结构详见 README.mdsrc/pages/ — 各路由的页面视图中央技能库、技能市场、设置等src/components/ — 前端 UI 组件src/stores/ — Zustand 状态仓库前端与后端通信的唯一入口约定不要在组件里直接调用invoke()src/i18n/ — 中英双语语言文件所有用户可见文本必须走 i18nsrc-tauri/src/commands/ — Rust IPC 命令模块按 scanner、agents、linker、marketplace 等职责拆分src-tauri/src/db.rs — SQLite 表结构与自动迁移src/test/setup.ts — Vitest 测试环境配置五、PR 提交规范6 条规则助你快速过审对照 CONTRIBUTING.md把 PR 写得规范是提升合并速度的核心小步提交小而可评审的 PR 最容易合并不要在不相关的重构中混入功能或修复大特性先开 issue涉及大功能、行为变更或新依赖时先讨论方向再动手文档与提交信息用英文文档、注释、commit message、PR 描述尽量使用英文UI 变更必须附截图凡涉及界面行为的改动请在 PR 中附上截图或短视频效果示例如下绝不提交敏感信息代码、截图、issue 中严禁出现真实的密钥、token 或私钥行为变更要更新测试改了行为就补测试这是评审时的基本期待提交即代表你的贡献将以Apache License 2.0授权详见 LICENSE。六、Bug 报告与安全漏洞贡献不只是改代码高质量的反馈同样重要普通 Bug请附上操作系统版本、应用版本或 commit、清晰的复现步骤、期望与实际行为、相关日志或截图安全漏洞请勿公开提 issue而是按 SECURITY.md 中的流程私下报告结语你的第一个 PR 可以很简单从克隆仓库到发出 PR路径其实很短pnpm install→pnpm tauri dev跑通环境 → 挑一个小的 issue修文案、补 i18n 翻译、完善测试都是好起点→ 本地跑完 5 条验证命令 → 按规范提交 PR。期待看到你的第一个贡献【免费下载链接】skills-manageDesktop app to manage AI coding agent skills across Claude Code, Cursor, Gemini CLI, Codex, and 20 platforms from one place.项目地址: https://gitcode.com/gh_mirrors/sk/skills-manage创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考