Python 编码规范
写、审、重构 Python 代码时的规范:PEP 8、语法校验、跑测试、现代语法。
功能与用途
它给出一套具体的 Python 写法约定:缩进用四个空格不用制表符、行长限制 88 字符(Black 默认)或严格的 79 字符;顶层定义前空两行、类内空一行;导入按标准库、第三方、本地分组并组内按字母排序;函数变量用蛇形命名、类用驼峰、常量全大写。提交前要跑语法检查、测试和格式检查。最低版本 Python 3.10+,禁止 Python 2 语法,推荐使用模式匹配、海象运算符和类型注解。依赖管理优先用 uv,没有则退回 pip。
适用场景
- 代码审查与规范核验:依据 PEP 8 规范核验 Python 脚本的缩进、命名、导包顺序与常见反模式,指出潜在缺陷并给出地道写法建议。
- 遗留代码现代化重构:将旧版本 Python 代码重构为现代范式,利用类型注解、模式匹配、海象运算符与 dataclass 提升代码可读性。
- 提交前测试与语法校验:整理提交前的检查流程,包含运行 py_compile 语法校验、执行 pytest 单元测试以及使用 uv 工具维护依赖。
适用人群
- 开发者
- 技术团队
- 独立开发者
使用步骤
- 提供待写、待审或待重构的 Python 代码。
- 让 AI 按规范逐项检查格式、命名和导入顺序。
- 提交前跑语法检查、测试与格式检查命令。
- 确认没有引入回归后再提交。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 简单
- 版本
- 1.0.0
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Python coding guidelines and best practices. Use when writing, reviewing, or refactoring Python code. Enforces PEP 8 style, syntax validation via py_compile, unit test execution, modern Python versions only (no EOL), uv for dependency management when available, and idiomatic Pythonic patterns.
使用前准备
- Python 3.10 以上环境
- 可运行 py_compile 与 pytest / unittest
- (推荐)ruff 或 black,以及 uv
依赖与权限
- 读取用户主动提供的内容