P326 · 任务流程

记录决策理由和改错成本

Record reversible decisions with their rationale and cost

记录已授权的选择、依据和判断错误后的代价,并写入交接说明。

编辑审核

以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。

使用场景

已批准本地计划交替使用 normalizeRow 和 normalizeRecord,但规格明确行为相同,两个名称只影响内部调用。你可以在可逆范围内选定一致名字,同时让选择可审阅;不能因这种裁定能力推导发布或安全权限。

具体做法

先核对规格、实际接口和影响范围,确认这是实现选择而非未决定产品要求。选定名称后记录证据、受影响调用、如果判断错误怎样返工;同步相关说明与测试。最终交付保留决定理由,清理临时文件不能让记录消失。超范围或关键未知按相应决策处理。

反例

静默选 normalizeRow,修改调用却不更新说明;交付前删除唯一临时记录,让用户无法知道选择及改错代价。

改进写法

在授权本地范围把教学内部名统一为 normalizeRow,记录规格依据、normalizeRecord 的同义出现和调用影响。更新对应说明并验证行为未变;说明若用户选择另一名,需要一致改接口/调用/文档而不改行为。最终报告引用这项裁定与实际检查,不删除唯一依据,也不据此自动发布。

为什么这样改

可逆选择允许工作推进,持久理由让后续审阅可以看到并修正。返工影响的描述说明选择承诺了哪些对象,而不是只留下一个看似天然正确的实现。

如何验证

示意决定记录包含选择、依据、调用清单、验证与返工范围;最终交接能从它找到同一决定。检查说明和调用没有混用两个名字,未用虚构时间表示返工成本。

只有“我选了 A”而没有理由或影响不满足可审阅要求。

适用边界

记录成本不一定是数字,可以是明确的返工对象;未知工时保持未知。此方法不授权解决真实业务、安全、破坏性或外部操作的未决问题,来源的自动裁定范围不覆盖当前用户边界。

原文与版本

如何收录这些方法