用途:当用户请求或需求含糊、需要多轮提问才能落地时使用。典型场景包括模糊的功能请求(如“加个登录功能”)、不完整的缺陷报告(如“导出坏了”)以及描述不足的任务(如“让应用更快”)。若要做战略/规划盲点分析,应使用 unknown;若要做内容与形式的重新框定,应使用 metamedium。
主要能力:核心原则是把假设当作选项,使用 AskUserQuestion 进行澄清,而不是开放式自由文本提问。例如不要问“你想要哪种登录”,而应给出 OAuth / Email+Password / SSO / Magic link 等可测试的意图解释。流程分为四阶段:诊断歧义(范围、行为、数据/接口、约束/优先级、成功标准);迭代澄清(每轮恰好 4 个问题、每题恰好 4 个选项,最后一个问题的最后一个选项必须是“澄清完成——按当前理解继续”,4 个问题在一次 AskUserQuestion 调用中批量提交,总轮数受 --max-iterations 限制);完成检查(用户选择澄清完成选项或达到最大轮数即停止);前后对比总结(输出目标、原因、范围、约束、成功标准及决策表,并在真正完成时输出 <promise>CLARIFICATION COMPLETE</promise>)。
使用方式:解析输入 REQUIREMENT(必填)与 --max-iterations N(默认 3)。初始化时创建 .claude/clarify-vague.local.md,写入 active、iteration、max_iterations、original_requirement、started_at 等字段,并确认激活;取消使用 /cancel。
限制:资料未提供该技能的收费、价格、平台支持范围或效果保证;问题设计需保持中立、每题只针对一个歧义轴、保留用户原意,且仅在澄清真正完成时才输出完成承诺。