CommunityRecherche & Datenanalysegithub.com

CodeSigils/py-review-skill

Portable Python-Überprüfungsfähigkeiten für agentskills.io-kompatible Agenten – Router plus spezialisierte Fähigkeiten für Typsicherheit, Fehlerbehandlung, Anti-Patterns, asynchrone Programmierung und Codestil.

Was ist py-review-skill?

Dieses Skill-Set bietet einen routerbasierten Ansatz zur Python-Codeüberprüfung, der es Agenten ermöglicht, je nach geändertem Code nur die relevanten spezialisierten Fähigkeiten zu laden. Es unterstützt dynamisches Laden von Skills oder eine statische Checkliste basierend auf der Agentenlaufzeit. Der Router orientiert sich an der Python-Version, dem Projekt-Maturitätsgrad und der Toolchain und gibt klare Anweisungen zu den zu ladenden Skills (z. B. `py-type-safety`, `py-error-handling`, `py-anti-patterns`, `py-async-patterns`, `py-code-style`). Das Set ist für agentskills.io-kompatible Agenten konzipiert und legt Wert auf korrekte, aktionsorientierte Ergebnisse, wobei Bugs und Verhaltensrisiken vor Stilfragen priorisiert werden. Es eignet sich besonders für die Überprüfung von Python-Projekten mit unterschiedlichen Reifegraden und kann sowohl in aktive als auch in Legacy-Codebasen integriert werden.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add CodeSigils/py-review-skill

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Python-Überprüfungs-Router

Verwenden Sie dieses Skill zuerst für die Python-Codeüberprüfung. Orientieren Sie sich am Kontext und laden Sie dann nur die spezialisierten Skills, die zum geänderten Code passen.

Vor der Überprüfung: Orientieren

  1. Prüfen Sie die Python-Version aus pyproject.toml, setup.cfg, tox.ini, CI oder README.

    • Wenn >=3.10: Alle relevanten Kern-Skills laden, aber jede Regel nur anwenden, wenn ihr Python-/Tool-Hinweis zutrifft.
    • Wenn 3.8-3.9: Syntaxregeln überspringen, die >=3.10 erfordern.
    • Wenn unbekannt: Mindestens 3.10 annehmen, aber versionssensitive Ergebnisse vorsichtig formulieren.
  2. Klassifizieren Sie die Projekt-Reife.

    • Aktiv/Greenfield: Vollständiger Regelsatz ist angemessen.
    • Reifes Legacy/Wartungsmodus: Priorisieren Sie KRITISCHE und HOHOHE Ergebnisse.
    • Automatisierung/Skripte: Priorisieren Sie Sicherheit, Korrektheit, Ressourcenverwaltung und klare Fehler.
  3. Überprüfen Sie die Toolchain.

    • Wenn das Projekt pyright verwendet, keine mypy-spezifische Konfiguration empfehlen.
    • Wenn das Projekt ruff verwendet, Stil-/Import-Ergebnisse an dessen Konfiguration delegieren.
    • Wenn kein Tool konfiguriert ist, Tool-Vorschläge als niedrige Schwere einstufen, es sei denn, das Problem betrifft die Korrektheit.
  4. Lesen Sie die genauen geänderten Dateien, bevor Sie Probleme melden.

    • Zitieren Sie für jeden Befund Datei und Zeile.
    • Keine allgemeinen Befunde ohne lokale Beweise ausgeben.
    • Eine Regelübereinstimmung ist ein Signal, kein Urteil.

Routing

Der geänderte Code betrifft...LadenÜberspringen, wenn...
Annotationen, Any, Casts, Generika, Protokolle, öffentliche APIspy-type-safetyDie Änderung trivial ist und keine typisierte Oberfläche hat
Ausnahmen, Validierung, Bereinigung, Wiederholungen, Batch-Fehlerpy-error-handlingKein Fehlerpfad geändert wurde
Defaults, Konfiguration, Ressourcennutzung, ORM/API-Grenzen, gemischte I/O/Geschäftslogikpy-anti-patternsDie Änderung nur Dokumentation/Konfiguration betrifft
async def, Ereignisschleifen, FastAPI/httpx/aio*, Aufgaben, Abbruchpy-async-patternsDas Projekt/die Änderung rein synchron ist
Formatierung, Namen, Importe, Docstrings, Lint-/Typ-Konfigurationpy-code-styleDie Tool-Ausgabe dies bereits abdeckt oder die Überprüfung auf Korrektheit beschränkt wurde

Portabilitätshinweis

Die Spalte „Laden“ zeigt an, welche Regeln des spezialisierten Skills für jeden Änderungstyp angewendet werden sollen. Wie Sie auf diese Regeln zugreifen, hängt von Ihrer Agentenlaufzeit ab:

  • Dynamisches Laden: Wenn Ihr Agent das Aktivieren von Skills während der Sitzung unterstützt, machen Sie den benannten Skill auffindbar und aktivieren Sie ihn, wenn die Routing-Tabelle seinen Gültigkeitsbereich signalisiert.
  • Statische Checkliste: Lesen Sie die SKILL.md-Datei des spezialisierten Skills direkt aus dem Skills-Verzeichnis und wenden Sie deren Regeln als Überprüfungs-Checkliste an.

Beide Ansätze führen zum gleichen Überprüfungsergebnis. Die Routing-Tabelle ist der Entscheidungsbaum; der spezialisierte Skill stellt den Regelsatz bereit.

Überprüfungsausgabe

Führen Sie mit Bugs und Verhaltensrisiken. Halten Sie reine Stil-Ergebnisse hinter Korrektheits-Ergebnissen. Bevorzugen Sie bei Legacy-Code umsetzbare, wirkungsvolle Probleme gegenüber breiten Modernisierungsratschlägen.

Verwandte Skills