SuperAPI AI 工具集

cursor-show-me-your-work

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:为长时间运行或无人值守的编码工作保留一份可复查的决策留痕。核心是维护唯一一份 TSV 日志,每行一个决策,单元格保持单行;证据写指针而非整段文字。

日志格式:列包含 ts(ISO8601 时间戳)、phase(阶段或工作流)、decision(选择或做了什么,一行)、why(用平实语言说明原因)、evidence(提交 SHA、PR 号、file:line、产物/追踪/截图路径等)、result(结果或断言状态,如测试通过、已回退、pixel-diff 0、INCONCLUSIVE、open)。可从 references/decision-log-template.tsv 的表头行开始。

写日志:像向同事口述一样写,用词平实,避免术语堆砌。使用受限辅助脚本 scripts/log.sh --root <task-root> <logfile> <phase> <decision> <why> <evidence> <result>,它会打时间戳、首次写入表头、去除多余制表符与换行,并对以 =、+、- 或 @ 开头的单元格加单引号前缀。手工 printf 只应在授权任务根目录内、且做过单行、公式前缀与密钥检查后使用。只记录决策点与检查点,如分叉选择、带验证结果的单元完成、带触发条件的转向或回退、暴露的阻塞、修复的关卡;循环运行每轮一行。

运行与存放:一次运行指一次智能体对话(含后续轮次及其摘要);接续、替换智能体或新开对话算新运行。当运行追加到已有日志时,其首个行用 phase start,另一运行 start 行之后的其首行亦然;start 行标注其未写入的前序行时间范围,证据中标明本次运行(如 agent id)。默认日志是工作产物而非提交内容,放在工作目录的 decisions.tsv,或并发任务时的 .audit/<task-slug>.tsv,并排除在 git 之外;仅当工作需要审查者靠留痕信任结果时才提交。

规则:只追加不修改,错误决定用新行取代,绝不编辑或删除历史;优先使用已提交脚本产出的证据而非一次性手工产物。

审计与复查:运行结束交付前,核对日志是否属实,通过原生任务历史读取器或其已验证的本地 rollout 路径读取当前任务历史,不要扫描其他项目或依赖 Cursor 记录路径;若无法获取完整工具历史,须说明该审计限制。逐段比对本次运行的行,检查每行是否对应真实决策或操作、证据是否可解析并支持该行主张;未被记录但影响工作的分叉、转向或放弃方案属于缺口,需补充。审计不编辑或删除行,发现错误主张或虚假行时以新行取代。在有可用独立审查者时进行跨模型留痕复查,若无则如实说明证据限制,不得编造跨模型背书。复查关注证据薄弱或缺失、声称完成却无验证、事后看有风险的决策以及易被忽略的缺口。产出留痕的每次回复以 Attention 段落结尾,列出与实际审查者模型对应的标记;未能复查时标注 not assessed。

限制:本资料未提供收费、价格、支持平台与具体效果等信息,暂未提供。