SuperAPI AI 工具集

green-prs

编程与开发

查看项目

更新于 10-15 21:10

技能介绍

用途:处理指定的 PR 队列,先读取 _shared/base-green.md、_shared/validation-gate.md,涉及指令面或合并前先读 _shared/protected-surfaces.md。候选 PR 自身的 workflow 与版本化策略决定必需门禁,不能假定 release PR 只需快速检查或使用手写门禁数。

范围与所有权:优先使用 owner 的 PR 列表,否则消费 _tasks/pipeline/prs/1-analyzed/ 中符合条件的 merge-ready / fix-in-place 计划;仅在被要求或无流水线项时使用整个队列。记录状态、作者、head SHA、base 分支/SHA、冻结与 worktree 所有权;属于其他会话的在途 worktree 标记 HOLD。不得在共享检出工作、stash,或静默重新定位已冻结的 release。先检查确切基线,事件历史不等于继承证据;确认的基线缺陷先在专用 PR 修复,再用其评估贡献者改动,base-red 不豁免必需门禁。

准备与验证:每个 PR 使用独立分支/worktree。编辑贡献者分支前确认检出 SHA 等于观测的实时 head;推送前确认远端仍等于观测的前驱,并发变更即 HOLD。保留原作者工作与署名并添加适当共同署名,不得覆盖或关闭 PR 以取得功劳;被锁定的 fork 需使用 owner 审核的、保留署名的后备方案。执行 RED 复现、实现已验证修复,再跑聚焦与受影响套件;依赖须匹配候选 lockfile/工具链,借用工具仅限诊断;构建需物理依赖而非外部符号链接;保留原始日志、退出码、产物、测试发现与全部既有断言。快速检查可排优先级但不能授予可合并性;完整验收覆盖所有适用必需通道,含两个测试运行器、覆盖率、安全及所需的构建/打包/启动。DRIFT 只是诊断不是 PASS;不得提高基线、降低阈值或接受不稳定的必需检查。fork 的 action_required 属于信任/审批 HOLD,不是代码失败或自动批准指令;重跑旧运行不改变其记录的候选。

证据与交接:不得代替合并执行者认领或移动流水线计划。记录结构化回执,含 base SHA、head SHA、候选 SHA/tree、策略/配置、运行 ID/尝试、产物引用、验证级别与时间戳;仅 head 的旧 pre_greened 戳或仅快速门禁说明只算部分证据。任何相关身份/策略变更都会使准入失效并需重新验证。逐 PR 报告因果分类、修复、确切证据与剩余通道,区分 PASS、PARTIAL、BASE-RED、PR-RED、INFRA-RED 与 ACTION_REQUIRED/HOLD。本技能准备队列,绝不关闭 PR;若 owner 明确要求合并指定项,须先遵循完整的 _shared/merge-gates.md 协议,含受保护面与逐组授权;不因同一失败影响多个 PR 就绕过必需检查。在提交与证据安全保留前保留工作;仅按 _shared/worktree-teardown.md 清理自有的、干净的、已完整备份的 worktree,不删除贡献者远端分支或其他会话的工作。