文章目录第五章常用 Skill 推荐与最佳实践5.1 推荐 Skill 清单5.2 Skill 最佳实践5.3 Skill 版本管理5.4 Skill 性能优化第五章常用 Skill 推荐与最佳实践5.1 推荐 Skill 清单开发效率类# 代码审查 Skill (code-review.md) # 功能自动审查代码检查常见错误、性能问题、安全漏洞 # 触发审查这段代码、code review# 测试生成 Skill (test-generation.md) # 功能为函数生成单元测试 # 触发写测试、生成测试用例# 文档生成 Skill (doc-generation.md) # 功能根据代码生成 API 文档 # 触发生成文档、写文档代码质量类# 重构建议 Skill (refactor-suggestion.md) # 功能分析代码坏味道给出重构建议 # 触发重构、优化代码# 性能分析 Skill (performance-analysis.md) # 功能找出性能瓶颈 # 触发优化性能、为什么慢项目管理类# Commit 规范 Skill (commit-convention.md) # 功能生成符合 Conventional Commits 规范的提交信息 # 触发写 commit、提交信息# PR 描述生成 Skill (pr-description.md) # 功能根据分支改动生成 PR 描述 # 触发写 PR、生成描述5.2 Skill 最佳实践DO推荐做✅保持单一职责一个 Skill 只做一件事✅示例驱动每个 Skill 至少包含 2 个示例✅步骤可执行每条执行步骤都是具体动作不是抽象描述✅版本管理Skill 和代码一起纳入 Git 管理✅定期迭代根据使用效果不断优化 SkillDON’T避免做❌过于复杂一个 Skill 超过 20 步拆分成多个❌没有示例只写描述不给示例❌步骤模糊写分析代码而不是检查函数是否有 docstring❌硬编码路径使用相对路径或配置变量❌忽略错误处理不考虑失败情况5.3 Skill 版本管理# Skill 和项目代码一起提交gitadd.claude/skills/gitcommit-mfeat: 添加代码审查 Skill# 为 Skill 打标签gittag skill-v1.0# 团队共享 Skill# 把 .claude/skills/ 加入仓库团队成员自动获得相同 Skill5.4 Skill 性能优化# 优化前每次加载大量文件 ## 执行步骤 1. 读取整个 src/ 目录 2. 分析所有文件 3. 生成报告 # 优化后按需加载 ## 执行步骤 1. 询问用户具体要分析的文件 2. 只读取相关文件 3. 生成报告