用途：把当前分支的 GitHub PR 元数据规范化到仓库预期格式，标题保持 conventional-commit 风格，正文对齐 .github/pull_request_template.md，并在交付前校验。
主要能力：解析当前分支 PR；对比 PR 基分支检查真实差异；校验标题与正文；按需打印干净的模板骨架；重写标题与正文；用 gh 更新 PR；再次校验并报告是否合规。
使用方式：先查看 PR：gh pr view --json number,title,body,url,headRefName,baseRefName。再检查分支状态：git diff --name-status origin/<base>...HEAD、git diff --stat origin/<base>...HEAD、git log --oneline --decorate --no-merges origin/<base>..HEAD。校验：python3 .codex/skills/gh-pr-metadata/scripts/validate_pr_metadata.py；打印模板：python3 .codex/skills/gh-pr-metadata/scripts/validate_pr_metadata.py --print-template。更新：gh pr edit --title "<new-title>" --body-file /tmp/pr-body.md。
标题规则：优先 type(scope): summary，简短直接，使用 fix、feat、docs、refactor、chore、test、ci、build、perf、revert 等类型，不加 [codex] 之类前缀，标题须描述当前分支差异。正文保留模板结构：## Description、## Related Issue、## Types of changes、## Checklist；只勾选实际适用项，保留全部清单项，不因 PR 小而删必需章节。
适用场景：分支经过 rebase、回退或范围收窄后，PR 标题/正文与当前差异不一致时。
限制：需本地有 gh 与 Python 3 环境；脚本路径为 .codex/skills/gh-pr-metadata/scripts/validate_pr_metadata.py；具体仓库模板细节需查阅 references/repo-pr-format.md。