Python 编码基线

这个 skill-unit 处理的是“Python 代码实现质量”问题。它不是个人风格清单，而是一套先对齐项目、再落通用基线的约束。

核心原则

1. 项目对齐 —— 先遵循仓库既有约定

• 先看当前仓库已经怎么写，再决定这次改动怎么落。
• 如果项目已有明确约定，优先沿用，不用通用偏好硬覆盖。
• 如果项目没有稳定约定，再用本 skill 作为默认基线。

2. 类型边界 —— 公共接口先清楚

• 新增或修改的函数、方法、类边界应补全必要类型提示。
• 公共接口、跨模块边界、非显然返回值，比局部变量更值得优先标注。
• 类型提示的目标是降低歧义，而不是机械补满每一行。

3. 运行日志 —— 正式路径不用 print