SuperAPI AI 工具集

show-me-your-work

智能体与模型

查看项目

更新于 11-06 21:01

技能介绍

用途

show-me-your-work 用于为长时间运行或无人值守的智能体工作保留可复核的决策轨迹。它要求维护一份唯一的规范日志,让审阅者能够快速了解任务过程中做过哪些选择、依据是什么、结果如何。

日志格式

日志为单个 TSV 文件,每次决策一行,单元格保持单行。证据是指针而非叙述性文字。列包括:

  • ts:ISO8601 时间戳。
  • phase:阶段或工作流。
  • decision:选择或完成的事项,一行说明。
  • why:用平实语言写出原因;若由某原则驱动,直接说明,不用术语标签。
  • evidence:能证明该行的链接或路径,例如提交 SHA、PR 编号、file:line、产物、追踪记录或截图路径,绝不用整段文字。
  • result:结果或断言状态,例如 tests green、reverted、pixel-diff 0、INCONCLUSIVE、open。

可从 references/decision-log-template.tsv 复制表头行来开始一份干净日志。

记录方式

按向同事说明工作的方式书写每一条:平实措辞、具体动作,不使用 AI 腔或抽象术语。可使用辅助脚本 scripts/log.sh <logfile> <phase> <decision> <why> <evidence> <result>,它会打上时间戳、首次使用时写入表头、清理多余的制表符和换行,并对以 =、+、- 或 @ 开头的单元格前置单引号。直接用 printf 追加一行也可行,但来自生成内容或用户提供文本的单元格需注意同样的字节问题。

只记录决策点和检查点,而非每个动作:选定的分叉、完成的单元及其验证结果、转向或回退及其触发原因、暴露的阻塞、修复的门禁。循环运行每轮一行,跳过琐碎与显而易见的事项。

运行与 start 行

一次运行指一个智能体对话,包括其后续轮次及任何总结。接管、替换代理或新开对话都算新的运行。当一次运行向已有行的日志追加内容时,其第一行使用 phase start;若在另一运行的 start 行之后,其第一行同样使用 start。因此在后续轮次回到某日志的运行,需先读取日志最后几行,确认是否有其他运行写入。start 行需注明它未写入的此前各行的 ts 范围,其 evidence 需指明本次运行,例如其 agent id。phase start 不用于其他用途。

存放位置

默认情况下日志是工作产物而非提交物。放在工作目录的 decisions.tsv,或在多个任务并行时放在 .audit/<task-slug>.tsv,并排除在 git 之外。仅当工作足够重要、审阅者需要该轨迹才能信任结果时才提交。

规则

  • 只追加。错误决定通过新增一行来取代,绝不编辑或删除历史。
  • 优先使用已提交脚本产生的证据,而非手工一次性产物。

对照对话记录审计

运行结束、交付之前,检查日志是否如实反映事实。在活动工作区的 agent-transcripts/ 目录下读取本次运行的对话记录(系统提示中会给出路径),不要跨其他工作区匹配对话记录,以免读到无关的私人对话。逐段核对本次运行的行:每段从本次运行的某个 start 行开始(若本次运行创建了日志则从第一行开始),到另一运行的下一个 start 行结束。检查每行是否对应真实的决策或动作,每行的证据是否可解析并能显示该行所述内容。若某个塑造了工作但未记录的分叉、转向或放弃方案,属于缺口,需补上。

审计修正的是日志而非叙事:审计从不编辑或删除任何行,即使是虚构的行。当某行既非真实决策也非真实动作,或其陈述、证据有误时,新增一行取代它,写明实际发生的情况和可解析的指针。该审计不检查本次运行段落之外的行;若本次运行自身的工作显示其中某行有误,也照同样方式取代。

跨模型复审轨迹

交付前,在与完成工作者不同的模型家族上启动子代理。自我复审不能替代它。子代理读取审计轨迹和本次运行的对话记录,指出用户应当关注之处,不是重做工作,而是扫描次优或有风险的地方。子代理的推理级别与速度按 saltmode 技能的 Subagents 部分选择。重点包括:证据薄弱或缺失的决策、对话记录中被跳过或未证明的验证步骤、事后看有风险的选择(过早、范围蔓延、掩盖症状)、用户随手浏览容易错过的缺口。

产出轨迹的每次运行回复都以 Attention 段落结尾:先单独一行写明复审模型(reviewed by <model>),再逐条列出指向具体行或时刻的标记。“无标记”是有效值,但模型名不是。

审阅方式

自上而下阅读,跟随证据指针,抽查。GitHub 会把提交的 TSV 渲染为表格;终端中可用 column -s$'\t' -t decisions.tsv 渲染。

与其他技能组合

其他技能将其审计轨迹路由到此处,而不再自创格式:按名称引用它,由它负责格式,不要复述列定义。

限制

本资料未提供关于收费、价格、支持平台或具体效果的信息,暂未提供。