xmind

XMIND — 困境梳理 + 新视角方案生成

概述

遇到困境时自动收集当前问题点与项目必读文档，打包交给独立子 Agent，该 Agent 从头理解项目全局后使用 zoom-out 退后一步，以宏观视角给出全新方案。方案被拒绝时，将拒绝原因注入交接包进入下一轮迭代，最多 3 轮。

核心原则： 困境中的 Agent 有思维惯性——它熟悉自己的解决方案，难以自我推翻。独立的新 Agent 不受此惯性约束。

何时使用

症状	示例
同一 bug 修了 2 次仍未解决	"又错了，再查一次……"
发现架构级矛盾但不知如何取舍	"这样改会破坏A，那样改会破坏B"
陷入细节无法判断优先级	"现在该先做哪个？"
需要全新视角审视方案	"有没有完全不同的思路？"

不适用： 单步操作（改一行配置）、已明确方案只需执行。

交接包 Schema（CRITICAL —— 单一事实来源）

子 Agent 工作流和交接包格式均以此 Schema 为准。必填字段缺失时拒绝传递，提示补全。

HandoffPackage {
  // 必填段
  project: {
    name: string            // required
    stack: string           // required, 语言/框架/工具链
    cwd: string             // required, 工作目录
  }
  docs: [{
    path: string            // required
    summary: string         // required, 一句话摘要
  }]                        // required, min 1

  problems: [{
    title: string           // required
    symptom: string         // required, 可观测现象
    attempts: [{
      solution: string      // required, 已尝试的方案
      why_failed: string    // required, 失败原因
    }]
    files: string[]         // 涉及的文件/模块列表
  }]                        // required, min 1

  constraints: {
    no_modify: string[]     // 不能修改的模块
    perf_floor: string      // 性能底线阈值
    compat: string          // 兼容性要求
  }                         // required

  // 迭代段（由反馈闭环自动填充）
  iteration: number          // 当前迭代轮次, 0=首次
  rejections: [{
    round: number
    proposal_title: string
    reason: string           // 用户拒绝原因
  }]

  // 子Agent工作流指令（从 SUBAGENT-WORKFLOW 注入）
  subagent_workflow: string  // required
}

// 验证规则
必填字段缺失 → 拒绝传递 → 提示 "HandoffPackage 验证失败: 缺少 [字段名]"
docs 长度 < 1  → 拒绝传递 → 提示 "至少提供 1 个必读文档"
problems 长度 < 1 → 拒绝传递 → 提示 "至少描述 1 个问题"

子 Agent 工作流指令（subagent_workflow 字段内容，从 SUBAGENT-WORKFLOW.md 注入）：

请按以下步骤工作：
1. 通读 docs 中列出的所有必读文档，理解项目架构、约束和规范
2. 逐个分析 problems，理解为何已尝试的方案失败
3. 调用 zoom-out：绘制模块关系图，用项目术语描述全局架构
   - 若 zoom-out skill 不可用：手动绘制模块依赖图 + 用 constraints 中的术语描述全局
4. 基于宏观理解，提出 1-3 个新方案
5. 每个方案标注：
   - 可行性（高/中/低） + 理由
   - 风险
   - 与已尝试方案的本质区别（不能只是旧方案的微小变体）
6. 考虑 rejections 中的拒绝原因（如有），避免重复被拒绝的路径