SuperAPI AI 工具集

knowhow-reflect

办公与效率

查看项目

更新于 10-15 22:14

技能介绍

用途:knowhow-reflect 是知识引擎中的反思访谈层,用于把还留在人脑中、尚未成文的隐性知识通过结构化提问挖出来。它与 knowhow-capture 的本质区别是:capture 收集对话中已说出的内容,reflect 则挖掘从未被写下的想法。reflect 本身不写文件,它是 capture 前置的访谈层,访谈结束后汇总候选条目,再从 knowhow-capture 的“展示列表”步骤继续执行,保持“单一收件箱入口”的不变式。

前置条件:检查工作区中是否存在 .knowhow/ 目录,命令为 ls -d .knowhow/ 2>/dev/null;若不存在则停止,并引导用户先运行 knowhow-init。

适用场景:事故后复盘(聚焦根因与预防)、里程碑或项目结束后(聚焦预期与实际的差距及教训)、周期性回顾(每周或每个 sprint,聚焦可沉淀的重复工作与重复错误)。若用户未说明场景,需先问一句:“要反思什么:刚发生的事故、刚结束的项目,还是刚过去的一周?”

访谈脚本(5 个核心问题):逐个提问,等回答后再问下一题,根据回答深入追问,不要一次读完整个列表。问题依次为:预期(最初想达成什么、当时的成功标准)、实际(真实结果如何、与预期偏差在哪,包括更好和更差)、根因(为何偏差,至少追问 3 层“为什么”,区分直接原因与背景条件)、教训(用一句话让局外人听懂,说明何时适用、何时不适用)、系统行动(为让下次不依赖记忆,知识库中要改什么,如新增工作流条目、修改技能、创建决策)。

访谈规则:用事实线索唤起记忆,提问前先读现有来源(当前对话、wiki/log.md、用户提供的转录或文件)并复述具体节点;不评判,目标是提炼教训而非追责,对“我忘了”要继续追问“为什么会忘、系统缺了哪道关卡”;一次反思只聚焦一个主题;保持简短,目标 10-15 分钟,问完 5 题即止;用户回答较浅时接受,记录其给出的程度,不强迫。

流程:第一步选择场景并阅读事实材料;第二步按 5 题脚本逐个访谈;第三步汇总候选条目,典型一次反思会产生 1 条 lesson(核心:预期、实际、根因、教训、系统行动),以及 0 到多条 decision/pattern/troubleshooting/concept,和来自第 5 题的 0 到多条 candidate-skill/candidate-workflow;第四步交给 capture,从第 2 步(向用户展示候选列表待确认)继续,区别仅在于 inbox 条目 frontmatter 中 captured_from 为 reflect,“原始上下文”逐字引用用户访谈回答,raw/ 来源写入 raw/YYYY-MM-DD-reflect-<slug>.md,其余由 capture 负责。

硬性规则:reflect 不写入 wiki/、skills/、workflows/,也不自行写入 inbox/,所有结果都经过 knowhow-capture 流程;必须逐题提问,禁止把 5 题做成一张问卷;回答停留在症状或归咎个人时要继续追问“为什么”,至少 3 层;第 5 题(系统行动)为必答,没有系统改变的教训终将被遗忘;“原始上下文”须逐字引用用户原话,不得改写而丢失原味。

限制:资料未提供该技能的安装方式、收费、平台支持或效果数据。