Improve Python Code Quality Skill 技能

Python 项目中许多常见错误——可变得默认值、裸露的 except 子句、资源泄漏、类型注解缺失——在快速迭代过程中容易被忽略，直到在生产环境引发问题。这个 Skill 为 AI 编码助手提供一套系统的 Python 代码质量检查清单，涵盖正确性、类型安全、错误处理和文档风格四个维度，帮助在代码合入前发现潜在问题。

核心能力

1. 审查可变默认值、裸露 except 子句、缺失类型注解和命名不规范问题
2. 指导使用类型提示、dataclass、数据类、泛型和文档化接口
3. 推荐上下文管理器、列表推导式、生成器和标准库工具的正确用法
4. 提供 Google 风格的文档字符串模板和结构化审查输出格式
5. 帮助调试 Python 异常并改进边缘情况处理逻辑
6. 覆盖 pylint、mypy 等工具的检查规则对应的代码模式

安装配置

1. 通过 skillstore 安装：npx skillstore add shubhamsaboo/python-expert
2. 推荐配合类型检查工具（mypy）和代码风格工具（pylint / ruff）使用
3. 可在项目根目录添加 pyproject.toml 配置以激活严格类型检查

使用步骤

1. 在 Pull Request 审查阶段，运行「添加基础质量检查」指令，获取问题清单
2. 针对具体函数，运行「改进函数接口」指令，获得类型提示、文档字符串和异常规范
3. 日常开发中，运行「重构可维护性」指令，从模块级别优化代码结构
4. 发布前，运行「生产级 Python 审查」指令，执行完整优先级排序的检查

适用场景

1. Pull Request 审查：合并前发现类型错误、异常处理和资源泄漏问题
2. 遗留代码重构：改进缺乏类型注解和文档的老文件，降低未来维护成本
3. 新手教育：Python 开发者通过审查反馈学习常见错误模式和最佳实践
4. AI 生成代码优化：AI 生成的 Python 代码通常缺乏类型注解和错误处理，该 Skill 可以系统补全
5. 技术债务清理：识别项目中高频出现但未被强制执行的编码规范问题

适用人群

Python 开发者、代码审查者、AI 编程助手用户，以及希望提升 Python 代码质量的团队技术负责人。

工作原理

该 Skill 内置 Python 代码审查模式库，对应常见错误分类（可变性、异常处理、类型系统、资源管理），AI 助手通过模式匹配识别问题并给出具体修改建议，而非简单指出问题存在但不提供解法。审查输出遵循 Google 风格文档规范，确保建议既准确又可操作。

官方链接

https://skillstore.io/skills/shubhamsaboo-python-expert