文章目录
-
- 第五章：常用 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 管理 ✅ 定期迭代：根据使用效果不断优化 Skill
DON’T（避免做）：
❌ 过于复杂：一个 Skill 超过 20 步，拆分成多个 ❌ 没有示例：只写描述，不给示例 ❌ 步骤模糊：写"分析代码"而不是"检查函数是否有 docstring" ❌ 硬编码路径：使用相对路径或配置变量 ❌ 忽略错误处理：不考虑失败情况
5.3 Skill 版本管理
# Skill 和项目代码一起提交
git add .claude/skills/
git commit -m "feat: 添加代码审查 Skill"
# 为 Skill 打标签
git tag skill-v1.0
# 团队共享 Skill
# 把 .claude/skills/ 加入仓库，团队成员自动获得相同 Skill
5.4 Skill 性能优化
# 优化前（每次加载大量文件）
## 执行步骤
1. 读取整个 src/ 目录
2. 分析所有文件
3. 生成报告
# 优化后（按需加载）
## 执行步骤
1. 询问用户具体要分析的文件
2. 只读取相关文件
3. 生成报告
