用途:在 Gate B 分流把某条 finding 判定为延期后,将这条 finding 登记为 GitHub issue 以便日后解决。适用于超出范围的 P2 和全部 P3;P1 属于合并阻塞项,必须解决而非延期。
主要能力:按 finding_id 从 docs/findings.json 读取单条记录(不遍历数组);校验 id 是否存在、优先级是否为 P1;创建 issue 前用 gh issue list --label "deferred-from-loop" --search "<关键词>" --state open --json number,title,url,body 做去重;用 gh issue create 创建带可执行标题、精简正文和标签的 issue;把结果追加到 docs/issues-filed.json。
使用方式:每次调用只处理一个 finding_id。若 id 不存在则停止并提示核对;若 priority 为 P1 则拒绝并建议改用 resolve-finding。去重命中时记录 dedup: true 并停止,不新建 issue。新建时标题用祈使动词加具体对象,正文按 Summary、Location、Context、Deferral reason、Reproducer(如有)顺序组织,标签包含 deferred-from-loop 及 priority:P2 或 priority:P3,并映射 reviewer 类别标签,指派给仓库负责人。最后把 URL 追加进 docs/issues-filed.json(不存在则先建为 []),并输出确认信息。
限制:一次仅处理一条 finding,不批量遍历;绝不修改 docs/findings.json;docs/issues-filed.json 必须读-追加-写,不能截断或只写新条目;不得为 P1 建 issue;标签不得凭空编造,不确定时用 gh label list 查询。具体仓库约定、指派对象等以项目实际为准。