SuperAPI AI 工具集

deferred-finding

编程与开发

查看项目

更新于 10-16 05:43

技能介绍

用途:当代码审查发现的问题无法在当前 PR 内修复时,用本流程创建规范化的追踪 issue,确保没有发现被遗漏。核心原则:没有发现会消失,每次延期都必须被追踪。

可延期的情形:超出 PR 范围(需架构变更)、外部依赖(需基础设施或配置变更)、破坏性变更(需大版本号提升)、独立关注点(与当前工作逻辑无关)。不得以“以后再修”“问题很小”“不是我的问题”“够好了”为由无追踪地延期。

主要能力与步骤:1)先确认该问题确实无法在本次 PR 修复;2)整理发现详情(问题内容、为何是问题、代码位置、严重程度、为何现在不能修);3)用模板创建追踪 issue,包含来源信息(父 issue、父 PR、Finding ID、严重程度、审查标准、深度)、发现详情、代码位置与证据、延期原因、验收标准、链接与标签;4)通过 gh issue create 命令创建,并按需创建 spawned-from:#N 标签;5)更新审查产物中的“Findings Deferred”表格;6)若延期发现阻塞父 PR,则更新父 issue(如添加 status:awaiting-dependencies 标签并发布偏差评论)。

生命周期:追踪 issue 是一等 issue,走完整 issue-driven-development 流程,需独立评审,可产生自己的延期权,独立关闭而不随父 issue 自动关闭。

深度追踪:深度 1 为原 issue 评审产生的发现,深度 2 来自深度 1 issue 的评审,深度 3+ 需人工关注并提示可能的系统性问题。

所需标签:review-finding、spawned-from:#N、depth:N 以及严重程度标签(critical/high/medium/low);可选 security、status:pending。

检查清单:确认无法在当前 PR 修复、记录有效延期原因、用完整模板创建追踪 issue、补齐所需标签、关联父 issue、在审查产物中更新追踪 issue 编号、必要时更新父 issue。

集成:本技能由 apply-all-findings 在发现无法修复时调用,也由 comprehensive-review 在记录延期时调用;创建遵循 issue-driven-development 流程的新 GitHub issue,并更新父 issue 的偏差状态;同时引用 issue-lifecycle 与 issue-driven-development。

限制:资料未提供具体命令行参数以外的环境要求、平台限制或错误处理细节。