核心用法
本技能为Python开发提供全面的编码规范与最佳实践指导，适用于代码编写、审查和重构场景。核心功能包括：
代码风格管控：严格执行PEP 8规范，包括4空格缩进、88字符行长限制（Black默认）、导入分组排序（标准库→第三方→本地）、命名约定（snake_case函数/变量、PascalCase类、UPPER_CASE常量）等。
质量门禁机制：提交前强制检查清单——通过py_compile进行语法验证、自动检测并运行pytest/unittest测试、支持ruff/black格式化检查。确保每次代码提交前基础质量达标。
现代化版本策略：明确排斥Python 2及EOL版本（3.9于2025年10月终止支持），最低要求Python 3.10+，推荐3.11-3.13以充分利用match语句、海象运算符、联合类型语法（|）等新特性。
智能依赖管理：优先检测并使用uv工具（新一代Python包管理器），自动回退至pip，提供uv init、uv pip compile等现代工作流命令。
Pythonic模式库：内置大量惯用法示例，包括列表/字典推导式、上下文管理器、解包操作、EAFP优于LBYL原则、f-字符串格式化、类型提示、dataclass数据类、pathlib路径处理等，同时明确标注反模式（可变默认参数、裸except、全局状态等）。
显著优点
1. 标准化程度高：基于官方PEP 8及社区广泛采纳的Black/ruff工具链，避免团队风格争议
2. 自动化检查：提供可执行的bash脚本片段，降低人工审查成本
3. 前瞻性版本管理：主动淘汰EOL版本，引导技术栈升级
4. 工具链现代化：率先集成uv，响应社区工具演进趋势
5. 模式即代码：正反示例可直接复制使用，降低学习曲线
潜在局限
- 工具依赖假设：假设环境中已安装ruff/black/pytest，未提供安装指引
- uv覆盖有限：uv尚处快速发展期，部分复杂场景（如交叉编译、特定平台wheel）可能需回退pip
- 88字符争议：Black的88字符与严格PEP 8的79字符并存，可能引发选择困惑
- 无CI/CD集成：未涉及GitHub Actions、pre-commit hooks等持续集成配置
- 类型提示深度：仅要求公共函数标注，未强制完整类型覆盖或mypy检查
适合人群
- Python初学者建立规范编码习惯
- 团队寻求统一的代码审查基准
- 从旧版本（3.9及以下）迁移至现代Python的项目
- 希望尝试uv替代pip/conda的开发者
常规风险
| 风险点 | 说明 |
|--------|------|
执行权限 | 提供的bash脚本需手动复制执行，存在误操作可能 |
| 版本漂移 | 未锁定ruff/black等工具版本，新规则可能破坏既有代码 |
| 测试覆盖盲区 | `2>/dev/null`静默处理测试缺失，可能掩盖未配置测试的问题 |
| uv兼容性 | 部分遗留项目或特定平台可能遇到uv支持问题 |
| 过度简化 | 复杂项目需额外配置（如monorepo、多Python版本矩阵），本技能未涵盖 |