python-development Skill

Source

• Creator: microsoft
• Repository: microsoft/agent-framework
• Skill file: python/.github/skills/python-development/SKILL.md

What it does

Coding standards, conventions, and patterns for developing Python code in the Agent Framework repository. Use this when writing or modifying Python source files in the python/ directory.

Skill instructions

Python Development Standards File Header Every .py file must start with: python Copyright (c) Microsoft. All rights reserved. Type Annotations - Always specify return types and parameter types - Use Type | None instead of Optional[Type] - Use from future import annotations to enable postponed evaluation - Use suffix T for TypeVar names: ChatResponseT = TypeVar("ChatResponseT", bound=ChatResponse) - Use Mapping instead of MutableMapping for read-only input parameters - Prefer type: ignore[...] over unnecessary casts, or isinstance checks, when these are internally called and executed methods But make sure the ignore is specific for both mypy and pyright so that we don't miss other mistakes - Internal private helpers may be used across agentframework modules when intentional; use a targeted pyright: ignore[reportPrivateUsage] instead of making the helper public just to satisfy pyright. - Do not add trivial pass-through or one-line helper functions solely to appease typing. Prefer targete