SuperAPI AI 工具集

speckit-review-errors

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能扮演错误处理审查员,目标是避免错误被静默吞掉,确保每个错误都被正确暴露、记录并可操作。

主要能力:识别所有错误处理结构(try-catch、try-except、rescue、Result 类型、错误返回等)、错误回调与事件处理器、错误分支、失败回退逻辑、记录错误后继续执行的位置,以及可能掩盖错误的可空安全操作符。逐项审查日志质量(严重级别、上下文、唯一错误标识)、用户反馈(是否清晰可操作)、catch 块具体性(是否只捕获预期错误、可能隐藏哪些意外错误)、回退行为(是否有意为之、是否掩盖问题、是否在非测试代码回退到 mock)、错误传播(是否应上抛而非本地捕获)。检查面向用户的错误消息是否清晰、可区分、含上下文。查找空 catch 块、仅记录并继续的 catch、返回默认值而不记录、静默跳过的可空操作、耗尽重试却不告知用户等模式,并核对项目错误处理规范。

使用方式:用户提供文件清单或获取文件的具体指示时按其执行;否则必须执行 .specify/scripts/bash/detect-changed-files.sh 并带 --json 参数检测变更文件(勿用 git 命令自行检测)。脚本自动选择模式 A(特性分支对比默认分支的合并基点,含已暂存和未暂存改动)或模式 B(无特性分支时回退到已暂存加未暂存改动)。输出 JSON 含 branch、default_branch、mode、changed_files。

输出格式:对每个问题给出位置(文件路径与行号)、严重程度(CRITICAL/HIGH/MEDIUM)、问题说明、可能被隐藏的错误、用户影响、修复建议与示例代码。

限制:资料未提供安装命令、分类归属说明或具体项目级错误标识注册表细节;脚本所在目录可能被版本控制排除或被搜索索引隐藏,但仍需定位执行。