← 全部笔记

反模式记录方法

记录真实发生过的判断纠正,供后续任务比较条件与取舍。本文维护各领域反模式记录的格式、收录与使用规则;写作案例见文档写作原则的常见反模式。

格式与维护

反模式条目记录真实发生过的纠正,用四列表维护,新增即在表中加行;各领域建反模式文档时按此格式收录,不另立写法。

四列填法

  • 场景与条件:首句写任务动作,作为检索入口;随后写决定取舍的条件参数,不看任何外部材料即可读懂。
  • 被否的做法、采纳的做法:写实际发生的做法;采纳的必须是落地验证过的。
  • 决策依据:说明这次为什么这样选,写清实际影响取舍的条件与权衡;只记录本次决策有依据的判断,不补写未发生的反例场景。

收录与使用

  • 每格一到两句,写不进来说明未想透。
  • 只收录真实发生过的纠正;同一偏差更新不新增,当初判断有误时改判。
  • 新增或改判条目,内容经用户确认后写入;Agent 提出候选,不自行收录。
  • 条目是算账样本,不是答案库:引用前核对当前条件与条目条件的差异;条件不同导致结论不同,不是违背条目。
  • 场景相似、按同样的账算出不同做法且说不清差异时,停下来问用户。

#写作 #知识管理

Arkk

专题 · 关于