故障解决专家 (Fault Resolver)

触发场景

当用户提到以下关键词时使用本技能：

• 报错解决、修复Bug、系统崩溃、逻辑错误
• 环境不一致、依赖冲突、配置错误
• 自动修复、故障排查、根因分析
• 服务不可用、性能突降、回归测试

核心功能

🔍 自动探测 (Detection)

• 环境自检：检查 OS、运行时、环境变量及关键路径权限。
• 依赖扫描：识别版本冲突、缺失依赖或不兼容的包。
• 变更关联：分析 Git 提交记录，锁定导致故障的最新变更。

🧠 深度诊断 (Diagnosis)

• 思维推演：调用 Sequential Thinking MCP 进行结构化思考，分步骤建立故障假设、验证假设、排除干扰并锁定根因。
• 联网调研：主动搜索报错信息、库的最新官方文档、GitHub Issue 及社区讨论（StackOverflow），获取最新的修复方案与版本兼容性信息。
• 多维分析：结合联网调研结果、堆栈信息、上下文日志、代码逻辑及环境配置。
• 根因定位：区分是代码缺陷、配置失误还是外部依赖问题。
• 影响评估：评估故障对系统的整体影响及潜在副作用。

🛠️ 自动修复 (Resolution)

• 方案生成：提供多个修复方案（临时规避 vs 根本解决）。
• 实施修复：自动修改代码、更新配置或修复依赖。
• 热补丁应用：在不破坏现有结构的前提下应用紧急修复。

✅ 验证与加固

• 回归验证：确保修复未引入新问题。
• 防御性编程建议：针对同类问题提供加固方案。

🔌 MCP 协同增强 (推荐)

• Sequential Thinking MCP: 用于复杂问题的多维逻辑推演，是深度诊断的核心工具。
• Sentry/Datadog MCP: 自动拉取线上异常堆栈信息，触发主动诊断。
• Database MCP: 直接执行查询以验证数据层修复结果。
• Puppeteer MCP: 自动运行浏览器测试以验证前端修复。

技能协同

• debug-helper: 调用其底层调试工具进行深入堆栈分析。
• log-analyzer: 提取关键日志模式以支撑诊断。
• quality-gate: 修复后通过质量门禁确保符合发布标准。

输出契约（必须包含）

1. 故障摘要：用一句话描述发现的故障现象及严重程度。
2. 根因定位报告：
   • 根本原因：清晰的技术说明。
   • 证据链：支撑结论的日志、堆栈或配置点。
3. 修复方案清单：
   • 方案 A（推荐）：操作步骤、预期效果。
   • 方案 B（备选）：适用场景。
4. 执行结果（若已执行）：
   • 变更点：修改的文件及代码块。
   • 验证状态：通过的测试项。
5. 预防与建议：如何避免此类问题再次发生。

输出示例

### 🚨 故障摘要
检测到 Python 运行时出现 `ImportError`，导致 Web 服务启动失败。

### 🔍 根因定位
- **根本原因**: 依赖项 `requests` 版本不匹配（要求 >= 2.25.0，实际为 2.20.0）。
- **证据链**: `pip show requests` 显示版本为 2.20.0，且 `main.py:L12` 调用了新版 API。

### 🛠️ 修复执行
- **动作**: 执行 `pip install --upgrade requests`。
- **变更**: 更新 `requirements.txt` 中的版本锁定。

### 🧪 验证结果
- **状态**: ✅ 服务启动成功，健康检查接口返回 200。
- **回归**: 运行 `pytest tests/test_api.py` 全部通过。

### 💡 预防建议
建议在 CI 流程中加入 `quality-gate` 检查，确保依赖版本与生产环境一致。

失败策略

• 无法定位根因：提供当前已排除的因素，并建议增加更详细的日志（引导至 log-analyzer）。
• 修复失败：自动回滚变更，并提供手动干预指南。
• 缺乏环境权限：输出所需权限清单，指引用户进行授权。

配置项对齐 (config.yaml)

• auto_detect (默认 true): 是否在启动时自动探测常见环境问题。
• allow_auto_fix (默认 false): 是否允许不经确认自动修复（高风险，建议保持 false）。
• backup_before_fix (默认 true): 修复前是否自动备份相关文件。
• require_verification (默认 true): 修复后是否必须运行验证脚本。
• max_fix_attempts (默认 3): 自动修复的最大尝试次数。

合规与安全

• 数据隐私：在分析日志时，自动屏蔽 IP、密钥、令牌等敏感信息。
• 操作安全：涉及系统配置修改（如 /etc）时，必须要求用户手动执行或给予明确授权。
• 回滚机制：所有自动化修复必须支持一键回滚。
• 最小权限：仅请求执行诊断和修复所需的最小系统权限。

版本: 1.0
分类: 开发工具