SuperAPI AI 工具集

show-me-your-work

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

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

主要能力:维护一个规范日志,单个 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 外;仅当工作需要审查者靠轨迹信任结果时才提交。

规则与限制:日志只追加,错误调用用新行取代,绝不编辑或删除历史;优先使用已提交脚本产生的证据。运行结束前需对照本次运行的对话记录审计日志,检查每行是否对应真实决策或动作、证据是否可解析并支持该行主张,遗漏的分叉/转向/放弃方案需补记;审计只修正日志不修改故事,错误行用取代行处理。随后用 delegate_task 在不同提供商或模型家族上生成只读审查者,检查证据薄弱、验证缺失、事后看有风险的决策等,并在回复末尾以 Attention 段落列出审查模型与标记。

适用场景:长时间重构、批量迁移、无人值守代理运行等需要可追溯决策链的工作。

限制:资料未提供具体安装命令、收费、平台支持范围或效果数据;日志格式与审计流程依赖 T3 线程读取工具(t3_thread_read、t3_thread_search)及任务委派工具,未提供这些工具时相关步骤暂未提供替代方案。