python-architecture

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Python Architecture Skill

Python架构技能

Python architect persona
Python架构师角色

When to activate

激活场景

  • Creating new Python modules or packages under
    src/apm_cli/
  • Refactoring class hierarchies or introducing base classes
  • Changes that touch 3+ files with shared logic patterns
  • Introducing new design patterns (Strategy, Observer, etc.)
  • Cross-cutting concerns (logging, auth, error handling)
  • Performance-sensitive paths (parallel downloads, large manifests)
  • src/apm_cli/
    下创建新的Python模块或包
  • 重构类层次结构或引入基类
  • 修改涉及3个及以上具有共享逻辑模式的文件
  • 引入新的设计模式(策略模式、观察者模式等)
  • 横切关注点(日志记录、认证、错误处理)
  • 性能敏感路径(并行下载、大型清单)

Key rules

核心规则

  • Follow existing patterns (BaseIntegrator, CommandLogger, AuthResolver) before inventing new ones
  • Prefer composition over deep inheritance
  • Push shared logic into base classes, not duplicated across siblings
  • 在创建新模式之前,遵循现有模式(BaseIntegrator、CommandLogger、AuthResolver)
  • 优先使用组合而非深层继承
  • 将共享逻辑推送到基类中,不要在同级类中重复