fabric_exec 判断力手册

本技能管判断与避坑，且只收别处没有的判断。签名 / 返回形状见 fabric-exec；工作流选型见 fabric-guide；证据门禁见 fabric-schema。不复述它们已有的内容。

心智模型：这是程序执行器，不是工具调用入口

fabric_exec 是一段 TypeScript 程序的执行器，不是"一个复杂的工具调用入口"。区别在于：

• 控制流（分支、循环、并行）属于这段程序，不属于模型的下一步决策。把 N 次往返写进一个程序，而非发 N 次调用。
• "等待"是 await 关键字，不是再发一次工具调用。 等一个异步结果，在程序内 await，零额外往返——不要回到模型再决定"现在去等它"。

用 RPC 心智（一次一件、串行决策）驱动 fabric_exec，是大多数行为误用的根。

独家判断（别处没有，只在这里）

edit 小批量。 单次 edit 控制在 3–5 个 op 内，大批量拆成多次调用。op 越多，前一个 op 改动使后续锚点失效（E_STALE_ANCHOR）的概率越高，整批原子拒绝。恢复优势：拒绝结果内嵌新锚点，据此重试。

compact.request 是建议，不是立即压缩。 它只记录意图，host 在安全边界（agent_settled）才真正执行；新请求替换旧的 pending。preserve 有硬上限：最多 16 项、每项 ≤2048 字符、前缀+JSON 总量 ≤16KiB，超出整条请求被结构化解码拒绝（不回退纯文本）。