gh-junjiangao-ccode-plugins-ccode-skills/git-commit

Git Commit 技能

智能化的 Git 提交助手，帮助你快速完成代码审查、生成规范的提交信息并执行提交。

🚀 快速开始

基本使用

你: "帮我提交这些代码"

技能会自动：

1. ✅ 检查暂存区状态
2. 🔍 简单代码审查
3. 📊 分析提交历史
4. 📝 生成提交信息
5. ✋ 等待你确认
6. 🎉 执行提交

使用场景

场景 1：暂存区已有文件

# 你已经执行了 git add
git add src/main.rs src/config.rs

# 直接请求提交
你: "提交代码"

技能会直接使用暂存区的文件进行提交。

场景 2：暂存区为空

你: "提交我的修改"

技能会：

1. 列出所有修改的文件
2. 询问你要提交哪些文件
3. 自动执行 git add
4. 继续提交流程

场景 3：审查并提交

你: "审查代码并提交"

技能会进行简单的代码审查，检查：

• 语法错误
• 调试代码残留
• 敏感信息泄露

📝 提交信息格式

自动识别项目规范

技能会从以下来源识别项目的提交规范：

1. Memory 中的项目规范（优先级最高）
2. 提交历史中的风格模式
3. 通用简洁格式（默认）

配置项目规范

如果你的项目有特定的提交规范，可以在 Memory 中记录：

你: "记录项目提交规范：使用 Conventional Commits 格式，type 包括 feat、fix、docs、refactor、test、chore"

技能会自动保存到 Memory，后续提交时遵循该规范。

🎯 典型工作流

完整示例

你: "提交代码"

技能:
📊 检查到暂存区为空，发现以下修改：
  1. src/main.rs (修改)
  2. src/config.rs (修改)
  3. tests/test_config.rs (新增)
  4. README.md (修改)

请选择要提交的文件：
  [ ] 提交所有文件
  [ ] 选择特定文件
  [ ] 取消

你: "提交所有文件"

技能:
✅ 已添加 4 个文件到暂存区

🔍 代码审查中...
✅ 未发现明显问题

📊 变更摘要：
  - 修改文件：4 个
  - 新增行：+127
  - 删除行：-23

📝 提交信息：
  feat(config): 添加 TOML 配置支持

  - 实现 TOML 配置读取
  - 添加配置文件解析
  - 更新测试用例
  - 完善文档说明

是否确认提交？

你: "确认"

技能:
✅ 提交成功！
  commit: a1b2c3d feat(config): 添加 TOML 配置支持

⚙️ 高级功能

历史分析

技能会分析最近 20 条提交记录，学习项目的提交风格：

• 常用的 type 类型
• scope 的命名习惯
• 提交信息的语言（中文/英文）
• 描述的详细程度

智能暂存区处理

• 暂存区非空：直接使用，快速提交
• 暂存区为空：智能询问，避免误操作

提交前确认

每次提交前都会展示：

• 变更文件列表和统计
• 生成的提交信息
• 代码审查结果

你可以：

• 确认提交
• 修改提交信息
• 取消提交

🛠️ 配置示例

Conventional Commits 规范

你: "配置提交规范"

技能: "请描述你的提交规范"

你: "使用 Conventional Commits：
- type: feat, fix, docs, refactor, test, chore
- 格式: type(scope): subject
- subject 使用中文
- 可选的详细正文"

技能: "✅ 已保存到项目 Memory"

自定义规范

你: "我们团队的提交格式是：[模块名] 简短描述"

技能: "✅ 已记录，后续提交将遵循该格式"

💡 最佳实践

✅ 推荐做法

1. 原子提交：每次只提交一个逻辑变更
2. 及时提交：完成功能点后立即提交
3. 清晰描述：让他人快速理解变更目的
4. 遵循规范：保持项目风格一致

❌ 避免事项

1. 混合变更：不要在一次提交中包含多个不相关修改
2. 模糊描述：避免 "update code"、"fix bug" 等无意义信息
3. 跳过审查：即使小改动也应快速检查
4. 提交敏感信息：检查是否包含密钥、令牌

🔗 相关资源

• 详细工作流程：查看 SKILL.md
• 提交规范参考：查看 REFERENCE.md
• Conventional Commits 规范