SuperAPI AI 工具集

holistic-linting

测试与质量

查看项目

更新于 10-16 06:20

技能介绍

用途:对明确请求或任务改动的文件/目录,发现并运行仓库已配置的质量门禁,将诊断信息作为证据进行诊断,而不是当作消除告警的指令。除非被请求或权威配置门禁要求,否则不扩大到全仓库清理。

主要能力:只读检查仓库配置;当 prek/pre-commit 配置为权威时,运行一次聚合命令 prek run --files <changed files>,仅在复现或诊断某钩子失败时单独指定该钩子;保留未知/自定义钩子,不静默缩减为已知工具白名单。当 .pre-commit-config.yaml 为权威时,可用 detect_hook_tool.py 辅助选择运行器,脚本需从已安装技能目录解析,其输出只是运行器选择证据,不代表已发现全部门禁。发现状态分为 COMPLETE、NO_APPLICABLE_GATES、INCOMPLETE;缺失可执行文件、配置畸形/不支持、超时、无适用门禁是不同结果,空/未知结果不得当作通过。

执行与诊断:按仓库配置运行格式化与质量检查;格式化是状态变更,需把被格式化触及的文件加入验证面。记录每个门禁的退出状态与诊断;门禁成功与诊断处置分开,零退出仍可能产生警告/建议,需在完成前处置但不把仓库认可的警告升级为失败。将诊断分类为缺陷、工具/配置缺陷、合理例外候选、未解决或超出范围,并按 API/类型契约、配置、生成源、依赖或实现边界聚类;仅对已确认独立的修正簇并行处理。

规则解释:Ruff 优先使用已安装工具的 ruff rule <CODE>;MyPy 优先匹配版本文档,离线时用内置规则索引与随附文档并标注版本不确定性;Bandit 优先当前安装/官方证据,内置索引作离线回退;其他检查器用已安装/当前文档。无法建立权威解释时保留为缺失证据,不猜测。

完整性保护:不得为获得绿色输出而自主添加/扩大抑制、降低配置适用性/严重度、绕过门禁或删除必需行为;定向例外是策略决定,需记录提议例外与所需权限,已授权例外在最终证据中显式保留。未解决项保留原始诊断、尝试/观察、根本约束或未知、下一步所需证据;超出范围项保留工具/门禁、规则、位置/范围、精确诊断、复现命令/上下文、发现修订/日期,并交付给已有授权仓库策略/跟踪器或返回调用方,不创建插件专用跟踪器。

验证与报告:接受修正状态前,对比修正前源码/配置,检查新增/扩大抑制、忽略/排除/严重度/适用性弱化、门禁绕过/移除、必需行为删除,区分真实抑制与类似抑制的夹具/字符串文本及未变动的既有注释,确认例外已显式授权,重跑所有受影响门禁(含附带改动文件);验证后若发生相关编辑,需作废并重跑受影响证据。报告包含工作流状态 DONE|BLOCKED、范围、发现状态、已执行门禁、门禁结果、诊断处置、修正与完整性证据、UNRESOLVED、OUT_OF_SCOPE 与交付状态、所需额外验证。仅当所需门禁/完整性检查对声明范围终结时才用 DONE;BLOCKED 需指出缺失证据、权限、能力或失败门禁。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息;detect_hook_tool.py 输出仅为证据,不是语义诊断。