ccg-workflow/templates/commands/commit.md

description

description
智能 Git 提交：分析改动生成 Conventional Commit 信息，支持拆分建议

Commit - 智能 Git 提交

分析当前改动，生成 Conventional Commits 风格的提交信息。

使用方法

/commit [options]

选项

选项	说明
--no-verify	跳过 Git 钩子
--all	暂存所有改动
--amend	修补上次提交
--signoff	附加签名
--emoji	包含 emoji 前缀
--scope <scope>	指定作用域
--type <type>	指定提交类型

---

执行工作流

🔍 阶段 1：仓库校验

[模式：检查]

1. 验证 Git 仓库状态
2. 检测 rebase/merge 冲突
3. 读取当前分支/HEAD 状态

📋 阶段 2：改动检测

[模式：分析]

1. 获取已暂存与未暂存改动
2. 若暂存区为空：
   • --all → 执行 git add -A
   • 否则提示选择

✂️ 阶段 3：拆分建议

[模式：建议]

按以下维度聚类：

• 关注点（源代码 vs 文档/测试）
• 文件模式（不同目录/包）
• 改动类型（新增 vs 删除）

若检测到多组独立变更（>300 行 / 跨多个顶级目录），建议拆分。

✍️ 阶段 4：生成提交信息

[模式：生成]

格式：[emoji] <type>(<scope>): <subject>

• 首行 ≤ 72 字符
• 祈使语气
• 消息体：动机、实现要点、影响范围

语言：根据最近 50 次提交判断中文/英文

📦 阶段 5：Context 自动归档（若 .context/ 存在）

[模式：上下文归档]

前置判断：

• 若 .context/ 目录不存在 → 在提交成功后输出提示：💡 建议执行 /ccg:context init 启用决策追踪，不阻断
• 若 .context/ 存在 → 执行以下步骤

从 git diff 自动生成 ContextEntry：

1. 获取当前分支名：git branch --show-current
2. 获取暂存区变更：git diff --cached --stat + git diff --cached（完整 diff）
3. 分析 diff 生成 ContextEntry：
   • summary：从阶段 4 生成的 commit message 中取首行
   • decisions：分析 diff 中的关键变更（新增依赖、架构调整、接口变更、配置修改），推断决策理由
   • bugs：若 commit type 为 fix，从 diff 中提取 bug 症状、根因、修复方式
   • changes.files：从 git diff --cached --name-only 提取
   • tests：若变更包含测试文件，记录测试相关信息
4. 合并 session.log（可选）：若 .context/current/branches/<branch>/session.log 存在且非空，将其中的手动记录合并到 decisions/bugs 中，然后清空 session.log
5. 脱敏：扫描 token/key/password/secret 模式 → 替换为 [REDACTED]
6. 追加：将 ContextEntry 作为一行追加到 .context/history/commits.jsonl
7. 重生成：更新 .context/history/commits.md 人类视图
8. 暂存：git add .context/history/
9. Trailer：在 commit message 中添加 Context-Id: <uuid> trailer

ContextEntry 格式参见 /ccg:context 命令中的 Schema 定义。

失败降级：若归档过程出错，不阻断提交。写入 minimal ContextEntry（仅 summary + files），继续正常提交。

✅ 阶段 6：执行提交

[模式：执行]

git commit [-S] [--no-verify] [-s] -F .git/COMMIT_EDITMSG

---

Type 与 Emoji 映射

Emoji	Type	说明
✨	feat	新增功能
🐛	fix	缺陷修复
📝	docs	文档更新
🎨	style	代码格式
♻️	refactor	重构
⚡️	perf	性能优化
✅	test	测试相关
🔧	chore	构建/工具
👷	ci	CI/CD
⏪️	revert	回滚

---

示例

# 基本提交
/commit

# 暂存所有并提交
/commit --all

# 带 emoji 提交
/commit --emoji

# 指定类型和作用域
/commit --scope ui --type feat --emoji

# 修补上次提交
/commit --amend --signoff

关键规则

1. 仅使用 Git – 不调用包管理器
2. 尊重钩子 – 默认执行，--no-verify 可跳过
3. 不改源码 – 只读写 .git/COMMIT_EDITMSG
4. 原子提交 – 一次提交只做一件事