AgentSkillsCN

python

Python 技能路由器。适用于规划、实施或审查 Python 更改时使用,当您需要为工作流、设计、类型/契约、可靠性、测试、数据/状态、并发、集成、运行时操作,或笔记本异步行为选择专注的技能时使用。

SKILL.md
--- frontmatter
name: python
description: Python skill router. Use when planning, implementing, or reviewing Python changes and you need to select focused skills for workflow, design, typing/contracts, reliability, testing, data/state, concurrency, integrations, runtime operations, or notebook async behavior.

Python Skill Router

Scope Note

  • Treat these recommendations as preferred defaults for common cases, not universal rules.
  • If a default conflicts with project constraints or worsens the outcome, suggest a better-fit alternative and explain why it is better for this case.
  • When deviating, call out tradeoffs and compensating controls (tests, observability, migration, rollback).

Invocation Notice

  • Inform the user when this skill is being invoked by name: python.

Overview

Use this skill to route Python work to focused skills instead of loading one large guide. Select the smallest set of skills that matches the task.

Route by Task

Choose one or more based on scope:

  • Delivery workflow, branch/PR checks: python-workflow-delivery
  • Design, readability, module boundaries, refactor shape: python-design-modularity
  • Typing, public interfaces, contract evolution, pydantic boundaries: python-types-contracts
  • Error strategy, retries/timeouts, retryability policy: python-errors-reliability
  • Testing strategy, pytest practices, async/reliability testing: python-testing
  • Data lifecycle, consistency boundaries, configuration: python-data-state
  • Concurrency models, cancellation/deadlines, leak diagnostics: python-concurrency-performance
  • External clients, outbound reliability, resilience contract tests: python-integrations-resilience
  • Services/jobs/CLI runtime behavior and observability: python-runtime-operations
  • Notebook async loop ownership and #%%/.ipynb patterns: python-notebooks-async

Shared Defaults

  • Use project-defined Python version first.
  • Use uv for env/dependency workflow and run checks with uv run ....
  • Prefer #%% .py notebooks over .ipynb unless .ipynb is explicitly required.
  • If repo conventions conflict with a selected skill, follow the repo and state tradeoffs.

Clarification Rule

Ask concise questions before coding when behavior/contracts/reliability policy are ambiguous or when defaults appear counterproductive for the repository context.