用途：当智能体失败、输出错误、忽略指令、出现幻觉或行为异常，且原因不像明显代码缺陷时，先检查上下文，因为这是智能体失败排查中回报最高的目标。
适用边界：智能体从未成功过（全新项目）应改用 context-cartography；基础设施错误（API 500、超时）不是上下文问题；harness 中的代码缺陷（模板、解析）应改用 systematic-debugging。
排查流程：第0步先验证“实际上下文”，记录并核对完整组装上下文（系统提示、工具、检索文档、历史），确认各段是否存在、顺序与体积是否符合预期；实际与预期不符时问题多出在上下文组装。第1步观察期望、实际结果、发生频率和起始时间。第2步按下表分类并逐项自测：近期是否改过上下文（回归）、智能体是否缺少所需信息（缺失上下文）、工具定义是否含糊或重叠（工具问题）、信息是否难以被找到（埋没上下文）、指令是否互相矛盾（冲突上下文）、减少上下文是否变好（上下文溢出）、以上皆否（推理失败）。第3步定位并修复，每类都有十分钟内的快速修复与更彻底的整体修复。
常见提示信号：偶发失败强烈提示上下文问题；“过去能用”指向回归；“不知道项目约定”指向缺失上下文；工具选错或参数错误指向工具定义问题；部分指令被遵循、移到顶部就好转指向埋没；输出摇摆或混合指向冲突；上下文越少反而越好指向溢出。复合失败很常见，修好第一类后若未解决应继续排查下一匹配项。
限制与说明：该技能明确区分上下文问题与真正的推理能力限制，只有理想最小上下文下多次仍失败才视为推理失败；对随机系统应多次运行验证，避免一次测试即上线。官方资料未提供具体安装命令、收费与价格、平台支持或效果数据。