Python Review Router
首先使用此技能进行Python代码审查。根据上下文进行定位,然后仅加载与变更代码匹配的专项技能。
审查前:定位
-
从
pyproject.toml、setup.cfg、tox.ini、CI 或 README 中检查 Python 版本。- 如果
>=3.10:加载所有相关的核心技能,但仅在规则对应的 Python/工具约束匹配时应用。 - 如果
3.8-3.9:跳过需要>=3.10的语法规则。 - 如果未知:假设最低为3.10,但对版本敏感的问题谨慎措辞。
- 如果
-
分类项目成熟度。
- 活跃/新项目:适用完整规则集。
- 成熟遗留/仅维护项目:优先处理 CRITICAL 和 HIGH 级别的问题。
- 自动化/脚本:优先关注安全性、正确性、资源处理和清晰的错误信息。
-
检查工具链。
- 如果项目使用
pyright,不要推荐mypy特有的配置。 - 如果项目使用
ruff,将样式/导入问题延迟到其配置处理。 - 如果没有配置任何工具,工具建议应设为低严重性,除非问题与正确性相关。
- 如果项目使用
-
先读取确切的变更文件,再标记问题。
- 每个问题都要指出文件和行号。
- 不要在没有本地证据的情况下提出泛泛的问题。
- 规则匹配是信号,而不是最终结论。
路由
| 变更代码涉及... | 加载 | 何时跳过... |
|---|---|---|
注解、Any、类型转换、泛型、Protocol、公共API | py-type-safety | 变更是琐碎的且没有类型相关表面 |
| 异常、验证、清理、重试、批量失败 | py-error-handling | 未变更失败路径 |
| 默认值、配置、资源使用、ORM/API边界、混合I/O/业务逻辑 | py-anti-patterns | 变更是文档/配置 |
async def、事件循环、FastAPI/httpx/aio*、任务、取消 | py-async-patterns | 项目/变更是同步的 |
| 格式化、命名、导入、文档字符串、lint/类型配置 | py-code-style | 工具输出已覆盖或审查仅需正确性 |
可移植性说明
“加载”列指示对每种变更类型应应用哪个专项技能的规则。如何访问这些规则取决于你的智能体运行时:
- 动态加载:如果你的智能体支持在会话中途激活技能,请使指定的技能可被发现,并在路由表指示其范围时激活它。
- 静态清单:直接从技能目录读取专项技能的
SKILL.md文件,并将其规则作为审查清单应用。
两种方法产生相同的审查结果。路由表是决策树,专项技能提供规则集。
审查输出
以错误和行为风险为首。将仅涉及样式的问题放在正确性问题之后。对于遗留代码,优先选择可操作的高影响问题,而不是宽泛的现代化建议。