24.4 观察与调试
面向经管学生、研究者与从业者的 AI 智能体设计教材
前三节解决了”怎么配”的问题，本节解决”配了但没跑通怎么办”。调度流程涉及管家、Skill、acpx、Opencode 多个环节，任何一环出问题都会导致任务失败。好消息是，管家提供了透明化工具，让你看到它在做什么、在哪一步卡住了。
打开操作实况：/verbose full
默认状态下，管家的调度过程对你不可见。它调用了哪个 Skill、读了哪份配置文件、给 Opencode 发了什么 prompt，这些中间步骤都被折叠了，你只看到最终结果。
在微信对话中发送 /verbose full，管家会把每一步操作作为单独消息发送出来。
每条消息对应一步操作，你可以清楚地看到管家查了哪些文件、走了哪条路由、给 Opencode 发了什么指令。
配置完成后，建议先用 /verbose full 跑几个任务，确认管家的路由判断符合预期。一旦确认路由准确，发送 /verbose off 关闭实况模式，回到简洁的交互体验。
中断调度：/stop
当管家调度了专家但你发现方向不对、任务描述有误、或执行时间过长时，发送 /stop 可以立即中断当前任务。
中断后管家会汇报当前状态：哪些步骤已完成、哪些被中断。已保存的中间产出不会丢失。
常见故障与排查
表现：你发了一个项目级任务，但管家直接用自己的知识回答，没有进入项目目录。
排查方向：spec/DISPATCH-EXPERT.md 的分流规则没有覆盖这类任务，或者 MEMORY.md 里缺少指向 spec/DISPATCH-EXPERT.md 的索引链接。用 /verbose full 重新发送，看管家有没有读取 spec/DISPATCH-EXPERT.md。
表现：管家说”正在调度 Opencode”，但长时间没有结果返回。
排查方向：Opencode 可能没有安装，或者不在系统 PATH 中。用 /verbose full 查看管家构造的命令是否正确。如果使用 acpx 调度，确认 acpx 已安装（npm install -g acpx@latest）。
表现：Opencode 做完了，但产出和你想要的差距很大。
排查方向：两个层面。一是管家侧：需求没澄清就直接调度，检查 spec/DISPATCH-EXPERT.md 中对应场景是否要求先走 brainstorming。二是专家侧：专家的能力取决于项目目录里的上下文。检查项目的 AGENTS.md（或 CLAUDE.md）是否写清了规则，专家的 Skill 是否配置到位。专家做的不符合预期，大概率不是管家调度有问题，而是项目的上下文和 Skill 没有准备好。
表现：管家尝试调用 dispatch-expert Skill，但会话创建失败。
排查方向：两个常见原因。一是 acpx 没有安装，运行 npm install -g acpx@latest 解决。二是 projects/INDEX.md 中的项目路径写错了，Opencode 找不到工作目录。确认路径存在且拼写正确。
跳过 brainstorming 的代价
实践中最常见的问题不是技术故障，而是你急着要结果，直接说”帮我做 XX”，跳过了需求澄清阶段。
Opencode 按自己的理解做了一版，但配色、指标、布局都不是你想要的。修改这些需要重新调度，时间成本翻倍。
如果走 brainstorming 流程，管家会先问你五个问题：展示哪些指标、什么配色方案、面向谁看、更新频率、布局偏好。三分钟的问答换来一次做对的结果，远比做完再返工高效。
spec/DISPATCH-EXPERT.md 中的分流规则已经把”做一个”、“设计”、“重构”类需求导向完整流程。如果你发现管家跳过了 brainstorming 直接调度，检查规范中的典型场景描述是否覆盖了你的措辞。