用途:以一致方式创建 Azure DevOps 拉取请求(PR),同时落实仓库对线性历史的偏好。优先使用仓库封装脚本 scripts/pr-azdo.sh,以减少 Maintainer 审批中断(单次终端调用)。
主要能力:生成规范的 PR 标题与描述并完成创建;支持放弃测试 PR 进行清理。
使用方式:创建前必须在聊天中给出精确的 PR 标题和描述,描述使用 Problem / Change / Verification 模板。推荐单命令封装:scripts/pr-azdo.sh create --title "<type(scope): summary>" --description "<why + what + testing notes>";放弃测试 PR:scripts/pr-azdo.sh abandon --id <pr-id>。
预检:git branch --show-current 与 git status --short。推送分支:git push -u origin HEAD。创建 PR:az repos pr create --title "<type(scope): summary>" --description "<why + what + testing notes>" --source-branch "$(git branch --show-current)" --target-branch main,并按目标仓库设置 --organization/--project。
合并策略:CONTRIBUTING.md 规定该仓库要求使用 Rebase and merge。Azure DevOps 的合并选项因项目设置而异,合并时应选择最接近 rebase/线性历史的选项(常称为 Rebase and fast-forward);若不可用,需询问 Maintainer 采用何种方式。
硬性规则:必须在非 main 分支工作;创建 PR 前工作树必须干净;创建 PR 前先推送分支;标题与描述保持规范、便于评审;创建前在聊天中贴出精确标题与描述;使用标准描述模板。禁止使用会引入合并提交的策略,除非 Maintainer 明确要求。