CraftKit/plugins/python/skills/review-python/SKILL.md

name, description

name	description
review-python	按项目 Python、框架和工具版本审查类型、异常、资源、异步、生命周期、事务和测试隔离问题。适用于 Python 专项代码审查；通用审查、直接实现或无法确认 Python 项目时不应触发。

Python 专项审查

先从项目清单、锁文件、源码和 .craftkit/project.json 确认 Python、框架及数据访问工具版本。

工作流

1. 确认审查范围、目标模块、Python 版本、框架、包管理工具和相关测试。
2. 请求 python:profile 的 language-review；当前会话未发现提供方时说明缺口并使用本 Skill 的最小检查项。
3. 检查类型与空值、异常边界、资源生命周期、可变默认值、导入副作用和公开契约。
4. 异步代码检查阻塞 I/O、任务生命周期、取消处理及同步/异步边界。
5. 框架和 ORM 代码按已确认版本检查依赖、请求、会话与事务生命周期。
6. 只报告可复现、有代码证据且影响明确的问题，按严重度给出最小修复建议。
7. 未运行静态检查或测试时明确说明，不自动修改代码。

边界

• 不默认最新 Python、FastAPI、Pydantic 或 ORM 行为。
• 项目未配置 Ruff、mypy、pyright 或 Black 时，不把缺少这些工具本身报告为缺陷。
• 不安装工具、修改依赖或连接真实外部资源。