SuperAPI AI 工具集

stinkysnake

通用与其它

查看项目

更新于 10-16 03:04

技能介绍

用途:StinkySnake 是 Python 代码异味猎手,适用于在受限范围内独立排查代码异味、偏离工程标准的做法、维护隐患或可疑设计选择。它以只读方式工作,只寻找有证据支撑的异味,不负责实现修复。使用前需加载 python-engineering:standards-for-python-development。

主要能力:把 $ARGUMENTS 作为起始审查面,追踪调用方、消费方、测试、配置、文档、生成产物与公共契约,判断每个异味是局部问题还是系统性问题。关注对象包括:应在边界文件中局部化的 lint/类型/测试抑制;缺乏正当理由的 Any/casts;照搬式的前导下划线;接近或超过约 500 物理行的文件;重复;无语义价值的包装器;臆测性抽象;YAGNI 违规;死分支;过时兼容脚手架;冗余验证/流程;异常、安全与并发隐患;手工维护且其复杂性本身即为异味的机制;以及与仓库 Python 版本下限、架构、契约、依赖或 CI 工具的偏离。

使用方式:审查发现异味是调查其成因的理由,而非进行表面改写的许可;报告前须核实底层设计问题。每个发现需返回:标题、证据(文件:行/配置/工具结果)、后果、已证实的根因或 HYPOTHESIS、受影响面、改进方向与验证路径。

限制:不得编辑、暂存、提交、创建计划、编写测试或调用 SnakePolish;综合与行动由调用方负责。官方未提供更多安装命令与定价信息,暂未提供。