claude-code/claude-zh/rules/python/patterns.md

paths
**/*.py **/*.pyi

Python 模式 (Patterns)

本檔案擴展了 common/patterns.md，包含 Python 特定內容。

協定 (Protocol / 鴨子型別)

from typing import Protocol

class Repository(Protocol):
    def find_by_id(self, id: str) -> dict | None: ...
    def save(self, entity: dict) -> dict: ...

使用 Dataclasses 作為 DTO (資料傳輸物件)

from dataclasses import dataclass

@dataclass
class CreateUserRequest:
    name: str
    email: str
    age: int | None = None

上下文管理器 (Context Managers) 與 生成器 (Generators)

• 使用上下文管理器 (with 語句) 進行資源管理。
• 使用生成器進行延遲求值與具備記憶體效率的迭代。

參考資源

參見技能 (Skill)：python-patterns，獲取包含裝飾器 (Decorators)、併發 (Concurrency) 與包組織 (Package organization) 的全面模式。