用途:cleanup 是一个结构化的 Python 清理与现代化工作流,接收 $ARGUMENTS 作为作用范围,目标是消除重复与模糊归属、调查代码异味而非压制、改进类型边界并减少逃逸口,仅在项目兼容范围内现代化,且除非明确要求否则保持行为不变。
主要能力与步骤:
- 静态分析:运行 uv run prek run --files $ARGUMENTS;若无 .pre-commit-config.yaml,则回退到 uv run ruff format $ARGUMENTS、uv run ruff check --fix $ARGUMENTS、uv run ruff check --fix --unsafe-fixes $ARGUMENTS。
- 异味调查:对每个异味定位根因而非症状,判断是设计问题还是快速修复,并记录调查与决策。
- 类型边界加固:清点所有 Any 用法,将边界代码移入专用模块,在原始数据跨越边界处添加类型化包装,并运行类型策略检查。
- 现代化:仅在项目 requires-python 约束允许时现代化 typing 导入,在降低复杂度时应用 match-case,在提升可读性时使用海象运算符。
- 验证:再次运行 uv run prek run --files $ARGUMENTS;无配置时回退到 uv run ruff check $ARGUMENTS 与 uv run ruff format --check $ARGUMENTS,并运行 uv run pytest $ARGUMENTS -v。
专家加载:边界重构时加载 python3-typing;发现测试缺口时加载 python3-testing;涉及工具链变更时加载 python3-tools。
适用场景:需要对指定 Python 文件或目录进行结构化清理、类型加固与兼容性现代化改造的工程任务。
限制:具体收费、价格、平台支持与效果等资料暂未提供;所有命令与代码内容保持原样,未提供额外使用步骤。