第五章：常用 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 管理
✅定期迭代：根据使用效果不断优化 Skill

DON’T（避免做）：

❌过于复杂：一个 Skill 超过 20 步，拆分成多个
❌没有示例：只写描述，不给示例
❌步骤模糊：写"分析代码"而不是"检查函数是否有 docstring"
❌硬编码路径：使用相对路径或配置变量
❌忽略错误处理：不考虑失败情况

5.3 Skill 版本管理

# Skill 和项目代码一起提交gitadd.claude/skills/gitcommit-m"feat: 添加代码审查 Skill"# 为 Skill 打标签gittag skill-v1.0# 团队共享 Skill# 把 .claude/skills/ 加入仓库，团队成员自动获得相同 Skill

5.4 Skill 性能优化

# 优化前（每次加载大量文件） ## 执行步骤 1. 读取整个 src/ 目录 2. 分析所有文件 3. 生成报告 # 优化后（按需加载） ## 执行步骤 1. 询问用户具体要分析的文件 2. 只读取相关文件 3. 生成报告