SuperAPI AI 工具集

problem-statement

写作与研究

查看项目

更新于 10-16 02:39

技能介绍

用途

这是一个重新界定问题框架的技能,核心观点是问题陈述不是问题本身,而是看问题的透镜;不同的框架会打开不同的解空间,错误的框架会让好方案变得不可见。

何时使用

  • 启动新工作时,先明确真正要解决的问题。
  • 方案感觉别扭、像绕路时。
  • 在方法上反复摇摆时。
  • 怀疑存在 X-Y 问题(对方要 Y,实际需要 X)。
  • 需求不断膨胀、范围蔓延时。
  • 用在 /aim 之后、/solution-space 之前。 若已有清晰问题陈述,直接进入 /solution-space。

主要流程

  1. 呈现当前框架:说明问题现在如何被描述、隐含哪些假设、哪些被当作固定或可变。
  2. 检测 X-Y 问题:请求异常具体、方案像绕路、只问“怎么做某技术”却不解释原因时,询问底层需求并重新界定。
  3. 区分 WHAT 与 HOW:描述需要改变什么,而非如何改变。例如不说“加缓存层降低延迟”,而说“页面加载超过 3 秒,用户在内容出现前离开”。
  4. 识别约束与灵活性:区分硬约束(法规、物理规律、既有用户承诺)与软约束(“一直这么做”、技术债、团队偏好)。
  5. 撰写问题陈述:结构为“[谁]需要[什么结果],因为[为何重要],但目前[什么阻碍]”。要求简洁、以结果为中心、可验证、不绑定方案。
  6. 验证框架:向他人陈述、反转、放大到更大问题、缩小看是否是多问题伪装成一个。

输出格式

按固定结构输出:问题陈述、当前框架、重新界定后、转变点、约束(硬/软)、该框架能开启什么、排除什么。文档中给出 X-Y 问题检测、基础设施重新界定为用户问题、范围蔓延信号三类示例。

会话持久化

可将会话上下文保存到 .oh/<session>.md 供后续技能使用。提供会话名时直接读写 .oh/auth-refactor.md;未提供时生成后询问是否保存。写入带 session、artifact_type、updated 的头部,若某节存在则替换,否则追加到 Aim 之后。

自适应增强与定位

基础版仅提示,无持久化;带 .oh/ 会话文件可读写上下文;带 Open Horizons MCP 可查询相似问题与框架模式,并记录为决策点。该技能位于 /aim 与 /problem-space 之后,导向 /solution-space 或 /dissent,也可从 /solution-space 回退。