$ git log --oneline -20

a3f2b1d feat: enhance user profile functionality and improve code organization
b4c2e3f fix: resolve issue with data processing pipeline
c5d4e3g refactor: optimize database query performance
d6e5f4h chore: update dependency versions
e7f6g5i feat: add new feature for user authentication module
f8g7h6j fix: correct bug in payment processing flow
g9h8i7k refactor: improve code structure and readability
h0i9j8l chore: update configuration files
i1j0k9m feat: implement changes to improve system reliability
j2k1l0n fix: address problem identified in recent testing

—— diff 告诉 AI 的：
  删除了什么文件
  添加了什么代码
  改了什么函数

—— diff 没有告诉 AI 的：
  为什么要改这个
  为什么选择这个方案而不是另一个
  这个改动的风险是什么
  要不要做特殊的部署操作

AI 写的: "refactor: optimize database query performance"

实际情况: 
花了 3 小时把一个 100ms 的查询优化到了 15ms，
但把另一个不相关的模块搞坏了，
第二天又花 2 小时修。

AI 写的: "fix: correct bug in data validation logic"

实际情况:
删了一行 lint warning 的注释，完全没改 data validation。

AI 写的: "feat: implement changes to improve user experience"

实际情况:
改了 12 个文件，包括：
- 3 个真正的前端 UI 改进
- 4 个重构的常量名
- 2 个误改的错误文件
- 3 个格式化工具自动改的

❌ "feat: add new feature for user authentication module"
—— 用了正确的前缀，但信息量为零

✅ "feat(auth): add email+password login with bcrypt hashing

Why: 用户反馈只支持 SSO 登录不够灵活，
     有些小团队没有自己的 SSO 系统。

Risk: 新的登录方式需要额外的安全审查。
      密码重置流程在设计中（下一步任务 #142）。

Migration: 不需要，新功能和现有 SSO 登录并行运行。
"

<type>(<scope>): <short description>

Why: <为什么需要这个改动，而不是具体改了什么>

What: <改了哪里，目录级别即可>

Risk: <这个改动的潜在影响>
- <如果有需要注意的地方写在这里>

# 使用模板的示例
$ git commit -m "fix(cart): prevent negative quantity when user spams button

Why: 用户快速点击减号按钮时，quantity 会变成负数
    导致结算模块解析失败，返回 500 错误。
    原因是减操作的防抖没覆盖到并发请求。

What: cart_controller.rb 中 quantity 变更的原子性检查
    前端按钮的防抖间隔从 200ms 改为 500ms

Risk: 
- 快速操作的用户可能会觉得响应变慢（500ms 间隔）
- 已和 PM 确认可以接受
"

#!/bin/bash
# 
# ai-commit.sh - 生成更好的 AI commit message
# 用法: ai-commit.sh <branch-name>

BRANCH_NAME="${1:-$(git rev-parse --abbrev-ref HEAD)}"
DIFF_CONTENT=$(git diff --cached | head -2000)
CHANGED_FILES=$(git diff --cached --name-only)
GIT_LOG=$(git log --oneline -10)
STATS=$(git diff --cached --stat)

# 获取相关 issue 信息（如果有）
ISSUE_NUMBER=$(echo "$BRANCH_NAME" | grep -oE '[0-9]+' | head -1)

# 构建 prompt
PROMPT=$(cat <<EOF
你是一个 commit message 生成器。给定以下信息，生成 commit message。

分支名: $BRANCH_NAME

变更文件:
$CHANGED_FILES

变更统计:
$STATS

最近的 commit:
$GIT_LOG

$([ -n "$ISSUE_NUMBER" ] && echo "关联 Issue: #$ISSUE_NUMBER")

变更内容 (diff):
$DIFF_CONTENT

请生成 commit message。要求：
1. 格式: <type>(<scope>): <描述>
2. 必须有 Why 和 Risk 两部分
3. Why: 说明为什么要做这个改动（从 diff 推断）
4. Risk: 说明这个改动有什么风险或注意事项
5. 不要虚构信息。如果不知道 Why，就写"无法从 diff 中推断"
6. 不要用"enhance/improve/optimize"这种空洞的词
7. 用具体的函数名/文件名描述改动
EOF
)

# 调用 AI API（这里用 Claude API 为例）
curl -s https://api.anthropic.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -d "{
    \"model\": \"claude-sonnet-4-20250514\",
    \"messages\": [{\"role\": \"user\", \"content\": \"$PROMPT\"}],
    \"max_tokens\": 500
  }" | jq -r '.content[0].text'

#!/bin/bash
# 
# verified-commit.sh - 生成 commit message + 人工确认

GENERATED_MSG=$(ai-commit.sh)

echo "===== AI 生成的 commit message ====="
echo "$GENERATED_MSG"
echo ""
echo "====================================="
echo ""
echo "你要用这个 commit message 吗？"
echo "y) 直接用"
echo "e) 编辑后再用"
echo "n) 不用，我自己写"
echo ""

read -r choice

case "$choice" in
  y|Y)
    echo "$GENERATED_MSG" > /tmp/commit_msg.txt
    git commit -F /tmp/commit_msg.txt
    ;;
  e|E)
    echo "$GENERATED_MSG" > /tmp/commit_msg.txt
    ${EDITOR:-vim} /tmp/commit_msg.txt
    git commit -F /tmp/commit_msg.txt
    ;;
  *)
    git commit
    ;;
esac

#!/usr/bin/env python3
"""
smart-commit.py - 智能 commit message 生成器

根据变更类型使用不同的 prompt 模板，
避免 AI 生成"通用废话"
"""

import subprocess
import json
from typing import Dict, List

# 不同变更类型的 prompt 模板
PROMPT_TEMPLATES = {
    "bugfix": """
你分析一个 bug fix 的 git diff。请生成 commit message。

重点关注：
1. bug 的具体表现（从 diff 推断）
2. root cause 是什么
3. 为什么用这个方式修复
4. 是否有回归风险

不要写：
- "修复了一个问题"（太笼统）
- "优化了代码"（如果是 bug fix 那就不是优化）

请用以下格式：
fix(<scope>): <描述>

Why: <bug 表现 + root cause>
Fix: <具体如何修复的>
Risk: <回归风险>
""",

    "feature": """
你分析一个新功能的 git diff。请生成 commit message。

重点关注：
1. 新功能解决什么需求
2. 涉及哪些模块/文件
3. 有没有破坏性变更

不要编造"用户反馈"之类的话。如果不确定需求背景，写"从代码推断"。

请用以下格式：
feat(<scope>): <描述>

Why: <从代码推测的需求背景>
What: <新增/改了哪些关键文件>
Breaking: <如果有破坏性变更写在这里，没有就不写>
""",

    "refactor": """
你分析代码重构的 git diff。请生成 commit message。

重点区分：
1. 纯重构（功能不变）：写清楚重构了什么、为什么
2. 重构 + 小功能变化：两者都要写
3. 如果看起来是重构但其实是 bug fix：纠正分类

请用以下格式：
refactor(<scope>): <描述>

Why: <重构动机，如可维护性/性能/准备新功能>
Key Changes: <主要变化点>
Behavior Change: <如果功能行为有变化写在这里>
""",
}

def classify_diff(files: List[str], diff_stats: str) -> str:
    """根据变更内容分类”""

    # 简单的启发式分类
    bugfix_keywords = ["bug", "fix", "error", "crash", "null", "undefined", "broken", "incorrect"]
    test_keywords = ["test", "spec"]

    all_text = " ".join(files) + " " + diff_stats

    if any(kw in all_text.lower() for kw in bugfix_keywords):
        return "bugfix"
    elif any(kw in all_text.lower() for kw in test_keywords):
        return "test"
    else:
        return "feature"


def get_git_diff() -> Dict:
    """获取 git diff 信息"""

    files = subprocess.check_output(
        ["git", "diff", "--cached", "--name-only"]
    ).decode().strip().split("\n")

    diff_content = subprocess.check_output(
        ["git", "diff", "--cached"]
    ).decode()[:3000]

    stats = subprocess.check_output(
        ["git", "diff", "--cached", "--stat"]
    ).decode().strip()

    return {
        "files": [f for f in files if f],
        "diff": diff_content,
        "stats": stats,
    }


def build_prompt(diff_info: Dict, change_type: str) -> str:
    """构建 prompt"""

    template = PROMPT_TEMPLATES.get(change_type, PROMPT_TEMPLATES["feature"])

    return f"""
变更文件:
{chr(10).join(diff_info['files'])}

变更统计:
{diff_info['stats']}

变更内容 (前 3000 字符):
{diff_info['diff']}

---
{template}
"""


# 主函数
if __name__ == "__main__":
    diff_info = get_git_diff()
    change_type = classify_diff(diff_info["files"], diff_info["stats"])

    prompt = build_prompt(diff_info, change_type)

    # 输出 prompt（实际使用时会调用 AI API）
    print(f"变更类型: {change_type}")
    print("=" * 50)
    print(prompt)

fix: correct bug in data processing pipeline

fix(pipeline): handle nil UserSession in DataProcessor.process

Why: 用户在某些场景下没有 UserSession 对象
    （API token 认证的场景），但 DataProcessor 假设
    它始终存在，导致 SystemStackError。

    bug 日志: https://sentry.io/xxx/yyy

Fix: DataProcessor#process 中加入 nil check，
    如果 UserSession 不存在则跳过 session 相关处理

Risk: 低。跳过 session 处理不影响核心数据流程。
    已添加测试覆盖 nil session 的场景。

# ~/.gitconfig
[alias]
    # 快速描述：让 AI 描述改了什么（不含 why/risk）
    describe = !git diff --cached | head -2000 | xargs -0 sh -c 'ai-commit-summary "$@"'

    # 完整模板：生成模板后自动打开编辑器
    commit-ai = !ai-commit --edit

    # 只生成 scope 和 type 建议
    suggest-type = !python3 -c "
import subprocess
files = subprocess.check_output(['git', 'diff', '--cached', '--name-only']).decode()
if 'test' in files: print('test')
elif 'config' in files: print('chore')
elif 'spec' in files: print('test')
else: print('feat or fix - check yourself')
"