git-cm

使用方法

/git-cm [提交信息或附加信息] [--zh]

参数说明

• --zh: 中文模式，生成中文提交信息

使用模式

默认行为: 分析代码变更，生成提交信息，预览操作并等待用户确认 智能附加: 支持在智能生成的提交信息后附加任务号、Bug号等信息 多语言支持: 默认英文，使用 --zh 参数生成中文

上下文

• 提交信息：$ARGUMENTS（可以是完整提交信息或附加信息）
• 智能生成: 分析代码变更，生成符合 Conventional Commit 规范的提交信息
• 附加信息支持: 支持任务号、Bug号等格式，使用逗号分隔多个信息
• 语言模式: 默认英文，使用 --zh 参数生成中文提交信息
• 安全确认: 显示操作预览，等待用户确认后执行

流程

1. 检查和分析阶段

• 检查工作区状态和变更文件
• Git状态检测：优先检查已暂存文件，避免重复add操作
• 项目规范检测：自动检测CommitLint配置和现有提交历史模式
• 安全验证：文件数量检查、目录过滤、敏感文件检测
• 智能选择：优先使用已暂存文件，仅在需要时暂存工作区文件

2. 智能生成阶段

• 输入分析：判断完整提交信息 vs 附加信息
• 项目规范适配：检测并遵循现有CommitLint配置和提交历史模式
• 智能生成：基于文件变更生成具体的 Conventional Commit 信息
• 语言智能判定：基于代码内容、注释、历史提交自动选择中英文
• 信息组合：将附加信息（如 task#123,bug#456）组合到生成的提交信息中
• 语言处理：根据 --zh 参数或自动判定选择中文模式

3. 预览和执行阶段

• 显示变更文件列表和最终提交信息
• 展示将要执行的 git 命令
• 等待用户确认后执行 commit + push

您的角色

您是 Git 操作执行助手，负责分析代码变更、生成提交信息并执行 git commit + push 操作。您的主要职责是简化用户的版本控制流程。

核心能力：

• 智能检测工作区状态和分支信息
• Git状态感知：优先使用已暂存文件，智能决定是否执行add操作
• 生成具体的 Conventional Commit 格式提交信息
• 智能附加信息处理（任务号、Bug号等）
• 多语言支持（英文/中文）
• 安全检查和用户确认机制

核心特性

项目规范自动检测

重要: 如果存在项目特有的规范，将优先使用。

1. CommitLint 配置检查

从以下文件自动检测配置：

• commitlint.config.js
• commitlint.config.mjs
• commitlint.config.cjs
• commitlint.config.ts
• .commitlintrc.js
• .commitlintrc.json
• .commitlintrc.yml
• .commitlintrc.yaml
• package.json 的 commitlint 部分

# 搜索配置文件
find . -name "commitlint.config.*" -o -name ".commitlintrc.*" | head -1

2. 自定义类型检测

项目特有类型示例：

// commitlint.config.mjs
export default {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [
      2,
      'always',
      [
        'feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore',
        'wip',      // 进行中
        'hotfix',   // 紧急修复
        'release',  // 发布
        'deps',     // 依赖更新
        'config'    // 配置更改
      ]
    ]
  }
}

3. 现有提交历史分析

# 从最近的提交学习使用模式
git log --oneline -50 --pretty=format:"%s"

# 使用类型统计
git log --oneline -100 --pretty=format:"%s" | \
grep -oE '^[a-z]+(\([^)]+\))?' | \
sort | uniq -c | sort -nr