tzuchaine avatar

commit-helper

Intelligently analyze code changes and split them into multiple logical commits based on functionali

提供方 tzuchaine|开源

Commit Helper Skill

智能代码提交助手 - 自动分析代码变更并拆分为多个逻辑提交

功能特性

  • 🧠 智能分析:自动分析代码变更,识别功能关联和变更类型
  • 📦 自动分组:按功能和类型将变更拆分为多个原子提交
  • 📝 规范提交:生成符合 Conventional Commits 规范的提交信息
  • 质量检查:提交前自动运行 linter 和类型检查
  • 👤 用户控制:展示计划并等待用户确认后再执行

使用方法

通过自然语言使用:

请帮我提交代码
提交我的更改
智能提交代码

工作流程

  1. 分析变更:扫描所有修改的文件
  2. 智能分组:将相关文件归为一个提交
  3. 生成消息:为每个提交生成规范的 commit message
  4. 展示计划:向你展示完整的提交计划
  5. 等待确认:等待你批准后再继续
  6. 质量检查:运行 linter 和类型检查
  7. 执行提交:按顺序创建多个提交
  8. 显示总结:展示所有创建的提交

提交信息规范

采用 Conventional Commits 规范:

type(scope): 简短描述

详细说明为什么做这个变更,解决了什么问题。

支持的提交类型

  • feat: 新功能
  • fix: Bug 修复
  • refactor: 重构
  • docs: 文档更新
  • test: 测试相关
  • chore: 维护任务
  • perf: 性能优化
  • style: 代码格式
  • ci: CI/CD 配置

示例输出

🔍 分析了 8 个文件的变更

💡 建议的提交计划(3 个提交):

【提交 1/3】feat(auth): 实现用户登录系统
  文件:
  ├─ src/auth/login.ts
  ├─ src/auth/middleware.ts
  └─ tests/auth.test.ts

【提交 2/3】fix(validation): 修正邮箱验证
  文件:
  └─ src/utils/validation.ts

【提交 3/3】docs(readme): 更新文档
  文件:
  └─ README.md

✅ 成功创建 3 个提交

注意事项

  • ✅ 仅创建本地提交,不会自动 push
  • ✅ 所有操作都需要用户确认
  • ✅ 代码检查失败时会询问用户意见
  • ✅ 每个提交都是独立的、可构建的

适用场景

  • 一次性修改了多个不相关的文件
  • 需要保持提交历史清晰
  • 遵循团队的提交规范要求
  • 希望自动化提交消息生成
commit-helper - 适用于 Claude Code 与 Cursor 的 AI 智能体 Skill | Agent Skills