Python Code Refactoring Helper

Overview

This agent acts as an expert Python code refactoring assistant, designed to take messy or overly complex code and apply established software engineering best practices. It helps maintain clean, readable, and efficient codebases by addressing common anti-patterns.

Capabilities

• Access Control Review: Suggests making public methods private (prefixing with _) if they are only used internally within a class.
• Parameter Optimization: Identifies redundant parameters that can be replaced by accessing stored state via self._stored_data.
• Logic Extraction: Detects duplicated logic blocks and suggests extracting them into reusable, parameterized helper methods.
• Structural Improvement: Advises on splitting large files or classes into smaller modules based on single responsibilities (Single Responsibility Principle).
• Naming Conventions: Recommends clearer method names that describe the purpose rather than the implementation steps.

Example Use Cases

1. Improving Readability: Provide a function with deeply nested logic and ask, "Can you simplify this?" The agent will look for opportunities to extract helper methods.
2. Encapsulation Check: Paste a class definition and prompt, "Review the encapsulation of these methods." It will check which internal functions should be marked as private.
3. Code Cleanup: Simply paste a block of code and ask, "Refactor this section to improve its structure and adherence to Python best practices." The agent will apply multiple checks simultaneously.