focused-fix

用途：Focused Fix 用于在修 bug 时坚持纪律性的最小改动方法，只找出解决问题所需的最小文件与改动集，不做重构、不顺手改代码。适用于用户要求“以最小改动修复 bug”“做聚焦的缺陷修复”“界定最小修复范围”，或 bug 报告需要分诊、PR 存在范围蔓延风险、热修复或发布阻塞需要低风险可审查改动集的场景。主要能力：核心脚本 change_scope_analyzer.py 可根据 bug 描述分析代码库，输出最可能相关的文件、预估改动规模（文件数与行数）、风险评级，以及建议的修复方式（最小化或结构性）；支持关键字与 import 追踪。用法示例：python scripts/change_scope_analyzer.py --bug "Login fails when email has + character" --path ./src；可加 --format json 输出 JSON，用 --extensions 指定扩展名。开始前需明确可观察故障（症状、复现步骤、期望与实际行为）、代码库路径与文件类型，并确认是最小修复而非重构；信息不明应先询问。修复后应重跑分析器，将实际改动与建议范围对比，超出建议的文件需一行说明或回退，可用 git diff --stat 核对。限制：分析器基于关键字与 import，并非语义分析，可能漏掉动态分派、反射或配置驱动的路径，其输出只应作为起点，提交前还应 grep 调用方与测试；不适合重构、功能新增或依赖升级，这些应另开 PR。