SuperAPI AI 工具集

python-language

编程与开发

查看项目

更新于 10-24 02:39

技能介绍

Python Language 是一个面向 Python 3.11+ 的语言层编码规范技能,标注为 P0(关键)优先级,目标是在编写 Python 模块时使用地道的语言构造。

用途:作为编码规范约束,指导类型标注、数据契约建模、导入组织、路径操作与标准库使用方式,减少自定义包装和类型逃逸。

主要能力(规则要点):

  • 现代模块优先使用 from future import annotations。
  • 为公开函数、返回值以及边界数据形状添加类型标注。
  • 优先使用 pathlib.Path、contextlib、enum 和标准库辅助工具,再考虑自定义包装。
  • 使用 @dataclass(frozen=True) 表达不可变契约与值对象。
  • 优先使用 Protocol、TypedDict 或小型 dataclass,替代 dict[str, Any] 式的散乱结构。

使用方式(Recipe 要点):

  • 在 I/O 边界用 dataclass、typed dict 或 pydantic 显式建模契约。
  • 保持导入稳定,顺序为:标准库、第三方、本地。
  • 谨慎使用推导式与生成器,可读性下降时停止。
  • 持久化或面向用户的时间戳选用显式带时区的 datetime。
  • 保持模块副作用最小,导入时不应启动实际工作。

反模式(Anti-Patterns):

  • 不使用可变默认值,改用 field(default_factory=...)。
  • 新代码不使用 os.path,优先 Path。
  • 不用 Any 作为逃生舱;对未知形状收窄或校验。
  • 除非有意缓存配置,否则不在导入时读取易变运行时状态的环境变量。

验证:跨模块类型变更后运行解析器/类型检查;加载 Framework Map 获取分类默认值。

适用场景:编写或审查 Python 模块、定义数据契约与值对象、组织导入与路径处理、在团队内统一 Python 语言层规范。

限制:资料仅描述语言规范与反模式,未提供安装命令、CLI 用法、收费、支持平台或效果数据,这些信息暂未提供。