MCP 汇报工具

Jarvis 会向支持的编码运行时注入一组工作会话可用的 MCP 汇报工具。工作会话可以汇报关键状态，而不必把完整工具输出倒进主聊天。

定义

MCP 汇报工具是 Jarvis 中工作会话到人的信号通道。编码会话在取得进展、遇到阻塞、需要决策或缺少上下文时，可以通过这些工具推送结构化更新。

核心工具包括：

report_progress
notify_blocked
ask_human
request_context

为什么需要它

大多数编码运行时已经会工作，但缺少一个干净的外部监督通道。Jarvis 增加 MCP 汇报工具，让工作会话可以：

汇报有意义的里程碑，而不是持续刷屏；
在阻塞发生时立刻升级；
提一个精确问题，而不是静默失败；
请求缺失上下文，让操作者不用猜。

主聊天因此成为控制面，而不是终端归档。

工作方式

Jarvis 启动或配置支持的工作会话时，会让这些汇报工具在该运行时中可用。工作会话可以在正常执行过程中直接调用。

工具角色

工具	用途	典型时机
`report_progress`	发送简短进展更新	完成里程碑或一个分支的工作
`notify_blocked`	标记会话已阻塞并解释原因	工作会话无法安全继续
`ask_human`	请求决策或缺失指令	存在多个合理路径，需要人选择
`request_context`	请求额外文件、历史或外部事实	继续前缺少上下文

人工决策与阻塞流

典型升级流程：

工作会话发现自己不能有信心地继续。
它调用 notify_blocked、ask_human 或 request_context。
Jarvis 把报告以结构化形式插入主聊天。
操作者阅读问题或阻塞原因。
操作者回答、补上下文或派发下一步。
工作会话继续执行，后续进展通过 MCP 汇报和摘要胶囊反映。

这也是 Jarvis 能同时监督多个会话，而不把每个工作会话都变成人工看守任务的核心原因。

失败模式

工具不可用：运行时可见，但当前没有配置主动汇报。
工作会话不调用工具：会话仍可能运行，只是不会主动汇报。
汇报延迟：你读到消息时，会话状态可能已经变化。
问题不具体：模糊的 ask_human 仍需要打开会话检查上下文。

MCP 汇报应视为结构化告警，而不是唯一事实来源。

相关页面