PR 描述生成器

基于 git 差异（diff）和提交历史，自动生成结构化的 PR 描述。纯 Python 实现，依赖 git CLI。

快速开始

# 标准描述（当前分支与 main 的对比）
python3 scripts/generate_pr_description.py

# 与指定基线分支对比
python3 scripts/generate_pr_description.py --base develop

# 极简模板（仅项目符号列表）
python3 scripts/generate_pr_description.py --template minimal

# 详细模板（含文件分类 + 审阅者提示）
python3 scripts/generate_pr_description.py --template detailed

# JSON 输出（适用于自动化流程）
python3 scripts/generate_pr_description.py --format json

# 指定其他仓库路径
python3 scripts/generate_pr_description.py --repo /path/to/repo

# 保存至文件
python3 scripts/generate_pr_description.py --output pr-body.md

# 复制到剪贴板
python3 scripts/generate_pr_description.py --copy

特性

• 约定式提交解析 —— 按类型（feat、fix、refactor 等）对提交进行分组
• 影响分析 —— 基于修改的文件、变更规模及风险等级，将变更评级为高/中/低
• 文件归类 —— 按代码、测试、文档、基础设施、依赖、配置、数据库、样式等类别组织文件
• 审阅者提示 —— 对缺失测试、数据库迁移、基础设施变更、文件删除等情况发出警告
• 自动测试计划 —— 根据已更改文件类型，生成对应的测试检查清单
• 自动基线分支检测 —— 自动识别 main 或 master 分支作为默认基线

模板

约定式提交（Conventional Commits）

当提交信息遵循约定式格式时，效果最佳：

feat(auth): add OAuth2 login
fix(api): handle null response from payment gateway
refactor: extract validation into shared utility
docs: update API reference for v2 endpoints

不符合约定式格式的提交将统一归入“其他变更”类别。