跳转到内容

MCP 工作会话工具

托管编码会话通过 MCP 工具向 Jarvis 汇报状态。工具的目标是让主聊天看到关键进展,而不是复制完整终端输出。

工具 用途
report_progress 汇报进展、完成的步骤或当前正在做的事
notify_blocked 声明阻塞并解释为什么不能安全继续
ask_human 请求用户决策或缺失指令
request_context 请求额外上下文、文件、历史或外部信息
search_kb 可选;查询用户配置的本地知识库

用于短进展。好的汇报应该说明:做了什么、当前状态、下一步是什么。

{
"message": "已完成文档首页中文化,正在运行链接检查。"
}

用于明确阻塞。好的阻塞应包含原因和需要用户做的事。

{
"reason": "缺少目标发布渠道,无法判断是否需要更新下载入口。",
"next_action": "请确认这次只改文档,还是也要改下载 manifest。"
}

用于需要选择的问题。问题应尽量单一、可回答。

{
"question": "文档是否保留英文术语 Runtime,还是统一翻译为运行时?"
}

用于缺少上下文。工作会话应说明需要什么和为什么需要。

{
"request": "需要当前 release workflow 的部署分支规则,以确认文档描述是否准确。"
}

search_kb 是可选本地能力。未配置 KB 时应返回不可用,而不是阻断工作会话。KB 路径和内容属于用户私有数据,不应进入公开文档、日志或 PR。

工作会话汇报应避免:

  • 原样粘贴密钥、token、cookie;
  • 暴露私有路径和服务器地址;
  • 大段复制私有代码或会话 transcript;
  • 把 KB 正文写入公开输出。