workflow-route-mapper

探索路线图

当前状态与工作过程

让用户随时看懂正在解决什么、哪些事已有依据、下一步是什么、是否需要自己决定；回看时能追溯重要转向的原因和结果。让当前模型与接手模型知道任务为什么开始、有效要求怎样形成、哪些路线已经尝试，以及当前行动依据什么。

同一个 Skill 负责两种视图：进行中的任务用简短的当前位置和必要的右侧面板；需要跨任务回看时用路线图文档保存演变。它们表达同一任务，不各自形成一套相互竞争的目标或结论。普通纠偏、偏好和任务边界的恢复由 workflow-state-distiller 处理；状态已清楚时直接沿用。两者都需要时，先确定当前有效状态及改变路线的证据，再更新路线图。

过程记录说明围绕什么问题开展工作、取得什么材料、怎样比较与选择、做出和验证了什么，以及结果如何影响下一步。按实际阶段和已有轮次组织，关键取舍保留简明理由与依据入口。任务负责人核对当前摘要和委派结果后更新，记录以已取得的材料、行动和观察为依据。

一次性小任务不必启动面板。任务已有持续维护的 HTML 时，把当前位置和必要的路线变化更新到同一页，沿用现有查看入口。没有已有页面而用户明确要求右侧持续显示时，按 右侧面板的运行与数据 启动。若宿主没有可用的右侧浏览器，就在聊天中给出同样简短的当前位置，并保存必要的回看材料。聊天里的关键判断和问题仍由任务负责人直接告诉用户。

长任务按 分层展示工作过程 安排当前摘要、阶段查找、可读记录和依据详情。历史增长时，通过分组、选择和检索进入相关过程；重要结果、未决事项与关键改道原因留在相关摘要中。Mermaid 用于需要看清分叉或依赖的局部关系，同一批记录也可以提供全局关系总览。与 teach-and-explain 协作时，在对应决定和成果旁补足概念、原因与影响。

主动记录与接续

当任务开始积累会影响后续行动的背景、选择或探索结果时，主动建立或更新过程记录。是否调用取决于这些信息对后续判断的作用，任务尚短但已有关键取舍时也应使用。先沿用项目已有记录和入口，内容少时用简短正文；面板和图形按实际阅读需要采用。

记录起点时写清用户要解决的问题、成果用途与必要背景，并保留当前有效要求、约束、决定及理由。继续工作、交接或恢复上下文时，先读当前摘要，再沿相关选择回查决定性材料，据此安排后续行动。被替代的决定关联到当前决定。

全局假设与当前假设

过程记录同时写明当前任务的全局假设和当前假设，并纳入所有未经询问而采用的假设，便于用户检查和模型接续。

• 全局假设： 支撑整个任务目标、范围、成果用途或整体路线的前提，影响可能跨越多个阶段。放在任务概览中，后续相关选择引用同一项记录。
• 当前假设： 支撑当前阶段、试验或下一步行动的局部前提。放在当前状态或相应选择旁，注明适用范围；阶段变化后检查是否仍适用。

每项假设写清具体内容、采用依据、当前确认状态，以及不成立会影响哪些决定或工作。区分待用户确认、待验证、已确认、已否定或已替代；已确认项注明确认者或验证证据。能查明的事实由 agent 调查，涉及用户偏好和重要取舍的前提向用户取得确认。

新证据或用户反馈改变假设时，同步更新受影响的结论、路线、当前摘要和下一步。保留改变重要判断的旧假设及修正原因，当前概览呈现仍有效的前提与尚待确认的部分。每轮交流末尾展示未经询问而采用的假设及其当前状态，相关记录与对话保持一致。没有这类假设时如实说明。

用户首先看到什么

侧栏首屏优先回答：现在做什么、进度内容何时更新、是否等用户行动、下一步是什么。历史路线放在其后。当前目标和当前行动各有一句清楚的话；“已确认”只写有证据的结果，“还在查”只写尚未解决的问题。当前描述只写一个正在进行的动作，下一步写它之后的动作，不重复。一个字段不要拼接几件无关的事。

每次更新这些当前字段时，作为一组核对其一致性，并记录内容真正变化的时间。页面成功检查文件只说明连接正常，不能当作进度刚更新。长时间没有新内容时如实显示多久未更新，不推断代理已停住。进入等待用户、暂停、完成或受阻等状态时，写清目前由谁行动。

页面文案使用用户能感知的对象、动作和结果。内部命令、配置和模型编号只有在它们影响用户判断时才出现。任务本身已有 A.1.1 一类编号时沿用，不再给用户增加 1A/2B 等第二套路线编号；界面上的普通顺序数字仅帮助定位历史。

什么时候改变路线

路线节点只保留会改变后续判断的内容：目标实质修正、独立候选、改变判断的证据、新边界、改道、暂停、吸收、废弃、恢复，以及当前路线和下一步。失败虽已修复，只要留下边界或否决了路线，仍保留。临时命令错误、已解决且不再影响判断的杂事和完整工具日志不进入路线。试着删掉一项：若仍能解释为什么走到当前路线，就不记录它。