用途:为外部仓库(开源贡献)准备 PR 提交与正文,不用于常规内部提交或直接推主干的发布流程。折叠的 pr-research 触发会进入上游调研模式,先做已有工作发现、贡献指南分析、已合并 PR 考古与维护者模式研究,结果保存到 .agents/research/YYYY-MM-DD-upstream-<slug>.md。
主要能力:检查开放与已合并的 issue/PR 及默认分支,避免重复工作;阅读目标仓库的 AGENTS.md、CONTRIBUTING.md、PR 模板、发布说明与近期被合并的 PR,以对齐上游约定;检查分支隔离性,列出变更文件与提交并按行为归组;运行仓库规定的格式化、lint、构建与测试命令,记录命令、退出状态与结果;分析提交并提出拆分建议(差异小于 50 行且四个文件以内建议单一提交,否则参考 commit-split-advisor.md);生成 PR 草稿到 .agents/pr-prep/YYYY-MM-DD-<slug>.md,按上游模板写出标题、上游/基准、关联 issue、摘要、变更列表、测试计划、兼容与回滚说明及风险。
使用方式:输入为目标仓库、当前贡献分支,可选 issue 和请求的 base/remote。在请求批准前运行 bash skills/pr-prep/scripts/validate.sh、仓库规定的检查、git diff --check 及适用的密钥扫描。草稿需经强制用户评审检查点,确认标题、正文、base、remote、分支与验证结果。仅在上线批准后运行 gh pr create --title <approved-title> --body-file <approved-file> --base <approved-base>,并报告生成的 URL。
限制:准备阶段只写本地工件,不授权发布、重写历史或联系维护者;提交拆分仅为建议,除非用户另行授权重写;检查未通过不得标记为完成,失败或未运行的检查须在草稿中保持可见;若存在竞争性 PR 需停止并等待用户决定;沉默或此前推送授权不构成创建本 PR 的批准;HEAD 变动后需重新生成证据并再次请求批准。