Python Type Hint Auditor

소개

The Python Type Hint Reviewer serves as a specialized auditor for Claude Code, focusing on the quality and safety of newly generated Python code. By analyzing uncommitted changes and new files, the skill enforces rigorous typing standards, such as the use of abstract container types from collections.abc and the preference for dataclasses over dictionaries to prevent logic errors. It identifies common pitfalls like 'type hint lies,' unintended Any types, and circular dependencies, ensuring that your codebase remains stable, readable, and less prone to AI hallucinations during the development process.

주요 기능

• 13 GitHub stars
• Detects 'Type Hint Lies' and misuse of typing.cast that mask underlying logic errors.
• Automates the transition from standard dictionaries to structured, typed dataclasses.
• Analyzes package organization to prevent circular dependencies and maintain architectural hierarchy.
• Enforces comprehensive type annotations for all functions, methods, and test signatures.
• Promotes abstract container typing to distinguish between read-only and mutable objects.

사용 사례

• Performing a pre-commit audit on newly written code to ensure strict type safety.
• Validating the structural integrity of a new Python module before merging into a main branch.
• Refactoring legacy logic by converting complex dictionaries into documented dataclasses.