用途:规范向仓库推送提交并开启 PR 后的收尾流程。核心观点是推送只是循环的开始,任务只有在 CI 全绿且没有未解决评论时才结束。
主要能力与用法:
- 开 PR 时打标签。仓库按标签做分流和筛选,先用 gh label list --limit 100 获取真实标签列表,因为标签集会变化,猜的标签会静默失败。选择描述 PR 性质的标签(bug、enhancement、documentation),并在合适时加主题标签(capability、primitive、agent-feature、core-change、code-mode、media、externalization 等),命令为 gh pr edit <number> --add-label <label>。打标签需要仓库的 triage 权限;若失败,应引用真实错误而不是直接断定没有权限。
- 推送前:先尝试推送,失败就读真实错误,不要凭某个标志或设置预先认定没有权限。除非用户指示覆盖,否则本地不要留下未暂存或未提交的内容。
- 推送后进入循环:盯 CI 到终态,不要空等。失败时诊断:若是自己的问题就修复;若是已知 flake 或 main 上已存在的问题,给出证据说明。
- 逐条处理评论(机器人和人类一视同仁):有效则修复,回复说明改了什么,并点 👍;无效则具体解释原因(附代码证据),并点 👎。绝不静默忽略评论,也绝不在没有回复的情况下解决讨论串。
- 升级真实取舍,不要猜。若评论需要维护者决策(设计选择、API 取舍、行为默认值),留下包含背景、你的推理、需要做的决定、各选项利弊和你的建议的评论,然后每 30 分钟轮询回复,收到后继续。
适用场景:在 GitHub 类仓库中提交 PR 并需要跟进 CI 与评审意见的协作流程。
限制:打标签依赖 triage 权限;具体标签集合随仓库变化,需实时查询;资料未提供其他平台适配、自动化脚本或收费信息。