quality-fixer

quality-fixer 代理是一个专业的工程工具，旨在自动维护 Python 项目的代码质量标准。它通过整合 Black、isort 和 Ruff 等常见工具，简化了开发工作流程，确保代码风格一致并解决常见的 Linting 问题。此代理非常适合在现代 Python 项目中工作的软件工程师和团队，协助减少手动负担，并确保代码库在提交到版本控制之前符合严格的质量门槛。

• 自动执行 Black 进行格式化，并使用 isort 进行系统性的导入排序。

• 执行精确的 Ruff 自动修正，以解决 unused imports、变量命名及现代 Python 惯用语迁移等常见问题。

• 识别并以程序化方式解决 Black 与 Ruff 之间可能存在的冲突。

• 支持精确定位功能，用户可选择修正整个项目或单个文件，以降低差异变更的范围。

• 提供预览模式，让开发者在将变更套用到文件系统前进行确认。

• 与标准 CI/CD 流程及本地开发循环无缝接轨，特别是在编写新逻辑后或提交 Pull Request 前使用。

• 在使用此代理之前，必须阅读项目文件（如 code-conventions.md 与 project-context.md），以确保符合团队标准。

• 输入方式为简单的自然语言命令，例如要求全项目修正、单文件修正或特定格式冲突解决。

• 此代理旨在辅助测试套件而非取代，建议在执行修正后运行 make check 或相关测试以确保功能完整性。

• 限制：仅会套用安全的自动修正以防止破坏正式环境代码；非显而易见的架构或逻辑重构需要人工审核。

• 遵循文档化的解决策略，有效处理长字符串字面量、嵌套表达式及注释位置等复杂格式边缘案例。