pstack-show-me-your-work 是一个智能体决策日志技能,用途是为 Pstack 决策轨迹、无人值守运行、对话记录审计以及已完成工作的证据复核提供一套统一的记录方式。其核心主张是“保持一份规范日志”。
日志格式
技能规定使用单个 TSV 文件,每次决策一行,各单元格保持单行,证据是内容指针而非成段描述。可从 references/decision-log-template.tsv 复制表头以开始新日志。列包括:ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(所选或所做的事,一行)、why(用平实语言说明原因,若由某原则驱动则直接说明而非使用术语标签)、evidence(证明该行的链接或路径,如提交 SHA、PR 编号、file:line、工件/跟踪/截图路径,绝不用段落)、result(结果或谓词状态,如测试通过、已回滚、像素差异 0、INCONCLUSIVE、open)。技能给出了示例行,涵盖测算工作量、变更前截图基线、在不改变外观的前提下迁移组件样式、因截图空白而丢弃助手产出等情况。
记录方式
每条记录应像向同事口述所做之事:使用平实词语、具体动作,避免 AI 腔调或抽象术语。可使用技能目录中的辅助脚本 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result> 追加记录,该脚本会写入时间戳、首次使用时写表头、去除多余制表符与换行,并对以 =、+、-、@ 开头的单元格加单引号前缀。也可直接用 printf 追加一行,但需注意同样的字节问题。
技能要求只记录决策点和检查点,而非每个动作:选择的分支、带验证结果的单元完成、带触发原因的转向或回滚、暴露的阻碍、修复的关卡;循环运行时每次迭代一行;跳过琐碎与显然的内容。一次运行指一次智能体对话,包括其后续轮次及摘要;接手、替换智能体或新对话开启新运行。当某次运行向已有记录的日志追加时,其第一行使用 phase start,且在其他运行 start 行之后的第一个行也如此。运行在后续轮次回到日志时,先读取日志末尾几行以确认是否有其他运行写入。start 行需注明其之前非本运行所写行的 ts 范围,证据需指明本次运行(如智能体 id)。phase start 不用于其他用途。
存放位置
默认日志是工作产物而非提交物,放在工作目录的 decisions.tsv,或多个任务并行时放在 .audit/<task-slug>.tsv,并排除在 git 之外。仅当工作规模足够大、审查者需要轨迹来信任结果时才提交。
规则
日志只追加:错误调用通过新增一行来取代,永不编辑或删除历史。优先使用已提交脚本产生的证据,而非手工一次性产物。
审计日志与对话记录
在运行结束、交付之前,需核对日志是否如实。通过宿主的活动对话 API 读取本次运行的对话记录,或调用 /pstack-recall 在本仓库的 Codex 与 Claude Code 会话中查找并读取;不要通配 ~/.claude/projects/*/ 或所有 Codex 会话,以免读取无关私密对话。逐段核对本次运行的行:每段始于本次运行的一个 start 行(或本次运行创建日志时的第一行),止于另一运行的下一个 start 行。检查每行是否对应真实决策或动作,每行的证据是否可解析并显示其声称内容;若某分支、转向或放弃的方案影响了工作但未记录,则属缺口,需补充。审计是修正日志而非修正叙述:即使某行为虚构,也不编辑或删除,而是新增一行取代它,记录实际情况与可解析指针。审计不检查本次运行范围之外的行;若本次工作显示其中某行有误,同样以取代方式处理。
跨模型审查轨迹
交付前,需通过 /pstack-swarm 的跨厂商路由,在不同于执行工作的模型家族上启动子智能体。自我审查不能替代该步骤。子智能体阅读审计轨迹与运行对话记录,标出用户应关注的内容,而非重做工作,重点扫描次优或风险之处:证据薄弱或缺失的决策、对话记录中跳过或声称但无证明的验证步骤、事后看来有风险的选择(过早、范围蔓延、掩盖症状)、用户随意浏览时可能遗漏的缺口。
对于产出轨迹的每次运行,回复中都包含一个“Attention”部分,由 /reply-shape 与 /next-options 在启用时放置。先单独一行写审查者模型(reviewed by <model>),然后列出每个标记并指向具体行或时刻。“No flags”是有效值,但模型名不能省略。
审查轨迹
从上到下阅读,跟随证据指针,进行抽查。GitHub 可将已提交的 TSV 渲染为表格;终端中可用 column -s$'\t' -t decisions.tsv 渲染。
与其他技能组合
其他技能将其审计轨迹路由至此,而非自创格式。引用其名称并让其拥有格式,不要重述列定义。
适用场景与限制
该技能适用于需要可审计决策轨迹的智能体工作,尤其是长时间无人值守运行与需证据复核的完成工作。资料未提供独立的收费、平台支持范围或性能效果说明。