SuperAPI AI 工具集

show-me-your-work

办公与效率

查看项目

更新于 10-16 06:22

技能介绍

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

主要能力:使用单个 TSV 文件,每次决策一行,单元格保持单行;证据是链接或路径(提交 SHA、PR 编号、file:line、产物/追踪/截图路径),不是段落。列包括 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么)、why(用平实语言说明原因)、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;仅当工作需要审查者依赖轨迹才能信任结果时才提交。规则:只追加,错误决策用新行取代,不编辑或删除历史。

运行与审计:一次运行指一次智能体对话(含后续轮次及其摘要);接手、替换智能体或新对话算新运行。运行向已有日志追加时,其首行 phase 为 start,并记录此前非本运行写入行的 ts 范围,证据指向本运行(如 agent id)。运行结束前需对照本次运行的 transcript 审计日志,检查每行是否对应真实决策或动作、证据是否可解析并支持该行主张;遗漏的分叉、转向或放弃方案需补记;错误行不删除,而是新增取代行。

审查:交接前读取 list_profiles 并创建一个 pstack-judge 子代理(create_agent),固定为 codex/gpt-6-astra,thinkingOptionId: xhigh,modeId: full-access,notifyOnFinish: true;若 Astra xhigh 不可用,报告受阻,不替换模型或努力级别。子代理阅读审计轨迹与 transcript,标记弱证据、未验证步骤、事后看有风险的决策及易被忽略的缺口。每次产生轨迹的回复以“Attention”部分结尾,首行写 reviewed by <model>,再列出指向具体行或时刻的标记,“No flags”是有效值。

查看:自上而下阅读,跟随证据指针抽查;GitHub 可将提交的 TSV 渲染为表格,终端可用 column -s$'\t' -t decisions.tsv 渲染。其他技能应引用本技能而非自创格式。

限制:资料未提供安装方式、收费、平台支持范围等细节;默认不提交日志,仅在工作足够重要时提交。