AgentSkillsCN

python-dev

Python开发规范,涵盖代码风格、测试、打包,以及本工作空间的最佳实践。

SKILL.md
--- frontmatter
name: python-dev
description: Python development conventions including code style, testing, packaging, and best practices for this workspace.

Python Development

Code Style

  • Formatter: black (line-length: 100)
  • Linter: flake8, mypy
  • Naming: PEP 8

Project Structure

code
project/
├── src/package/
├── tests/
├── pyproject.toml
└── README.md

Dependencies

  • Use Poetry for dependency management
  • Pin major versions
  • Use groups: dev, test, etc.

Testing

  • pytest for testing
  • TDD preferred
  • 80% coverage on new code

  • Files: test_*.py, functions: test_*

Type Hints

  • Required for function signatures
  • Use typing module for complex types
  • Run mypy before commits

Commits

  • Conventional commits, English
  • Atomic (one logical change)