技能 python-style-guide

🐍

python-style-guide

Name: python-style-guide
Author: CodingKaiser

安全 ⚙️ 外部命令⚡ 包含脚本🌐 网络访问

Python-Stilrichtlinien anwenden

Diese Skill umfasst umfassende Programmierrichtlinien für Python, basierend auf dem Python-Styleguide von Google. Sie gewährleistet Konsistenz, Lesbarkeit und Wartbarkeit von Code in Python-Projekten.

支持: Claude Codex Code(CC)

📊 71 充足

下载技能 ZIP

在 Claude 中上传

前往设置 → 功能 → 技能 → 上传技能

开启并开始使用

测试它

正在使用“python-style-guide”。 Schreibe eine Python-Funktion zur Fakultätsberechnung mit korrekten Type Hints und Docstring.

预期结果:

Funktion verwendet Type Annotations: def factorial(n: int) -> int
Docstring folgt dem Google-Stil mit Args- und Returns-Abschnitten
Code befolgt Namenskonventionen für Funktionen

正在使用“python-style-guide”。 Überprüfe diese Python-Klasse auf Stil-Probleme.

预期结果:

Klassenbenennung folgt der CapWords-Konvention
Methoden verwenden lower_with_under-Namensgebung
Imports sind gruppiert: stdlib, third-party, local

正在使用“python-style-guide”。 Zeige, wie man Exceptions in Python korrekt behandelt.

预期结果:

Vermeide bare except:-Klauseln
Verwende spezifische Exception-Typen wie ValueError
Exceptions bei Bedarf mit raise erneut auslösen

安全审计

安全

v5 • 1/16/2026

This is a documentation-only skill containing markdown guidelines for Python code style. All 318 static findings are false positives: cryptographic alerts triggered by strings like 'A1'/'A2' in examples, backtick execution alerts from markdown code fences, and reconnaissance alerts from file operation examples. No executable code, network operations, or command execution.

已扫描文件

2,109

分析行数

发现项

审计总数

风险因素

⚙️ 外部命令 (267)

⚡ 包含脚本 (3)

references/antipatterns.md:123 references/antipatterns.md:128 references/antipatterns.md:123

🌐 网络访问 (3)

references/docstring_examples.md:334 skill-report.json:6 SKILL.md:9

审计者: claude 查看审计历史 →

质量评分

架构

100

可维护性

内容

社区

100

安全

规范符合性

你能构建什么

Konsistenten Python-Code schreiben

Etablierte Namens-, Formatierungs- und Dokumentationskonventionen für sauberere Codebasen befolgen.

Python-Einreichungen überprüfen

Als Referenz-Checkliste bei der Überprüfung von Python-Pull-Requests auf Style-Konformität verwenden.

Python-Best-Practices lernen

Dokumentierte Muster studieren, um Python-Kenntnisse zu verbessern und professionellen Code zu schreiben.

试试这些提示

Grundlegende Python-Formatierung

Schreibe Python-Code nach dem Styleguide. Verwende 4 Leerzeichen für Einrückung und 80 Zeichen Zeilenlimits.

Type Annotations

Füge Type Annotations zu dieser Python-Funktion hinzu. Verwende Python 3.10 Union-Syntax mit dem | Operator.

Docstring-Standards

Schreibe Google-Style-Docstrings für diese Python-Funktionen. Füge Abschnitte für Args, Returns und Raises hinzu.

Code-Stil überprüfen

Überprüfe diesen Python-Code gegen den Styleguide. Identifiziere Probleme bei Imports, Namensgebung und Dokumentation.

最佳实践

Verwende Type Annotations für alle öffentlichen Funktionssignaturen, um die Codelesbarkeit zu verbessern und statische Analyse zu ermöglichen
Organisiere Imports in drei Gruppen: Standardbibliothek, Third-Party und anwendungsspezifische Module
Schreibe Google-Style-Docstrings für alle öffentlichen Module, Klassen und Funktionen mit Args-, Returns- und Raises-Abschnitten

避免

Verwendung von veränderbaren Objekten als Standardargumentwerte (def foo(items=[]):) verursacht Shared-State-Bugs
Verwendung von bare except:-Klauseln (except:) fängt alle Exceptions ab, einschließlich KeyboardInterrupt, und versteckt Bugs
Vergleich mit None mit == statt mit is (if x == None:) nutzt die Python-Singleton-Semantik nicht

常见问题

Welche Python-Version zielt dieser Styleguide ab?

Der Guide verweist auf Python 3.6+-Features wie f-Strings und nennt gleichzeitig Alternativen für ältere Versionen.

Linted oder formatiert dieser Skill meinen Code?

Nein. Diese Skill bietet Richtlinien und Referenzen. Verwende pylint oder black für eigentliches Linting und Formatieren.

Sind die Regeln verbindlich oder flexibel?

Priorisiere Konsistenz mit existierendem Code. Verwende diese Richtlinien als Standardwerte bei neuen Projekten.

Wie sieht es mit der Import-Formatierung aus?

Gruppiere Imports nach Quelltyp, alphabetisiere innerhalb der Gruppen und verwende Absolute Imports für Klarheit.

Sollte ich das typing-Modul oder eingebaute Generics verwenden?

Bevorzuge eingebaute Generics (list, dict) über typing-Äquivalente für Python 3.9+.

Wie streng ist das 80-Zeichen-Zeilenlimit?

Verwende 80 Zeichen als Standard. Erlaube Ausnahmen für Imports, URLs und ungebrochene Strings.

开发者详情

作者

CodingKaiser

许可证

Complete terms in LICENSE.txt

仓库

https://github.com/CodingKaiser/claude-kaiser-skills/tree/main/python-style-guide

引用

main

文件结构

📁 references/

📄 advanced_types.md

📄 antipatterns.md

📄 docstring_examples.md

📄 LICENSE

📄 SKILL.md