用途:对指定时间范围内合入主分支的 GitCode PR 进行质量抽检,按多维度判断质量并输出表格,支持多仓库、可配置阈值与必选标签。
主要能力:8 项分析维度,包括评论未解决(diff 评论 resolved 为 false)、缺必选标签(required_labels 缺任一)、新增超行数(超过 max_additions,默认 1000)、无测试(变更路径均不含 test 或 ut)、多 Issue(关联 Issue 数大于 1)、缺检视(新增行数超过 review_lines_threshold 默认 500 且 diff 评论为 0)、标题/描述不清晰(标题短于 title_min_length 默认 5 或描述短于 body_min_length 默认 10,或明显含糊)。输出表格列含仓库、PR(#编号带链接)、标题、各维度详情与问题汇总。
使用方式:需至少一个仓库(owner/repo)。命令示例:python <SKILL_ROOT>/scripts/pr_audit.py --repo owner/repo [--pr N] [--branch BRANCH] [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--days N] [--all] [--output path.md|path.csv] [--config path]。未指定时间默认最近 30 天;未指定分支依次尝试 master、develop、main;未指定数量时每仓库随机抽 5~10 条,不足 5 条全部分析;--all 检查全部。指定 --pr 时仅检查这些 PR,需且仅需一个 --repo。stdout 始终输出 Markdown 表格,--output 可写 .md 或 .csv(UTF-8 带 BOM)。
认证:读取 GITCODE_TOKEN,优先级为进程环境变量、Windows 用户级、Windows 系统级;Linux/macOS 可在 ~/.bashrc 或 ~/.zshrc 中 export GITCODE_TOKEN="..."。未配置时脚本报错。
限制:禁止在未得到脚本输出前猜测或伪造数据;禁止在用户未提供至少一个 --repo 时执行脚本。支持 Linux/macOS/Windows,脚本通过 file 定位,使用绝对路径执行。配置文件默认位于技能根目录 config.json,字段含 required_labels、max_additions、review_lines_threshold、title_min_length、body_min_length、test_substrings。