Python代码规范编写与修订
提供现有代码或功能需求,按类型标注、数据类和异常处理规范编写或修订Python代码,保持改动集中。
功能与用途
适用于编写新功能、修复缺陷和整理已有Python代码。你可以提供源文件、待修复的问题或明确的功能需求,得到符合现有项目风格的代码修改。它侧重补充必要的类型标注、用数据类表达简单数据容器,并为异常提供具体类型和清晰信息,避免隐藏错误。修改已有文件时,会尽量限定改动范围,保留无关代码的排版,只为不直观的设计意图添加注释,便于阅读和审查。使用前需提供代码上下文或足够清楚的需求。
适用场景
- 为已有函数补充类型标注:提供Python函数及调用上下文,补齐参数、返回值和必要变量的类型标注。
- 简化数据容器定义:将主要用于保存字段的普通类改写为数据类,保持周边代码风格一致。
- 修正吞错与模糊异常:检查宽泛捕获和笼统异常,改为具体异常及清晰信息,让意外错误正常暴露。
- 提交小范围缺陷修复:围绕指定缺陷修改必要代码,避免重排无关行,让代码差异便于审查。
适用人群
- Python开发者
- 维护Python项目的工程师
- 参与Python项目的开源贡献者
使用步骤
- 提交Python代码或明确的功能需求。
- 说明缺陷、预期行为及需要保留的接口。
- 获取符合类型、数据类和异常处理规范的修改。
- 检查代码差异,确认改动范围和行为符合预期。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
- 使用难度
- 简单
- 版本
- main
- 最近更新
- 2026-11-03
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Conventions for clean, idiomatic Python. Load whenever you read, edit, or write Python source files.
使用前准备
- 提供需要修改的Python代码及相关上下文,或清楚描述新功能需求。
- 修改现有项目时,提供周边代码,便于保持一致的编码风格。