SuperAPI AI 工具集

recording-decisions

通用与其它

查看项目

更新于 10-16 08:01

技能介绍

用途:在决策已经做出并需要留档时使用,包括写架构级 ADR、写轻量决策日志,或记录某决定被取代的情形。不用于仍在争论中的决策(那属于设计文档写作);但遇到“我们决定用 X 而不是 Y”“就这么定了”、PR 评论或聊天中敲定的取舍、某人已解释两遍的理由等信号时,应主动提出记录。要求:写之前先记录——聊天记录不是持久来源,先把带日期的实质内容写入日志、必要时引用决策者原话、提交条目,再引用它。ADR 采用 Nygard 格式,一次只写一个决策,含标题、状态(Proposed / Accepted / Superseded by ADR-XXX)、日期、决策者,以及 Context、Decision、Consequences、Alternatives considered、References;负面后果必填且不得为空,每个备选方案须给出其最强支持理由,否则视为稻草人。已接受的 ADR 只允许在状态行追加“被 ADR-XXX 取代”。未被回答的反对意见要原样写入负面后果并标注负责人,不得编造反驳。决策日志为轻量格式:日期标题、祈使句表述的决策、一段规则说明,以及 Why 列表、Instead of(被否决选项及原因)。规则:只追加不修改,写错的条目用新日期条目取代;相对日期转绝对日期;记录原因而非仅记录内容;规则与实际情况不符时说明团队意图;可重叠时在顶部写明范围边界;明确记录负面结果与未知(如“四种理论均被证伪,原因未找到”或检索无结果)。资料中未提供具体安装或命令用法。