SuperAPI AI 工具集

senior-python

编程与开发

查看项目

更新于 10-16 01:11

技能介绍

用途:对实质性 Python 工作及有生产或跨边界风险的有限改动,提供基于仓库上下文的资深工程判断,使改动在系统预期生命周期内保持正确、可理解、支持与扩展成本合理。不适用于琐碎任务或无 Python 产物的任务,此时应直接说明本审查不适用。

主要能力:先确定实际任务单元(函数、类、模块、包、服务、子系统、配置、测试或仓库),明确范围与动作姿态,审查不自动升级为修复。建立能改变结论的上下文:适用指令、目标或 diff、直接调用方与被调方、邻近测试、支持的 Python/运行时版本、清单与锁文件、已配置检查、框架与既有设施,以及相关公共、存储、配置、持久化、消息、进程、文件系统、网络或运维契约。

六项关注扫描:信任(外部数据、身份/租户决策、特权接收端)、契约(公共/存储/配置形状、兼容性、迁移、混合版本)、状态与副作用(持久化、事务、重试/重复、消息、缓存、外部副作用)、并发与资源(异步/线程/进程归属、取消、顺序、扇出、稀缺生命周期)、运行时与发布(依赖/运行时/部署、上线、回滚、生成源)、证明(本地推理无法确立的保证)。无实质信号时保持本地检查。

判断循环:陈述预期结果、任务单元、契约、不变量与约束;沿可达路径追踪输入、状态转换、副作用、失败与归属;区分事实与假设,易变声明以已装版本和官方文档核实;分类为缺陷或结构性建议,缺陷需可达输入、状态或序列;比较最小充分补救,包括不做改动;仅在请求时实现,保留周边行为与项目约定。

复用与惯用法:优先既有仓库设施、标准库、运行时/数据库/平台保证、已安装依赖、维护中的依赖,最后才是最小自定义实现;检查装饰器、上下文管理器、functools、itertools、生成器、推导式、dataclasses、协议、描述符与标准并发原语,避免为几行本地代码而引入依赖。

定级与报告:P0 可达紧急、P1 可能严重正确性/安全/可用性/兼容性失败、P2 有界缺陷或已证维护隐患、P3 可选局部改进;仅凭架构品味一般省略。审查按影响排序,给出不变量或压力、证据、可达场景、最小补救与验证;最多三项非请求的结构性建议;无行动项也是有效结论。限制:仅有片段或无仓库时本地推理并声明假设;测试、运行时或当前一手来源不可用时不得声称已验证,只给最窄有用验证步骤;生成或 vendored 代码需先找到受维护的真实来源。