luzhenqian/ai-coding-lab/commit-msg

digraph commit_flow {
    rankdir=TB;
    "用户调用 /commit-msg" [shape=doublecircle];
    "读取 git diff --staged" [shape=box];
    "有暂存变更？" [shape=diamond];
    "提示用户先 git add" [shape=box];
    "分析变更内容" [shape=box];
    "变更是否过大？" [shape=diamond];
    "建议拆分提交" [shape=box];
    "判断变更类型" [shape=box];
    "生成 commit message" [shape=box];
    "展示给用户确认" [shape=doublecircle];
 
    "用户调用 /commit-msg" -> "读取 git diff --staged";
    "读取 git diff --staged" -> "有暂存变更？";
    "有暂存变更？" -> "提示用户先 git add" [label="否"];
    "有暂存变更？" -> "分析变更内容" [label="是"];
    "分析变更内容" -> "变更是否过大？";
    "变更是否过大？" -> "建议拆分提交" [label="超过5个文件\n或300行"];
    "变更是否过大？" -> "判断变更类型" [label="合理范围"];
    "建议拆分提交" -> "判断变更类型";
    "判断变更类型" -> "生成 commit message";
    "生成 commit message" -> "展示给用户确认";
}

# 查看暂存的文件列表
git diff --staged --name-status
 
# 查看暂存的具体变更
git diff --staged
 
# 查看最近 5 条 commit（参考风格）
git log --oneline -5

<type>(<scope>): <subject>
 
<body>
 
<footer>

📋 变更摘要：
- 修改了 3 个文件，新增 45 行，删除 12 行
- 主要变更：用户认证模块
 
📝 建议的 Commit Message：
 
feat(auth): add JWT token refresh mechanism
 
Implement automatic token refresh to prevent session expiration
during active use. Refresh triggers when token has less than
5 minutes remaining.
 
Closes #234
 
---
确认使用此消息提交？(Y/n)

# ❌ 类型不对
update: 修改了用户模块        # "update" 不是标准类型
 
# ❌ subject 太长
feat: 添加了用户注册功能包括邮箱验证手机验证以及第三方登录支持
 
# ❌ 描述"做了什么"而非"为什么"
fix: changed line 42 in auth.js
 
# ✅ 正确示例
feat(auth): add email verification for user registration
 
Enable email verification during signup to reduce fake accounts.
Users receive a 6-digit code valid for 15 minutes.
 
Closes #189