用途：把单次 MCP 失败整理成一份 Markdown 缺陷报告，默认针对最近一次相关交互，也可由用户指定某次调用。报告保存于 reports/ 目录，文件名格式为 mcp-bug-<server>-<short-description>-<date>.md。
写前准备：若 KAIROS MCP 服务器可达，调用其 /health 端点（HTTP GET <KAIROS_API_URL>/health）或等价接口并记录响应，用于 Environment 段落中的服务器版本和基础设施组件状态。
报告结构（固定顺序，不可增删）：Summary；Calls and responses；Reasoning；Environment / context；Reproduction；Checklist before saving。
内容要求：Summary 用一句话说明失败、MCP 服务器名、工具或资源。Calls and responses 按时间顺序，对失败流程中的每次调用（activate、每次 forward 尝试、reward）给出请求与响应，请求与响应均为 fenced json 代码块，紧邻排列。重试规则：若以 MAX_RETRIES_EXCEEDED 等重试耗尽结束，必须包含每次重试的请求与响应；retry_count 为 N 就有 N 组请求-响应，不得只列首尾，也不得省略中间成功的响应。
Reasoning：说明每次调用的原因及对响应的解释；当重试大于 0 时，须对每次失败尝试做故障归因，说明 agent 是否遵循服务器 next_action、是否使用最新响应中的 nonce/proof_hash/uri，并分类为 agent error、server error 或 unclear；若因忽略服务器响应导致重试，报告须如实说明，不得把 agent 错误归给服务器。
Environment / context：包含 KAIROS MCP 版本（/health 的 version 字段或连接横幅）、基础设施状态（Qdrant、Redis/cache、embedding，各一行：healthy / unhealthy / degraded / not configured，取自 /health 依赖对象）、操作系统与 IDE 版本、相关配置环境变量名，绝不包含密钥值。Reproduction：最小步骤及一到两句预期与实际。Checklist before saving：Markdown 任务列表。
限制：不得添加结构外的一级段落，不得省略或重排段落，不得省略重试，不得把 agent 执行错误归因给服务器，不得用纯文本或非 JSON 代码块承载请求响应，不得改写 JSON（除敏感信息脱敏），不得包含未脱敏的密钥、令牌、Cookie 或 API Key。