25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
---
|
|
name: review-python
|
|
description: 按项目 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 时，不把缺少这些工具本身报告为缺陷。
|
|
- 不安装工具、修改依赖或连接真实外部资源。
|