--- name: show-me-your-work description: "为长时间或无人值守工作保留可审查的决策轨迹:TSV日志,每项决定一行,写做什么、为什么、证据和结果。默认本地;审查者需要轨迹才能信任结果时提交。用于 /show-me-your-work、自主或多阶段执行,或人离开后回来审查的工作。" disable-model-invocation: true --- # 展示工作依据 在 Claude Code 中,每个会话在遵循此技能前,先阅读一次 [Claude Code 适配器](../../docs/harness/claude-code.md)。它将 pstack 技能中的 Cursor 名称映射到 Claude Code。 保留一份规范日志。 ## 格式 单个 TSV 文件,每项决定一行。单元格保持单行。证据是指针,不是长篇文字。 复制 `references/decision-log-template.tsv` 的表头,开始新日志。列为: - **ts。** ISO8601 时间戳。 - **phase。** 阶段或工作流。 - **decision。** 选择或完成了什么,一行。 - **why。** 用普通语言说明理由。原则影响了决定时,直接说明,不写术语标签。 - **evidence。** 证明它的链接或路径:提交 SHA、PR 编号、`file:line`、产物、轨迹或截图路径,绝不是一个段落。 - **result。** 结果或判据状态:`tests green`、`reverted`、`pixel-diff 0`、`INCONCLUSIVE`、`open`。 下面示例使用直白语言,让审查者一眼读懂。 ``` ts phase decision why evidence result 2026-05-24T09:02:00Z frame 先清点工作,约100个组件、大约75小时 开始长时间工作前想知道规模 commit 3a9f1c2 发现开始前需解决5件事 2026-05-24T09:40:00Z harness 改动前保存旧版本截图 便于比较新旧并捕获视觉变化 scripts/snapshot.sh, baseline/ 保存120张基线截图 2026-05-24T11:15:00Z widget 迁移组件样式但不改外观 保持小改动与相同结果 commit 7c21e0a, pixel-diff 0 外观相同,测试通过 2026-05-24T12:30:00Z widget 发现助手截图为空,丢弃其工作 检查真实文件而不相信摘要 worktree reset 已回滚,加强下次指令 ``` ## 写一行日志 像向同事说明做了什么一样写每条记录。普通词语、具体动作,没有 AI 腔或抽象术语;**unslop** 技能也适用于日志文字。 使用辅助工具 `scripts/log.sh `。它填写 `ts`,首次使用写表头,去除意外的制表符与换行,为以 `=`、`+`、`-` 或 `@` 开头的单元格增加单引号前缀。用普通 `printf` 追加也可以,但生成或用户提供的单元格含同样字符时,仍需注意。 记录决策点与检查点,不记每个动作:选了分岔、完成单元及验证结果、转向或回滚及触发原因、发现阻塞、修正门禁。循环任务每轮一行。跳过微小和不言自明的动作。 一次执行是一个智能体对话,包括后续轮次及其摘要。接手、替代智能体或新聊天开始新执行。执行向已有行的日志追加时,第一行阶段为 `start`;在其他执行的 `start` 行后重新追加时,第一行也为 `start`。因此后续轮次回来时,先读末尾,判断期间是否有其他执行写入。`start` 行写明前面不是自己写入的行的 `ts` 范围,证据标识本执行,例如智能体 ID。`start` 阶段不作其他用途。 ## 保存位置 默认日志是工作产物,不提交。保存在工作目录的 `decisions.tsv`,多项工作并行时放 `.audit/.tsv`,不纳入 Git。 只有工作足够复杂,审查者需要轨迹才能信任结果时才提交。 ## 规则 - 只追加。错误决定用新行替代,不编辑或删除历史。 - 优先使用已提交脚本产生的证据,而非手工一次性产物,遵循 **encode-lessons-in-structure** 原则技能。 ## 对照会话审计日志 执行结束、交付之前,核对日志是否真实。读取当前工作区 `agent-transcripts/` 中本次执行记录,路径由系统提示指定。不跨 `~/.cursor/projects/*/` 搜索,那会读取无关私密聊天。逐段对照本次行与真实发生的事。每段从本执行的 `start` 行开始,若本执行创建日志则从首行开始;到其他执行的下一个 `start` 行结束: - 每行是否对应真实决定或动作。 - 每行证据是否能定位,并支持其主张。 - 塑造了工作的分岔、转向或被放弃方案若未记录,就是缺口,补上。 纠正日志,不改写故事。审计不编辑或删除任何行,即使是编造行。某行既非真实决定也非真实动作,或主张与证据错误时,新增替代行,说明实际发生了什么,并给出有效指针。审计不检查本次执行片段之外的行。本次工作发现那些行有误时,同样新增更正。 ## 跨模型审查轨迹 交付前,派出与执行者不同模型系列的子智能体。自查不能替代它。子智能体读取审计轨迹和会话,指出用户应注意的事情;不是重做任务,而是扫描不够理想或有风险的部分。按 **poteto-mode** 的“子智能体”章节为每个子智能体选择推理级别及快速或标准速度。 - 决定的证据薄弱或缺失。 - 跳过验证,或声称验证却在会话中没有证明。 - 回看有风险的选择,例如过早决定、范围膨胀、掩盖症状。 - 用户随手浏览会漏掉的缺口。 产出轨迹的执行,每次回复都以“Attention”节结束。审查者模型单独一行置顶(`reviewed by `),再逐项指出具体行或时刻。“No flags”是有效值,模型名不是。 ## 阅读轨迹 从上到下读,沿证据指针核对并抽查。GitHub 会将提交的 TSV 渲染为表格。`column -s$'\t' -t decisions.tsv` 可在终端渲染。 ## 组合本技能 其他技能将审计轨迹交给这里,不另造格式。按名称引用,由它负责格式,不重复列定义。