SuperAPI AI 工具集

show-me-your-work

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:为需要事后人工复核的长期或无人值守工作保留决策轨迹,让审查者无需重跑任务或通读完整对话记录,就能还原做了什么决定、为什么、依据什么证据。

主要能力:采用单一 TSV 文件,每行一项决策。列包括:ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(所选或所做,一行)、why(用平实语言说明原因)、evidence(指向证明的链接或路径,如 commit SHA、PR 号、file:line、产物、追踪或截图路径)、result(结果或谓词状态,如测试通过、已回滚、像素差异为 0、INCONCLUSIVE、open)。日志只增不改,错误决定用新行取代,不编辑或删除历史。

使用方式:可复制 references/decision-log-template.tsv 作为表头开始新日志。推荐用脚本 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result> 写入,它会自动补时间戳、首次写入表头、清除多余制表符和换行,并对以 =、+、-、@ 开头的单元格加单引号以防表格软件执行公式。也可直接用 printf 追加。默认放在工作目录的 decisions.tsv,多个任务并行时可放 .audit/<task-slug>.tsv,一般不提交 Git;仅当工作规模大、需要审查者信任结果时(如大型跨语言移植、多周迁移)才提交,提交后在 PR 中渲染为表格。只记录决策点和检查点,如分叉、单元完成及验证结果、转向或回滚及触发原因、阻碍、修复的门禁;循环运行每次迭代一行,跳过琐碎内容。

适用场景:长时间运行、无人值守、需要事后人工复核的工作。

限制:需要可用的对话记录资源或明确指定目录,不能扫描其他工作区或全局供应商记录树;无记录时需注明该限制,仅基于现有决策轨迹和产物审计,不得声称覆盖了对话记录。跨模型复核需要主持方暴露模型身份或提供独立子任务设施,否则只能报告该限制,自审不能替代。缺少这些能力时应明确说明。