用途:在 microsoft/winappcli 仓库中走完贡献者 PR 的完整生命周期,产出清晰的 PR 与诚实的就绪状态,目标不是合并。适用于"创建 PR""准备这个 PR""让 PR 可被评审"等请求,仅用于该仓库工作,不是对外发布的 winapp 插件技能。
权限与仓库策略:先确认请求范围。"起草 PR 正文"只返回文本,"评审这个 PR"只返回发现项,二者都不授权改代码、推送、发帖、请求评审或改标签。创建或推进 PR 就绪可授权必要的范围内工作,但不含无关改动或合并。需阅读 AGENTS.md、PR 模板、.github\workflows 中相关工作流定义及 .pipelines 说明;活动分支保护与规则集是必需检查与批准的唯一事实来源。
准备:确定真实比较对象,读取活动 PR 的仓库、编号、状态、head/base 的 ref 与 SHA、草稿状态、检查、评审与可合并性;检查本地状态与完整 diff(含相关未跟踪文件),获取真实 head 与 base,记录不可变 SHA。保护他人工作:不暂存无关文件、不丢弃脏工作区、不覆盖协作者提交;远端 head 与预期不符时先检查;优先非重写更新,重写需授权并带 --force-with-lease=<ref>:<expected-sha>。尊重堆叠 PR,按实际父分支评审,使用原生堆叠技能同步。对最终 diff 获取独立评审,修复可操作缺陷并补回归测试,解释误报。
展示:使用简短、面向结果的标题与仓库 PR 模板;说明问题与用户在改动后可做什么,给出最小前后对比示例并区分实测与示例,附聚焦的验证证据、诚实的限制与真实权衡;视觉改动需实际前后截图,非视觉改动用 CLI/API 文本示例。不得编造或修饰证据,不上传密钥与个人数据;编辑现有正文前先读其活动内容并保留人工修改。生命周期标签是就绪信号,不发布自动状态评论。
完成:读全部分页的行内评审线程、回复、顶层评审正文与 issue 评论;对每条可操作线程回复修复或带理由的分歧后再解决;绝不自行驳回人工的 changes request,处理后可重新请求该评审者。检查必需 CI 在最新 head 与集成/合并提交上完成且通过,失败先看日志,仅对瞬时基础设施失败做有限重试,不削弱断言或绕过检查。使用有界等待而非紧密轮询,技能无法唤醒空闲代理,若无机制则说明"未主动监控"。
标签:本工作流管理的开放 PR 使用三个互斥标签 agent-preparing、agent-blocked、ready-for-review,切换前取实时快照并确认独立最终 diff 覆盖、必需 CI 通过、集成最新且无合并冲突。新提交、可操作发现或冲突会使就绪失效。本 PR 被合并/关闭后,下次调用应移除活动生命周期标签并停止,不重开。文末给出 PR 链接、实际状态与剩余阻塞/下一步,区分"技术就绪"与"已批准""已合并"。
限制:该技能不授权合并、启用自动合并、绕过保护或制造批准;不能自行唤醒空闲代理;具体命令示例依赖 gh 与 GraphQL 访问,若 SSO/权限不可用需将缺失评估报告为门禁。