python-types-contracts

SKILL.md

Treat type hints as interface design, not decoration. Focus on explicit contracts, stable public APIs, and boundary-safe modeling.

These are preferred defaults for common cases, not universal rules. When a default conflicts with project constraints, suggest a better-fit alternative and explain tradeoffs and compensating controls.

Internal helpers don't need the same rigor as public APIs. Over-annotating private code adds noise without safety.

在 Python 中定義或發展公共接口、模式邊界或 pydantic 用法時使用。當公共 API 上缺少註釋、pydantic 模型出現在各處而不是信任邊界、合約更改缺乏遷移指導或跨模塊邊界過度使用任何/對像類型時，也可以使用。 來源：ahgraber/skills。

查看原文