SuperAPI AI 工具集

clarify-unknown

办公与效率

查看项目

更新于 10-16 05:58

技能介绍

用途

该技能用于在用户提供战略、计划或决策文档时,表面化其中的隐藏假设和盲点。其核心是“已知/未知”四象限框架,以及假设驱动的提问方式。当需要对战略或规划文档进行审视、面对方向不清晰或含隐藏假设的决策,或任何“我们不知道什么”比“我们知道什么”更重要的情境时,可使用本技能。

对于具体需求澄清(功能请求、缺陷报告),应使用 clarify-vague 技能;对于内容与形式的重新框定(在某一形式内优化还是发明新形式),应使用 clarify-metamedium 技能。

核心原则:假设即选项

R1/R2/R3 中的每个问题都必须使用 AskUserQuestion 工具,不得以纯文本提问。结构化格式强制执行“假设即选项”,并限制选择疲劳。

以选项形式呈现假设,而非开放式问题。假设本身就是分析——通过设计好的选项,80% 的分析工作在用户回答前就已完成。用户的任务是确认、纠正或带来意外。

反面示例:“为什么你不能做视频内容?”——开放式问题,负担高。 正面示例:“时间 / 技能缺口 / 没有来宾 / 门槛高”——可多选一个或多个。

每个选项都是关于用户情况的可检验假设。使用 multiSelect: true 捕获复合原因。“其他”始终可用,以接收框架外的回答。

三轮深度模式

  • R1:验证草稿象限。3-4 个问题,宽泛,覆盖所有象限。
  • R2:深入薄弱点。2-3 个问题,有针对性,跟随 R1 回答。
  • R3:确定执行细节。2-3 个问题,具体,可选。

关键点:第 N 轮的问题必须由第 N-1 轮的回答生成,绝不跨轮使用预先准备的问题。总问题数限制在 7-10 个。

协议

第一阶段:接收。提供文件时,读取并提取目标、组件、隐含假设、缺失要素。仅提供主题关键词时,直接以 R1 问题开始以确立范围;第三阶段的草稿会更粗糙,但 R1 会纠正它。

第二阶段:上下文。收集相关上下文以发现“未知的已知”——用户可能未意识到的资产:用 Glob 查找相关文件(CLAUDE.md、README、决策记录、过往分析);读取项目上下文(近期目标、团队结构、进行中的计划);识别未充分利用的资产(未使用的现有工具/技能、过往项目中可复用的模式、未被利用的团队专长)。此处发现的条目会成为 UK 候选和 R1 问题中的选项。

第三阶段:草稿 + R1 问题。生成初始四象限分类,草稿刻意粗糙。R1 的目的是纠正它,而非确认它。倾向于将不确定项归类为 KU 而非 KK。设计 R1 问题以测试象限边界,将所有 R1 问题批量放入单个 AskUserQuestion 调用(最多 4 个问题):

  • KK:“这真的确定吗?”
  • KU:“最薄弱的环节在哪里?”
  • UK:“存在但未被使用的是什么?”(基于上下文发现)
  • UU:“最大的担忧是什么?”(风险场景作为选项)

第四阶段:深化 + R2 问题。分析 R1 回答,找出最不确定的区域并深入。R2 触发条件:复合回答(杂乱区域)、意外回答(草稿错误)、选择“其他”(框架外)。详细的 R2 问题类型见 references/question-design.md。

第五阶段:执行 + R3 问题(可选)。优先级确定后,为最重要的条目确定执行细节。若 R2 已提供足够细节则跳过。

第六阶段:输出手册。生成结构化的四象限手册文件。完整输出模板见 references/playbook-template.md。

输出结构:

  • 标题:{主题}:已知/未知四象限分析
  • 当前状态诊断
  • 四象限矩阵(ASCII,含资源占比)
    1. 已知的已知:系统化(60%)
    1. 已知的未知:设计实验(25%)——每个 KU:诊断 → 实验 → 成功标准 → 截止日期 → 升级条件
    1. 未知的已知:杠杆化(10%)
    1. 未知的未知:设置天线(5%)
  • 战略决策:停止做什么
  • 执行路线图(逐周)
  • 核心原则(3-5 条决策标准)

资源占比(60/25/10/5)为默认值,可根据上下文调整。例如,探索产品市场契合度的初创公司可能分配 40% 给 KU、30% 给 KK。

反模式

  • 开放式问题
  • 每个问题 5 个以上选项(造成选择疲劳)
  • 设计 R2 时忽略 R1 回答(表演式提问)
  • 所有象限深度相同(浪费时间、失去焦点)
  • 没有“停止做什么”部分

示例

输入:增长战略文档。

R1:收入来源?→ 工作坊。最薄弱环节?→ 业务→知识。阻碍?→ 技能缺口 + 门槛高(多选)。最大担忧?→ 执行分散。

R2(由“执行分散”驱动):要放弃什么?→ 产品开发。为什么没有知识→内容?→ 无流程 + 无时间 + 难以抽象。角色清晰吗?→ 不清晰。

R3:视频格式?→ 屏幕录制。复盘阻碍?→ 不知道要捕捉什么。什么内容有共鸣?→ 原始发现。

关键发现:不需要抽象——原始洞察效果更好。将三重瓶颈压缩为 15 分钟流水线。

规则

  • 假设而非问题:每个选项都是可检验的假设
  • 回答驱动深度:R2 来自 R1,R3 来自 R2
  • 最多 7-10 个问题:超过则会疲劳
  • 停止 > 开始:始终包含“停止做什么”
  • 升级或终止:每个 KU 都有升级条件和终止条件
  • 原始 > 完美:鼓励最小可行实验,而非完美计划
  • 草稿可丢弃:初始象限旨在被纠正

附加资源

参考文件:

  • references/question-design.md——每轮的详细问题类型、触发条件及 AskUserQuestion 格式指南
  • references/playbook-template.md——完整输出模板及逐节指南