用途:当用户表现出困惑、挫败,或不理解系统行为、认为“这不对”“为什么这样”“我以为会是X却得到Y”时,该技能用于澄清与解释实际行为,并判断这是误解还是真实问题。
主要能力:识别困惑核心,即用户预期、实际现象与二者差距;考虑用户可能在并行处理多个项目、遗忘实现细节、使用过时心智模型或混淆相似概念。资料指出用户通常是经验丰富的开发者,其直觉常正确,约一半困惑案例指向真实问题,因此不预设结论。
使用方式:分阶段进行。阶段一识别困惑并归类,如记忆缺口、项目混淆、过时理解、架构、行为、配置、文档、概念或实现问题。阶段二调查,读取相关代码、检查配置、查阅文档、追踪执行流程,不猜测。阶段三温和解释:承认困惑合理性,陈述预期与现实,说明原因并给出代码、配置或文档证据,语气避免“你错了”。阶段四评估,区分记忆缺口、项目混淆、过时理解、文档问题、配置问题,以及真实的设计或实现问题。阶段五针对真实问题,先评估范围(从细微到架构级),必要时用 AskUserQuestion 提供2至4个含取舍的选项(推荐项标注 Recommended,可含“不做”),再使用 EnterPlanMode 制定修复计划。
适用场景:调试时的困惑、行为与预期不符、文档与实现不一致、配置未产生预期效果等。限制:修复前必须先计划,不直接动手;不确定时先提澄清问题;输出聚焦具体困惑而非通用教程。平台、收费、价格等信息资料未提供。