SuperAPI AI 工具集

review-python

编程与开发

查看项目

更新于 10-15 21:39

技能介绍

用途:对 Python/FastAPI 后端代码做系统性审查,覆盖风格、逻辑、类型、测试、安全与性能,并支持按技术领域并行审查。

主要能力:以硬性门禁(G1–G5)约束流程。G1 先用 git diff --name-only $(git merge-base HEAD main)..HEAD | grep -E '.py$' 枚举变更的 .py 文件;G2 在人工标记风格/类型问题前先运行项目已配置的 ruff 与 mypy;G3 在实质审查前加载 review-verification-protocol、python-code-review、fastapi-code-review;G4 每条问题需经复核证据;G5 输出需顺序编号、含 FILE:LINE,并按 Critical/Major 阻断、Minor/Informational 不阻断给出结论。

使用方式:参数 --parallel 在支持子代理时按技术领域并行审查,否则顺序执行且输出一致;Path 指定目标目录,默认当前工作目录。流程为识别变更文件、验证 linter 状态、检测技术栈(Pydantic-AI、SQLAlchemy、Postgres、测试文件)、加载验证协议与技能、审查、验证发现、收敛输出。修复后运行 ruff check .、mypy .、pytest 验证。

适用场景:Python/FastAPI 后端变更审查、修复后的复审验证。

限制:仅审查 diff 及直接相关代码;不请求新功能、测试基础设施或架构变更;净新增代码(新模块、依赖、测试套件)归为 Informational;复审只验证此前问题,不引入新发现。具体收费、平台与效果暂未提供。