PR Checklist【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studioTests added for new functionalityNo console.log statementsError handling includes user-facing messagesAPI changes are backwards compatibleDatabase migrations are reversible要点context: fork 让审查在隔离子代理中运行 !gh pr diff 动态注入真实 diff。allowed-tools 语义上要求具备执行能力配合清单可输出逐项 ✅/❌ 的审查结论。 ### 8.6 发布说明生成器Git 历史聚合 从 Git 历史生成发布说明 **SKILL.md:** yaml --- name: release-notes description: Generate release notes from commits since last tag disable-model-invocation: true --- ## Recent Changes - Commits since last tag: !git log $(git describe --tags --abbrev0)..HEAD --oneline - Last tag: !git describe --tags --abbrev0 Generate release notes: 1. Group commits by type (feat, fix, docs, etc.) 2. Write user-friendly descriptions 3. Highlight breaking changes 4. Format as markdown要点完全依赖动态上下文注入获取提交历史无需任何参考文件是一个纯指令型 Skill 的典型。8.7 项目约定Claude 专属背景知识Claude 自动套用的背景知识SKILL.md:--- name: project-conventions description: Code style and patterns for this project. Apply when writing or reviewing code. user-invocable: false --- ## Naming Conventions - React components: PascalCase - Utilities: camelCase - Constants: UPPER_SNAKE_CASE - Files: kebab-case ## Patterns - Use ResultT, E for fallible operations, not exceptions - Prefer composition over inheritance - All API responses use { data, error, meta } shape ## Forbidden - No any types - No console.log in production code - No synchronous file I/O要点user-invocable: false使 Claude 在写代码/审查时自动应用这些约定用户无需手动调用。这与 Cherry Studio 内置 cherry-assistant-guide/SKILL.md 的定位一致——后者作为后台知识约束助手不凭记忆回答产品问题必须先读当前安装包清单。8.8 环境搭建前置脚本用脚本引导新开发者完成环境配置.claude/skills/setup-dev/ ├── SKILL.md └── scripts/ └── check-prerequisites.shSKILL.md:--- name: setup-dev description: Set up development environment for new contributors disable-model-invocation: true --- Set up development environment: 1. Check prerequisites: bash scripts/check-prerequisites.sh 2. Install dependencies: npm install 3. Copy environment template: cp .env.example .env 4. Set up database: npm run db:setup 5. Verify setup: npm test Report any issues encountered.要点把 onboarding 文档固化为可执行步骤序列新成员一条命令触发、逐步完成配置并反馈问题。九、Cherry Studio 中的 Skills 生态从内置 Skill 到市场安装9.1 内置 Skills 的加载与镜像Cherry Studio 将内置 Agent 的 Skills 直接打包在仓库的resources/builtin-agents/cherry-assistant/.claude/skills/下运行时由SkillService统一扫描管理。从源码看SkillService.ts用户级 Skills 位于userData/Data/Agents/.claude/skills内置项则作为应用持有的镜像出现系统还会执行完整性检查presence authored-skill change detection并清理已消失的非内置条目SkillService.ts。9.2 内置 Skill 实战skills-manager 的安装工作流skills-manager/SKILL.md 展示了 Cherry Studio 中安装与创建 Skill 的完整降级链路搜索优先调用find-skills不可用时降级为 CLI——npx skills find [query]备选$CHERRY_STUDIO_BUN_PATH x skills都没有则提示安装 Node.js安装npx skills add owner/reposkill -y位置为项目级.claude/skills/或用户级~/.claude/skills/创建优先调用内置skill-creator走完整的需求澄清、初始化、编辑、验证、迭代流程不可用时降级npx skills init skill-name并保持SKILL.md精简、按需补充scripts/、references/、assets/验证底线创建后至少验证 frontmatter、触发描述和一个真实用例验证失败则修正后重跑。9.3 内置 Skill 实战Skill 市场Marketplacecherry-skill-marketplace/SKILL.md 定义了市场搜索与安装的 MCP 协议式操作搜索mcp__skills__search_skills参数{ query: 1-3 个聚焦关键词 }安装mcp__skills__install_skill参数{ install_source: 搜索结果的原值 }其中install_source是不透明值必须逐字使用搜索结果返回的原值不得自行构造安全边界安装前说明 Skill 是第三方代码、会继承当前工具权限须取得用户明确同意删除/卸载需先通过产品清单导航到 Skills UI 并再次确认名称。9.4 内置 Skill 实战Claude 自动化推荐器本文档的宿主claude-automation-recommender是仓库内随附的推荐型 Skill其 SKILL.md 定义了跨 Hooks / Subagents / Skills / Plugins / MCP 五类的代码库自动化推荐流程并包含 Cherry Studio 特有的Phase 0 扫描确认门上游未含扫描前必须公布读取计划与 token 预算典型中型仓库约 20–40K tokens获得用户明确确认后才进入分析用户拒绝时可提供缩小范围、仅口头咨询或延后处理三种替代方案见 NOTICE.md。它在 Phase 2 的 Skills 推荐中直接引用本文档所在的 skills-reference.md并给出代码库信号 → 要创建的 Skill → 调用方式对照表代码库信号要创建的 Skill调用方式API 路由api-doc含 OpenAPI 模板用户 Claude数据库项目create-migration含校验脚本仅用户测试套件gen-test含示例测试仅用户组件库new-component含模板仅用户PR 工作流pr-check含清单仅用户发布release-notes含 git 上下文仅用户代码风格project-conventions仅 Claude新人 onboardingsetup-dev含前置脚本仅用户9.5 决策框架何时推荐哪种自动化Skill 并非万能应在合适场景推荐推荐 Skills 的场景频繁重复的提示词或工作流带参数的项目专属任务需要把模板或脚本应用到任务上Skill 可捆绑辅助文件通过/skill-name快速触发的动作需要在隔离环境运行的工作流context: fork。推荐 Hooks 的场景重复性的编辑后动作格式化、lint保护性规则阻止敏感文件被编辑校验检查测试、类型检查。对应参考见 hooks-patterns.md。推荐 Subagents 的场景需要专业能力安全、性能并行审查工作流后台质量检查。推荐 Plugins 的场景需要多个相关 Skill想要开箱即用的自动化捆绑包团队级标准化。推荐 MCP Servers 的场景需要外部服务集成数据库、API库/SDK 文档查询浏览器自动化或测试团队工具集成GitHub、Linear、Slack云基础设施管理。十、从参考文档到生产实践推荐输出格式当推荐器产出结论时遵循每类仅给 1–2 个最优推荐的输出纪律用户指定类型时给 3–5 个并采用结构化报告格式## Claude Code Automation Recommendations ### Codebase Profile - **Type**: [detected language/runtime] - **Framework**: [detected framework] - **Key Libraries**: [relevant libraries detected] ### Skills #### [skill name] **Why**: [specific reason] **Create**: .claude/skills/[name]/SKILL.md **Invocation**: User-only / Both / Claude-only **Also available in**: [plugin-name] plugin (if applicable)【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 PR Checklist
PR Checklist【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studioTests added for new functionalityNo console.log statementsError handling includes user-facing messagesAPI changes are backwards compatibleDatabase migrations are reversible要点context: fork 让审查在隔离子代理中运行 !gh pr diff 动态注入真实 diff。allowed-tools 语义上要求具备执行能力配合清单可输出逐项 ✅/❌ 的审查结论。 ### 8.6 发布说明生成器Git 历史聚合 从 Git 历史生成发布说明 **SKILL.md:** yaml --- name: release-notes description: Generate release notes from commits since last tag disable-model-invocation: true --- ## Recent Changes - Commits since last tag: !git log $(git describe --tags --abbrev0)..HEAD --oneline - Last tag: !git describe --tags --abbrev0 Generate release notes: 1. Group commits by type (feat, fix, docs, etc.) 2. Write user-friendly descriptions 3. Highlight breaking changes 4. Format as markdown要点完全依赖动态上下文注入获取提交历史无需任何参考文件是一个纯指令型 Skill 的典型。8.7 项目约定Claude 专属背景知识Claude 自动套用的背景知识SKILL.md:--- name: project-conventions description: Code style and patterns for this project. Apply when writing or reviewing code. user-invocable: false --- ## Naming Conventions - React components: PascalCase - Utilities: camelCase - Constants: UPPER_SNAKE_CASE - Files: kebab-case ## Patterns - Use ResultT, E for fallible operations, not exceptions - Prefer composition over inheritance - All API responses use { data, error, meta } shape ## Forbidden - No any types - No console.log in production code - No synchronous file I/O要点user-invocable: false使 Claude 在写代码/审查时自动应用这些约定用户无需手动调用。这与 Cherry Studio 内置 cherry-assistant-guide/SKILL.md 的定位一致——后者作为后台知识约束助手不凭记忆回答产品问题必须先读当前安装包清单。8.8 环境搭建前置脚本用脚本引导新开发者完成环境配置.claude/skills/setup-dev/ ├── SKILL.md └── scripts/ └── check-prerequisites.shSKILL.md:--- name: setup-dev description: Set up development environment for new contributors disable-model-invocation: true --- Set up development environment: 1. Check prerequisites: bash scripts/check-prerequisites.sh 2. Install dependencies: npm install 3. Copy environment template: cp .env.example .env 4. Set up database: npm run db:setup 5. Verify setup: npm test Report any issues encountered.要点把 onboarding 文档固化为可执行步骤序列新成员一条命令触发、逐步完成配置并反馈问题。九、Cherry Studio 中的 Skills 生态从内置 Skill 到市场安装9.1 内置 Skills 的加载与镜像Cherry Studio 将内置 Agent 的 Skills 直接打包在仓库的resources/builtin-agents/cherry-assistant/.claude/skills/下运行时由SkillService统一扫描管理。从源码看SkillService.ts用户级 Skills 位于userData/Data/Agents/.claude/skills内置项则作为应用持有的镜像出现系统还会执行完整性检查presence authored-skill change detection并清理已消失的非内置条目SkillService.ts。9.2 内置 Skill 实战skills-manager 的安装工作流skills-manager/SKILL.md 展示了 Cherry Studio 中安装与创建 Skill 的完整降级链路搜索优先调用find-skills不可用时降级为 CLI——npx skills find [query]备选$CHERRY_STUDIO_BUN_PATH x skills都没有则提示安装 Node.js安装npx skills add owner/reposkill -y位置为项目级.claude/skills/或用户级~/.claude/skills/创建优先调用内置skill-creator走完整的需求澄清、初始化、编辑、验证、迭代流程不可用时降级npx skills init skill-name并保持SKILL.md精简、按需补充scripts/、references/、assets/验证底线创建后至少验证 frontmatter、触发描述和一个真实用例验证失败则修正后重跑。9.3 内置 Skill 实战Skill 市场Marketplacecherry-skill-marketplace/SKILL.md 定义了市场搜索与安装的 MCP 协议式操作搜索mcp__skills__search_skills参数{ query: 1-3 个聚焦关键词 }安装mcp__skills__install_skill参数{ install_source: 搜索结果的原值 }其中install_source是不透明值必须逐字使用搜索结果返回的原值不得自行构造安全边界安装前说明 Skill 是第三方代码、会继承当前工具权限须取得用户明确同意删除/卸载需先通过产品清单导航到 Skills UI 并再次确认名称。9.4 内置 Skill 实战Claude 自动化推荐器本文档的宿主claude-automation-recommender是仓库内随附的推荐型 Skill其 SKILL.md 定义了跨 Hooks / Subagents / Skills / Plugins / MCP 五类的代码库自动化推荐流程并包含 Cherry Studio 特有的Phase 0 扫描确认门上游未含扫描前必须公布读取计划与 token 预算典型中型仓库约 20–40K tokens获得用户明确确认后才进入分析用户拒绝时可提供缩小范围、仅口头咨询或延后处理三种替代方案见 NOTICE.md。它在 Phase 2 的 Skills 推荐中直接引用本文档所在的 skills-reference.md并给出代码库信号 → 要创建的 Skill → 调用方式对照表代码库信号要创建的 Skill调用方式API 路由api-doc含 OpenAPI 模板用户 Claude数据库项目create-migration含校验脚本仅用户测试套件gen-test含示例测试仅用户组件库new-component含模板仅用户PR 工作流pr-check含清单仅用户发布release-notes含 git 上下文仅用户代码风格project-conventions仅 Claude新人 onboardingsetup-dev含前置脚本仅用户9.5 决策框架何时推荐哪种自动化Skill 并非万能应在合适场景推荐推荐 Skills 的场景频繁重复的提示词或工作流带参数的项目专属任务需要把模板或脚本应用到任务上Skill 可捆绑辅助文件通过/skill-name快速触发的动作需要在隔离环境运行的工作流context: fork。推荐 Hooks 的场景重复性的编辑后动作格式化、lint保护性规则阻止敏感文件被编辑校验检查测试、类型检查。对应参考见 hooks-patterns.md。推荐 Subagents 的场景需要专业能力安全、性能并行审查工作流后台质量检查。推荐 Plugins 的场景需要多个相关 Skill想要开箱即用的自动化捆绑包团队级标准化。推荐 MCP Servers 的场景需要外部服务集成数据库、API库/SDK 文档查询浏览器自动化或测试团队工具集成GitHub、Linear、Slack云基础设施管理。十、从参考文档到生产实践推荐输出格式当推荐器产出结论时遵循每类仅给 1–2 个最优推荐的输出纪律用户指定类型时给 3–5 个并采用结构化报告格式## Claude Code Automation Recommendations ### Codebase Profile - **Type**: [detected language/runtime] - **Framework**: [detected framework] - **Key Libraries**: [relevant libraries detected] ### Skills #### [skill name] **Why**: [specific reason] **Create**: .claude/skills/[name]/SKILL.md **Invocation**: User-only / Both / Claude-only **Also available in**: [plugin-name] plugin (if applicable)【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考