用途
show-me-your-work 用于人类会在事后审计的工作场景。它的核心主张是：回复本身不是记录，轨迹才是记录。每条记录对应一个非显而易见的决策，并且必须在决策做出的当时写下，而不是在事后复盘时补写——作者明确指出，结尾重建的轨迹「不过是带时间戳的虚构」。
何时使用
- 长时间、自主或多阶段的工作，例如「一直运行到完成」或通宵运行。
- 用户离开后、返回时需要信任结果的任务。
- 跨多天的项目，轨迹本身就是事后复盘的依据。
轨迹的存放与格式
轨迹追加写入 OMC 状态根下的 state/decision-trail-{task-slug}.tsv。首次写入时创建表头行；当多个会话共享同一检出目录时，每个任务 slug 一个文件。任务 slug 使用小写 kebab-case，并构成规范路径的一部分。
状态根的解析方式与 OMC 自身脚本一致：默认是检出目录的 .omc/；当设置了 OMC_STATE_DIR，或父级 .omc-workspace 重定向了状态时，根目录随之移动，因此共享根目录的兄弟会话能看到同一份轨迹。
表头为五列：
ts <TAB> task <TAB> decision <TAB> rejected <TAB> evidence
- ts：时间戳。
- task：任务标识。
- decision：你选择了什么，一句话。
- rejected：你权衡过的真实备选方案，以及每个方案落选的一句话原因。「None considered」（未考虑任何备选）也是合法且相当刺眼的记录。
- evidence：促成该决定的具体命令、输出或引用。
并发与安全细节
共享同一状态根的兄弟会话会共享同一文件，因此必须在「表头是否存在」的检查以及每次追加周围持有锁——即 verification-ledger 写入器使用的同一文件锁（对 <trail>.lock 边车文件调用 withFileLock）。否则，并发的首次写入会让表头重复，竞态追加会丢行。
单元格防护：以 =、+、- 或 @ 开头的单元格会被加上前缀，使表格阅读器无法将其解析为公式；单元格内部的制表符和换行会转成空格。
规则
- 在决策时记录，而非在复盘时记录。
- 常规机械步骤不算决策；判断取舍、范围变更和风险接受才算。
- 最终回复应总结轨迹并给出链接，轨迹本身仍是可审计的产物。
- 轨迹是 OMC 状态根下的本地运行时状态，按仓库策略不提交；当风险需要不可变记录时，应把决定性行引用到 PR 描述或关联 issue 中，而不是强行把运行时状态加入提交。
适用场景与限制
适合需要事后追溯的长任务与自主运行；它本身不判断决策对错，也不替代测试或验证。资料未提供收费、平台支持范围等更多信息。