用途:在实现完成后,把散落在面包屑、ADR、规格与工单中的决策依据,整理到评审者会看的位置(PR 正文与内联评论),生成评审就绪的 PR。它不生成依据,来源为空时对应小节会被省略。
依赖:需要 docs/agents/ticket-tracker.md 与 docs/agents/decisions-breadcrumb.md;缺失时运行 /setup-formsg-ai-skills。
流程:先确定固定点,使用用户提供的 ref,否则用 main,采集 git diff <fixed-point>...HEAD 与 git log <fixed-point>..HEAD --oneline。再收集依据来源:面包屑 .scratch/<feature>/decisions.md(可选)、涉及 diff 路径的 docs/adr/ 文件、通过 ticket-tracker.md 从提交信息引用获取的规格/工单,否则用 .scratch/<feature>/SPEC.md,缺失时询问用户。随后按 TEMPLATE.md 组装 PR 正文,来源为空的小节省略;若 diff 涉及前端文件,按 SCREENSHOTS.md 处理截图。内联评论按类型各一条,格式为 inline breadcrumb: { file, line, body },格式错误(缺 file/line)的条目会提示用户。预览组装后的正文、内联评论列表与推送计划,等待明确批准。批准后执行:无上游时 git push -u origin <branch>,否则 git push;gh pr create --title "<title>" --body-file <tmp>;通过 gh api repos/{owner}/{repo}/pulls/{n}/comments 逐条发布内联评论;最后打印 PR URL。
适用场景:实现完成、准备提交评审的 PR。限制:不生成依据;依赖上述文档与工具;需用户批准后才推送与创建 PR。