SuperAPI AI 工具集

show-me-your-work

通用与其它

查看项目

更新于 10-16 03:46

技能介绍

用途:面向需要人工事后复查的长时间或无人值守工作,记录决策轨迹,让审核者无需重跑工作或通读全部对话记录,就能还原做了什么决定、为什么、依据什么证据。同时保持单一权威日志,保证轨迹一致、便于后续智能体找到。

格式:单个 TSV 文件,每个决策一行。使用 TSV 是因为 GitHub 会将其渲染为可排序表格,column -s$'\t' -t 与电子表格都能读取,且追加一行只需一条命令。单元格保持单行,证据是指针而非大段文字。列包括:ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么,一行)、why(用平实语言说明原因)、evidence(证明它的链接或路径,如提交 SHA、PR 号、file:line、产物/跟踪/截图路径)、result(结果或谓词状态,如测试通过、已回滚、像素差异 0、不确定、待定)。模板为 references/decision-log-template.tsv,复制表头行即可开始新日志。

写入方法:像对同事讲述一样书写,用平实语言、具体动作,不使用 AI 腔或抽象术语。可用辅助脚本保持行格式正确:scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>;它会打上时间戳、首次使用时写表头、清理多余制表符与换行,并对以 =、+、-、@ 开头的单元格加单引号前缀,防止在电子表格中触发表格公式执行。用 printf 直接追加也可行,但同样要注意这些字节问题。只记录决策点和检查点(选择的分叉、带验证结果的单元完成、带触发条件的转向或回滚、暴露的阻塞、修复的关口),循环运行每次迭代一行,跳过琐碎与显而易见的项。

存放位置:默认日志是工作产物,不纳入提交,放在工作目录的 decisions.tsv,多个任务并行时放在 .audit/<task-slug>.tsv,并排除在 git 之外。只有当工作需要审核者凭轨迹建立信任时才提交(如大型跨语言移植、持续数周的迁移),提交后的日志会在 PR 中渲染为表格。

规则:一行即一个决策或检查点,若一行放不下说明决策还不够清晰;只追加,错误决定用新行取代,不编辑或删除历史;优先使用已提交脚本产出的证据而非手工一次性结果,便于复查者重跑。

审计与跨模型复查:运行结束交接前,对照本次运行的对话记录(位于当前工作区 agent-transcripts/ 目录)核查日志是否如实:每行对应真实动作、证据可解析、遗漏的分叉或转向补上、删除无用填充;修正日志而非说辞。还必须启动一个与执行工作者不同模型家族的子智能体,读取审计轨迹与对话记录,标出证据薄弱、验证跳过、事后看有风险的决策以及易被忽略的缺口。每个产生轨迹的回复以 Attention 段落结尾,首行写明复查模型(reviewed by <model>),再列出指向具体行或时刻的标记;“No flags”是有效值,但模型名不能省略。

限制:资料未提供具体平台依赖、许可与更多实现细节。