ds-ledger

ds-ledger

长时间运行会忘记初衷。简短的书面台账能让目标始终清晰，并让审查者信任结果。

步骤

1. 创建一个 TSV 文件，例如 .ds-ledger.tsv，并使用表头 ts phase decision why evidence result。在第一行写下目标和完成条件。
2. 每个步骤开始前，重新阅读目标行和最后十行。检查下一步是否仍服务于目标。如果不是，就记录偏离并纠正方向。
3. 每次作出实际决策后，追加一行：
   • ts：ISO 8601 时间。
   • phase：阶段或工作流。
   • decision：你选择或执行的事项，写成一行。
   • why：用通俗的语言说明原因。
   • evidence：填写指向证据的引用，不要写描述性文字。可以是提交哈希、file:line、命令及其结果，或产物路径。
   • result：结果，例如“测试通过”“已还原”“待处理”。
4. 每个单元格都保持在一行内，不得包含制表符。
5. 也要记录还原操作和放弃的工作，并说明原因。失败是最有用的记录。
6. 结束时，添加一行总结，并告诉用户文件的位置。只有审查者需要时才提交该文件。

停止条件

• 运行结束并写入总结行。
• 如果连续三行都没有推动目标进展，就停止运行并报告。

规则

• 每行都需要提供可打开或可重新运行的证据。“看起来没问题”不算证据。
• 像向队友说明情况那样填写记录，语言通俗、具体。
• 不要改写旧记录。追加更正内容。