记录决策理由和改错成本
Record reversible decisions with their rationale and cost
记录已授权的选择、依据和判断错误后的代价,并写入交接说明。
以下示例与示意结果由本站编写,用于说明方法,不是模型实测结果。
使用场景
已批准本地计划交替使用 normalizeRow 和 normalizeRecord,但规格明确行为相同,两个名称只影响内部调用。你可以在可逆范围内选定一致名字,同时让选择可审阅;不能因这种裁定能力推导发布或安全权限。
具体做法
先核对规格、实际接口和影响范围,确认这是实现选择而非未决定产品要求。选定名称后记录证据、受影响调用、如果判断错误怎样返工;同步相关说明与测试。最终交付保留决定理由,清理临时文件不能让记录消失。超范围或关键未知按相应决策处理。
反例
静默选 normalizeRow,修改调用却不更新说明;交付前删除唯一临时记录,让用户无法知道选择及改错代价。
改进写法
在授权本地范围把教学内部名统一为 normalizeRow,记录规格依据、normalizeRecord 的同义出现和调用影响。更新对应说明并验证行为未变;说明若用户选择另一名,需要一致改接口/调用/文档而不改行为。最终报告引用这项裁定与实际检查,不删除唯一依据,也不据此自动发布。
为什么这样改
可逆选择允许工作推进,持久理由让后续审阅可以看到并修正。返工影响的描述说明选择承诺了哪些对象,而不是只留下一个看似天然正确的实现。
如何验证
示意决定记录包含选择、依据、调用清单、验证与返工范围;最终交接能从它找到同一决定。检查说明和调用没有混用两个名字,未用虚构时间表示返工成本。
只有“我选了 A”而没有理由或影响不满足可审阅要求。
适用边界
记录成本不一定是数字,可以是明确的返工对象;未知工时保持未知。此方法不授权解决真实业务、安全、破坏性或外部操作的未决问题,来源的自动裁定范围不覆盖当前用户边界。
原文与版本
- obra/superpowers · Rulings and stop boundaries
查看此版本的文件8ca22dba9a94 - obra/superpowers · Report rulings before cleanup
查看此版本的文件8ca22dba9a94