SuperAPI AI 工具集

review-clear-blocked

编程与开发

查看项目

更新于 10-23 23:08

技能介绍

用途:该技能用于处理 CocoReview 中严重级别为 BLOCKED 的审查发现项。BLOCKED 表示该问题超出审查者的处理权限,需要人工做出决定并记录理由,而不是通过修改代码来解决。

主要能力:解析 --id 与 --rationale 两个必填参数;校验当前目录是否已初始化 CocoPlus(即 .cocoplus/ 是否存在);从 .cocoplus/lifecycle/review-state.json 读取并定位指定发现项;确认其严重级别为 BLOCKED 且尚未解决;将理由写入审计记录(当 CocoAudit 启用时,事件类型为 blocked-finding-resolved);更新 review-state.json 中的 resolved、resolved_at 与 resolution_rationale 字段;最后检查是否还存在其他 BLOCKING 或未解决的 BLOCKED 发现项,并据此判断 $ship 是否解除阻塞。

使用方式:命令格式为 $review clear-blocked --id <finding-id> --rationale <text>,两个参数均为必填。若 .cocoplus/ 不存在,会提示先运行 $pod init;若参数缺失、发现项不存在、严重级别不符或已解决,命令会输出相应提示并停止。理由必须是真实有效的说明,不能使用“resolved”“fine”之类的空泛占位内容,因为它构成人工决策的审计依据。即使 CocoAudit 未启用,也仍需更新 review-state.json 以跟踪解决状态。

适用场景:需要在代码审查流程中对 BLOCKED 级别问题做出豁免或例外决定,并保留可追溯记录;在决定后判断是否仍存在阻止 $ship 的发现项。

限制:该命令只处理 BLOCKED 级别的发现项,普通 BLOCKING 问题应通过修复代码解决;其他功能、收费与平台支持信息暂未提供。