SuperAPI AI 工具集

show-me-your-work

办公与效率

查看项目

更新于 10-15 21:39

技能介绍

用途:为长时间运行或无人值守的工作保留一份可审查的决策轨迹,让审查者能快速了解每一步做了什么、为什么这么做、证据是什么、结果如何。

主要能力:维护单一规范日志,格式为 TSV,每个决策一行,单元格保持单行,证据是指针而非大段文字。列包括 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么)、why(用平实语言说明原因)、evidence(提交 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 之外。仅当工作足够重要、审查者需要轨迹来信任结果时才提交。

规则与限制:日志只追加,错误调用用新行取代,绝不编辑或删除历史。优先使用已提交脚本产生的证据。运行结束前需对照本次运行的转录审计日志,检查每行是否对应真实决策或动作、证据是否可解析并支持该行声明;发现缺口或错误时新增取代行,不修改或删除原行。还需由不同模型家族的子代理对轨迹做交叉模型审查,并在回复末尾以“Attention”段落列出审查模型和具体标记。审查时从上到下阅读、跟随证据指针、抽查;GitHub 可将提交的 TSV 渲染为表格,终端可用 column -s$'\t' -t decisions.tsv 渲染。其他技能应引用本技能名称并让其拥有格式,不要重述列定义。