К основному содержанию
скилл CX Codex

python-foundational — скилл для Claude Code

Скилл python-foundational для Claude Code автоматически проверяет при код-ревью диффы с .py файлами по чеклисту базовых практик Python.

MIT ★ 1 627 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add microsoft/hve-core --skill python-foundational -a claude-code
Открыть на GitHub

Что делает python-foundational

Скилл грузится первым для любого изменения на Python и задаёт основу, на которую опираются другие, более специфичные скиллы. Внутри девять разделов чеклиста: именование и импорты, питонические идиомы (with, dataclass, pathlib, запрет мутабельных дефолтов), дизайн функций и классов, типизация публичных API, обработка исключений без «тихих» падений, антипаттерны вроде eval и exec на недоверенных данных, логирование вместо print, архитектурное соответствие существующим слоям и принципы дизайна — устранение дублирования, минимальная сложность решения.

Для деталей по стилю и принципам даны два референс-файла: code-style-patterns.md с примерами кода и design-principles.md с обоснованием раздела о дизайне. Каждой находке назначается уровень серьёзности — High для рантайм-ошибок и утечек данных, Medium для проблем поддерживаемости, Low для косметики.

Агент выбирает скилл по типам файлов в диффе: если изменений в .py нет, чеклист не подключается. Если скилл подключился, но находок нет — значит, диф уже соответствует чеклисту.

Какие задачи решает

  • проверить диф на соответствие базовым стандартам Python
  • отловить bare except и тихие падения
  • найти мутабельные дефолты и использование global/nonlocal
  • проверить типизацию публичных API
  • поймать eval, exec и pickle на недоверенных данных

Примеры запросов агенту

  • Проверь этот диф на Python по чеклисту python-foundational
  • Разбери функцию на соответствие дизайн-принципам из python-foundational
  • Оцени серьёзность находок по рубрике python-foundational

Как установить python-foundational

1Через Skills CLI (Vercel)

npx skills add microsoft/hve-core --skill python-foundational -a claude-code

2Вручную: положить файлы

~/.claude/skills/python-foundational/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/python-foundational/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о python-foundational

Как установить python-foundational в Claude Code?

Выполните npx skills add microsoft/hve-core --skill python-foundational -a claude-code — скилл появится в ~/.claude/skills/python-foundational/SKILL.md.

Что делает python-foundational?

Это чеклист из девяти разделов — от стиля и идиом до типизации, обработки ошибок и дизайн-принципов — который агент применяет к любому диффу с изменениями в .py файлах.

Когда скилл не подключается к ревью?

Агент выбирает скиллы по типам файлов в диффе: если в изменениях нет .py файлов, python-foundational не загружается.

Исходный текст

SKILL.md · MIT
---
name: python-foundational
description: "Foundational Python best practices, idioms, and code quality fundamentals"
license: MIT
user-invocable: false
metadata:
  authors: "microsoft/hve-core"
  spec_version: "1.0"
  last_updated: "2026-03-23"
---

# Python Foundational Coding Standards Skill

## Overview

Foundational Python excellence that every diff must satisfy. This skill is loaded first for any .py change. All higher-order skills build on it.

This content is a skill rather than an instructions file for three reasons: skills are distributed through the CLI plugin and VS Code extension without requiring consumers to copy files into their repo; new language skills can be added without modifying the review agent itself; and skills are loaded on demand, keeping the context window small when the diff contains no Python.

## Core Checklist

#### 1. Readability & Style

* Use Python naming: `PascalCase` classes, `snake_case` functions/variables, `UPPER_SNAKE_CASE` constants, `_` private members.
* Group imports: stdlib → third-party → local (blank line between groups, no trailing whitespace).

#### 2. Pythonic Idioms

* Prefer comprehensions for simple transforms; use explicit loops for complex logic/side-effects.
* Always use `with` for files, locks, DB connections.
* Prefer `dataclass` / `NamedTuple` / `Enum` for data holders.
* Use `pathlib` over `os.path`; timezone-aware `datetime` when relevant.
* Use `*` keyword-only arguments for multi-optional functions.
* Never use mutable defaults or `global`/`nonlocal` unless strictly required.

#### 3. Function & Class Design

* Keep functions small and single-responsibility.
* Add docstrings to all public APIs (follow repo style).
* Document unavoidable side-effects.
* Follow codebase’s class-member ordering (if defined).

#### 4. Type Safety Foundations

* Add type hints to all public APIs, module vars, and class attributes.
* Use PEP 695 (3.12+) or `TypeVar` for generics.
* Avoid `Any` except in thin wrappers.

#### 5. Error Handling

* Raise specific exceptions; never bare `except:` (broad `except Exception:` only at app boundaries with logging).
* No silent failures or generic error messages.
* Provide context, expected state, and guidance in every exception.

#### 6. Anti-Patterns to Avoid

* Never use `eval`, `exec`, or `pickle` on untrusted data.
* Never hard-code secrets.

#### 7. Maintainability

* Prefer self-documenting code; comments only for "why".
* Use structured logging instead of `print`.
* Flag overly long/complex functions that resist testing.

#### 8. Architectural Fit

* Align with existing patterns; do not re-implement shared functionality or bypass established layers.
* Place code in the correct module/package.

#### 9. Design Principles

* Eliminate duplication: extract repeated logic into a shared helper so fixes propagate automatically.
* Prefer the simplest implementation that satisfies current requirements. Introduce abstractions only when a second concrete use case appears.
* Limit change breadth: every modified line should trace to the stated purpose of the change.
* Before flagging seemingly unused code, verify it is not a protocol implementation, framework hook, public API, or entry point invoked externally.
* Match solution complexity to problem complexity. A duplicated function warrants a shared helper, not an event-driven architecture.

## References

| File                                                        | Covers       | Purpose                                                                                 |
|-------------------------------------------------------------|--------------|-----------------------------------------------------------------------------------------|
| [design-principles.md](references/design-principles.md)     | Section 9    | Rationale and examples for the design principles                                        |
| [code-style-patterns.md](references/code-style-patterns.md) | Sections 1–5 | Concrete code examples for style, idioms, type safety, class design, and error handling |

## Severity Rubric

| Severity | Definition                                                                                               |
|----------|----------------------------------------------------------------------------------------------------------|
| High     | Causes incorrect behavior, data loss, or security exposure at runtime                                    |
| Medium   | Degrades maintainability, readability, or violates a project convention with no immediate runtime impact |
| Low      | Cosmetic, stylistic, or minor improvement opportunity                                                    |

## Troubleshooting

| Symptom                      | Check                                                                                                                                                             |
|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Skill not loaded             | Confirm the diff contains `.py` files. The agent selects skills by matching file types in the changed files against skill descriptions.                           |
| No findings generated        | Verify the `Skills Loaded` footer in the review output lists `python-foundational`. If listed but no findings appear, the diff may already satisfy the checklist. |
| Severity seems miscalibrated | Compare against the Severity Rubric above. High requires runtime impact; medium is maintainability-only.                                                          |

## Contributing

Follow these conventions when extending this skill:

* Checklist items belong in SKILL.md. Each bullet is a single, actionable check an agent or reviewer can apply to a diff. Keep bullets concise: one sentence, no code.
* Reference files live in `references/` and provide examples or rationale for the covered checklist items. Each reference file covers a contiguous range of sections. Update the References table when adding a new file.
* Before adding a new checklist item, confirm it does not duplicate an existing bullet in any section. Place it in the section that matches its primary concern. If it spans concerns, prefer the more specific section.
* Name new reference files after the topic they cover (e.g., `async-patterns.md`). Include a frontmatter `description` that states which sections the file supports. Add a row to the References table in SKILL.md.
* Checklist items and examples must be portable across codebases. Use generic module names and describe anti-patterns by their behavior, not by specific directory or file names.

© microsoft · MIT · microsoft/hve-core

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
python-code-quality laurigates Скилл python-code-quality для Claude Code и Codex координирует стек проверки качества Python-кода. Включается при вопросах о линтинге, форматировании, стиле и проверке типов через ruff и ty. CX Codex +1 1 100установок modern-python trailofbits Скилл modern-python для Claude Code настраивает Python-проекты с uv, ruff и ty; применяется при создании проектов, написании скриптов и миграции со старых инструментов. CX Codex +1 9 700установок qt-qml-review qt-ai-skills Скилл qt-qml-review проверяет Qt6 QML: сначала детерминированный линтер, потом агенты по семи доменам, на выходе один отчёт только с уверенными находками. CX Codex +1 1 000установок python-anti-patterns Seth Hobson Скилл python-anti-patterns для Claude Code проверяет код по чек-листу типичных ошибок Python перед мержем и во время отладки. CX Codex +1 13 278установок python-patterns affaan-m Скилл python-patterns подсказывает агенту, как писать и ревьюить Python: идиомы, аннотации типов, обработка исключений, контекстные менеджеры. CX Codex +1 7 500установок python-code-review existential-birds Скилл python-code-review проверяет файлы Python на ошибки в типах, блокирующие вызовы в async-функциях и нарушение PEP8. Пригодится при подготовке пуллреквестов и чистке кодовой базы. CX Codex +1 958установок

Из того же набора148

Весь набор →
copilot-tracking Правило задаёт, как хранить промежуточные материалы RPI, HVE Builder и других рабочих процессов в .copilot-tracking/. Оно помогает агенту вести исследование, планы и ревью в согласованных файлах. CX Codex +1 ★ 1 627звёзд репо demo-video Скилл demo-video собирает демо-видео из упорядоченных кадров или клипов, WAV-озвучки и переходов через FFmpeg. Для первых прототипных роликов и туториалов. CX Codex +1 ★ 1 627звёзд репо dt-methods Скилл dt-methods для Claude Code содержит базу знаний по девяти методам Design Thinking и девяти отраслевым контекстам для агента dt-coach. CX Codex +1 ★ 1 627звёзд репо rpi-challenger Скилл rpi-challenger задаёт адаптивные вопросы к задаче, плану или артефакту, чтобы выявить допущения до начала работы. Сначала он просит подтвердить границы проверки. CX Codex +1 ★ 1 627звёзд репо ml-experimentation Скилл ml-experimentation для Claude Code описывает инженерные практики Microsoft CSE и помогает выстроить воспроизводимый трекинг ML-экспериментов. CX Codex +1 ★ 1 627звёзд репо c4-architecture Скилл c4-architecture строит диаграммы C4 по коду существующей системы или требованиям к новой. Помогает описать архитектуру на нужном уровне и подготовить исходник для Mermaid. CX Codex +1 ★ 1 627звёзд репо Code Review Readiness Субагент Code Review Readiness проверяет pull request как сдаваемый результат: упаковку, описание, доказательства проверок, чекбоксы и изменённую документацию. Запускает его оркестратор Code Review, сам по себе он не вызывается. CX Codex +1 ★ 1 627звёзд репо standards-mapping Правило standards-mapping связывает компоненты архитектуры со стандартами OWASP, NIST, CIS и облачными фреймворками при формировании планов безопасности в Claude Code. CX Codex +1 ★ 1 627звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой