conn-castle/agent-outbox

ship-pr

调用此技能授权创建分支、暂存、提交、推送、PR 创建或更新以及合并所需的有资格评论回复。它本身不授权合并操作。

如果存在 references/repo-specific-pr-policy.md，在开始工作流之前阅读它，并将其视为权威指南。

输入

需要 pr_worker 调度目标，每次调度使用 /dispatch-agent。将所有额外的调用者输入中继到每个 pr_worker 提示中。

除非用户缩小范围，否则包含整个当前工作树。

工作流

1. 当仓库规范要求时创建一个分支。提交预期更改，推送并创建或重用 PR。从更改中推导其标题并填充 assets/pr-body-template.md，移除未使用的部分和占位符。

2. 在托管的后台会话中启动一个观察器。保持运行直到 PR 合并或工作流停止，然后停止它。如果因临时传输故障而退出，重新获取权威状态并以相同的追加日志重启它。

   bash <skill_dir>/scripts/watch-pr-events.sh \
     --repo <owner/name> \
     --pr <pr-number> \
     --log-file .agent-layer/tmp/ship-pr-events-<pr-number>.jsonl \
     --interval-seconds 300
   

3. 使用 gh 获取当前 head、检查状态和可合并性。使用无状态命令读取评论；绝不要从观察器日志推断当前状态：

   bash <skill_dir>/scripts/read-pr-comments.sh \
     --repo <owner/name> \
     --pr <pr-number>
   

   针对未解决的反馈调度 pr_worker，提供精确的 PR、head 和 references/address-pr-comments.md；对于失败的必需检查，还需提供其证据和 references/fix-ci.md。该 worker 编辑本地树，但不提交、推送或发布回复。自动解决机械冲突。

   仅当以下条件全部满足时，PR 才准备好合并：

   • PR 在其最新 head 处可合并。
   • 至少一个代理或人工审阅者已以正式审查或评论形式提供反馈。
   • 每个必需的检查和仓库门控均为绿色。
   • 每条有资格评论都有经过验证的回复。
   • 如果可选的仓库策略存在，则满足其定义的每个合并标准。

   如果 PR 创建后 10 分钟内没有代理或人工审阅者发布反馈，停止并报告未收到反馈。如果准备就绪，继续执行步骤 5。否则，先处理完整可操作轮次再提交。

4. 提交并推送接受的修复。逐个发布每个 worker 提议的支持回复：对内联评论进行原生回复；对于对话评论或审查摘要，发布问题评论并链接来源。重新运行评论命令并纠正任何缺失或不支持的回复。返回步骤 3 直到准备就绪。如果只有检查或审查待处理，等待观察器。

5. 请求针对精确 PR 和 head 的单次使用合并授权。报告任何实质性发现、简洁的评论处置摘要以及准备就绪证据。

6. 授权后，重新获取 head、检查状态、可合并性和评论。确认本地树完整且每条有资格评论都发布了支持的回复。如果发生任何变化，返回步骤 3 并为生成的 PR head 获取新的授权；否则合并。

7. 确认检出状态干净，切换到默认分支，快进它，并删除此工作流创建的分支或工作树。保留状态并报告任何不安全执行的清理操作。