Python 代码风格与检查

原名：python-code-style

统一命名、导入、注释和格式检查，先遵守仓库约定再提出改善。

中文 Skills 技能说明

创业团队多人维护 Python 脚本，代码风格逐渐混乱时，可让开发岗位数字员工整理。提供项目规范、pyproject 配置、Python 版本和需要检查的文件，技能比较现有风格与 Ruff 等检查规则，交付问题清单、配置建议和小范围修正。只处理约定范围，不把格式化扩散到无关文件，也不改变业务语义。检查器需桌面端自行安装并核对版本；批量改写前查看差异并保留回退，测试结果和合并决定仍由人审核。

上游能力依据

上游原始适用说明：Python code style, linting, formatting, naming conventions, and documentation standards. Use when writing new code, reviewing style, configuring linters, writing docstrings, or establishing project standards.

上游 SKILL.md 主要章节（保留原文标题）：

• When to Use This Skill
• Core Concepts
• 1. Automated Formatting
• 2. Consistent Naming
• 3. Documentation as Code
• 4. Type Annotations
• Quick Start
• Fundamental Patterns
• Pattern 1: Modern Python Tooling
• Pattern 2: Type Checking Configuration

使用边界

先读取项目约定、依赖版本和现有测试，再提出最小改动。写文件、运行脚本、提交代码或发布前应检查差异并保留回退路径。

作者、翻译与许可证

原作者

Seth Hobson（wshobson）与 agents contributors

中文翻译

CEOFans翻译

许可证

MIT

上游来源

https://github.com/wshobson/agents/tree/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/python-development/skills/python-code-style

适用范围

平台：linux、macos、windows；标签：软件开发、Python 代码风格与检查、开源技能

安全提示

基础静态扫描不等于绝对安全。技能可能调用命令、浏览器、云服务或本地文件，请在最小权限环境中使用，高风险操作必须人工确认。

如发现侵权、许可证或安全问题，可在本页前台提交投诉，管理员复核后可立即下架。