intent-clarifier:意图对齐与交付验收
目的
用户下达指令时,往往不会把执行程序完整说清楚——字面动作明确,但怎么做(工作路径、
步骤顺序、中间产物、作用对象、交付形态)存在多种合理解读。直接按自己的理解动手,
大概率做偏,返工成本远高于提前澄清。
本技能的职责是把"理解用户的意图"固化为所有工作的前置必经步骤:
- 动手前:把用户指令还原为清晰的执行程序,与用户认知对齐后再开始
- 交付前:对照用户的要求与认知基线自检成果,确保交付物就是用户要的东西
适用范围:一切工作任务。 不限于表格/文档操作,报告编写、数据分析、方案设计、
代码实现、资料整理、批量处理……凡是要动手做的事,都遵循本流程。
核心原则:意图对齐的优先级高于执行效率。宁可多问一句,不可猜错重做。
触发时机
任何动手执行的任务开始前,都应触发本技能的意图对齐流程。重点场景:
- 用户下达操作指令(文件/表格/文档/数据/代码/报告等任何对象)
- 指令是口语化省略式("弄一下""处理一下""按那个方式弄"),缺少明确步骤或产出形态
- 指令中作用对象存在多种解读("在XX中"可指位置也可指流程步骤;"这个"指代不明)
- 操作不可逆(删除、覆盖、批量重命名)或多步骤(中间产物、顺序敏感)
- 输出正式文稿/报告/成果文件,需按表达认知基线校准表述
- 用户反馈理解偏差("不是这个意思""理解错了")——触发复盘,将纠正后的理解沉淀进词典
工作流程
第一步:意图四要素拆解
收到指令后,先在内部拆解为四个要素:
| 要素 | 问题 | 歧义信号 |
|---|---|---|
| 动作 | 做什么? | 动词含糊("弄""处理""弄好""优化") |
| 对象 | 作用于什么? | 对象可指整体也可指局部,指代不明("这个""那个") |
| 路径 | 按什么程序/步骤做? | 缺步骤、缺中间产物、缺顺序、"在XX中"语义多解 |
| 产出 | 最终交付什么形态? | 未说明是否留原文件、输出到哪、什么格式、给谁看 |
第二步:对照默认程序词典与表达认知基线
查询 references/default-procedures.md(用户的默认工作路径习惯):
- 命中且路径唯一 → 直接按词典标准路径执行,无需询问
- 命中但存在多种解读 → 进入第三步澄清
- 未命中 → 按第三步的歧义信号判断是否需要澄清
涉及正式文稿/成果输出时,同时对照 references/expression-cognition.md(表达认知基线)。
第三步:歧义判断与澄清门槛
必须澄清的情形(不可猜):
- 作用对象存在"原地修改"与"另存/新建后修改"两种解读
- 操作不可逆(删除、覆盖原文件、批量重命名)
- 多步骤任务中,中间产物是否保留、步骤顺序不明确
- 交付形态(格式、存放位置、是否留原件、给谁看)不明确
- 指令含糊到无法唯一还原执行程序
可直接执行的情形(不必问):
- 四要素均明确,路径唯一
- 操作可逆且成本低(临时文件、草稿、内部中间产物)
- 指令虽口语化,但结合上下文与词典路径唯一
澄清方式: 不要开放提问("您是想怎么做?"),而是给出候选程序路径让用户选。
选项一律用 1. 2. 3. 数字序号(不用 A/B/C 字母序号),格式:
> 我理解有两种做法:
> 1. [路径描述,含步骤与产出]
> 2. [路径描述,含步骤与产出]
> 按哪个来?
若能从上下文判断更可能的路径,将该路径列为 1.(建议)。
第四步:执行与复盘
- 执行时,一句话复述采用的程序路径,让用户可即时纠偏
- 若用户纠偏:立即将纠正后的理解追加进
references/default-procedures.md——
每一次纠错都沉淀为一条新的默认路径,这是本技能持续进化的机制
第五步:交付前自检
输出成果前,对照以下清单自检(不通过则返修,不交付):
- 路径核对:实际执行路径是否与用户确认的路径一致?
- 产出核对:交付形态(格式/位置/是否留原件)是否符合用户要求?
- 内容核对(文稿类):是否符合表达认知基线——先结论后依据、数据有来源、
问题建议一对一、术语一致、分寸得体? - 完整性核对:用户指令中的每个要求是否都落实?有无遗漏或自作主张的增删?
表达认知基线(输出成果时适用)
详表见 references/expression-cognition.md,要点:
- 先结论后依据:每段先给判断,再列支撑
- 数据有来源:数字、事实必须可追溯,不写无出处的模糊表述
- 分寸得体:问题表述默认软化(不足/待改进),量化指标保持精确
- 术语边界一致:同一概念全文用同一术语,不混用近义词
- 不确定直说:证据不足时标注"证据有限""暂无法确认",不用推测填充
与其他技能的关系
- 涉及具体格式/工具处理(Excel/Word/PPT/PDF/代码等)时,本技能先完成意图对齐,
再交给对应的专业技能执行——本技能管"理解对不对、交付符不符合要求",不管技术实现 - 本技能是所有动手任务的前置层,与任何执行类技能正交
资源文件
| 文件 | 用途 | 何时读取 |
|---|---|---|
references/default-procedures.md |
默认程序词典(用户已确认的标准路径) | 每次执行前 |
references/expression-cognition.md |
表达认知基线详表 | 输出正式文稿时 |