python-architecture
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChinesePython 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)
- 在下创建新的Python模块或包
src/apm_cli/ - 重构类层次结构或引入基类
- 修改涉及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)
- 优先使用组合而非深层继承
- 将共享逻辑推送到基类中,不要在同级类中重复