用途：面向安全代码重构的综合性技能，帮助分析代码库改动的影响范围、生成重构清单、进行交互式审查、执行已批准的重构、做质量验证，并生成前后对比报告与指标。
主要能力：影响分析，评估重构范围（低：少于5个文件/局部；中：5-20个文件/模块；高：超过20个文件/跨模块/依赖）；清单生成，按影响分组并标注风险与收益；交互式审查，每项支持 yes/no/back/其他反馈；重构执行，将改动应用到文件并给出 git diff；QA 验证，检查风格、测试、覆盖率、性能；报告，输出前后对比、指标变化与可视化。
输入要求：JSON 格式，包含 codebase（files 含 path、lines、deps，tests，goals 如 improve modularity、reduce complexity）；metrics 为可选基线（覆盖率%、性能毫秒）；数据来自 Claude 工具（Glob/Grep/Bash git status）；要求文件列表准确、git 状态较新。
输出格式：checklist.json（含 id/impact/desc/risks）、review_decisions.json（每项用户选择）、changes.diff（已执行 diff）、qa_report.json（通过/失败指标）、final_report.md（完整对比，含表格与图表）。
使用方式：可用 @[code-refactoring-assistant] Analyze current repo for low-impact refactors to improve modularity, then review checklist. 脚本 refactoring_assistant.py 编排 6 个核心类：ImpactAnalyzer、RefactoringPlanner、ReviewInterface、RefactoringExecutor、QAValidator、RefactoringReporter。
最佳实践：从低影响项开始；执行前备份仓库（git stash/分支）；提供测试路径以保证 QA 准确；高影响项人工审查；迭代：重构→QA→报告→重新分析。
限制：依赖 Claude 工具进行真实文件访问（不直接写文件系统）；示例中为模拟执行，真实使用依赖 git/Bash 工具；复杂部署需人工监督；Python 沙箱限制（除标准库外无外部库）。