问题排查修复

解决什么问题

很多 bug 修复只停留在单点改码：字段补齐后没有检查其他 Model，接口验证修复后没有同步测试，权限问题修完也没有归档经验。这类修复容易回归，也难以复用到相似问题。

problem-solver 面向开发编程中的缺陷修复，强调先定位根因，再扩大扫描、补充测试并沉淀经验，避免只修当前报错点。

核心流程

• 接收问题：记录现象、影响范围和严重等级。
• 5Why 根因分析：从表面错误追到真实原因。
• 举一反三扫描：检查 Model 字段、API 验证、前端列显示、权限中间件等同类问题。
• 需求与测试同步：结合 PRD / Spec 分析期望行为，并补充或更新自动化测试用例。
• 最小改动修复：按影响模块做精准修改，分析 Model、Controller、Service、前端组件、中间件和数据库迁移的测试范围。
• 按需测试与循环修复：只执行受影响模块的 API 或 UI 测试，发现问题则回到根因分析继续修。
• 经验归档：将复盘写入 .learnings/LEARNINGS.md。

适用边界

它适合已有代码库中的接口缺陷、前端显示错误、权限问题、Model 字段缺失等可定位问题。它不是调试工具本身，也不会替代真实测试环境；如果缺少需求文档、自动化脚本或 UI 测试条件，相关步骤需要人工补齐。