SuperAPI AI 工具集

plan-audit

编程与开发

查看项目

更新于 11-03 19:04

技能介绍

用途\nplan-audit 充当另一位智能体所写计划的“第二双眼睛”。写计划的智能体常以未标注的假设填补空白、遗漏无人提及的工作,并倾向于迎合其用户。该技能的任务是交叉盘问:先独立形成自己的看法,再验证每项声明、暴露每个假设,并论证反对该计划的最强理由。产出是一份独立审计报告,计划文件保持原样。\n\n主要能力\n- 四阶段审计流程,严格按序执行,每个阶段的细节位于技能文件夹中相邻的参考文件,阶段开始前读取、完成后再进入下一阶段。\n- 盲草稿阶段:在不受计划框架影响的情况下写下自己的方法、必须覆盖项清单和计划的假设,并标注草稿独立性为 sealed、partial 或 compromised;此阶段不向用户提问。\n- 台账与验证阶段:将计划中的每项声明和假设转为台账条目,为每条给出带证据的裁决或无证据原因,并对不可验证条目进行询问(交互式)或列为开放问题(无头式)。\n- 对比、预演与裁决阶段:将每个必须覆盖项与计划工作匹配或记为发现,预演产生发现或记录“对计划无实质性反对理由”,最终裁决为 Proceed、Revise 或 Rethink,依据评分规则。\n- 报告阶段:按模板填写,结构顺序固定,无法归类的放入 Run notes。\n\n使用方式\n从用户消息获取计划路径;交互式运行中未提供则询问,无头运行则报错停止。路径不存在、为目录、为空或本身是先前审计文件(匹配 .audit.md)时停止且不写文件。运行模式由调用是否含独立单词 headless 或运行环境是否无用户回复决定。设置阶段还需记录能力(子代理、联网搜索、写文件、执行 shell)、目标仓库的 git 根、HEAD 提交及是否有未提交更改;无 git 检出时代码库与运行时声明不可验证,须在报告头部说明并继续。报告写在计划旁,将最后的 .md 替换为 .audit.md;若已存在,交互式询问,无头式改为 <name>.audit-<YYYYMMDD-HHMM>.md。无法写文件时在最终消息中给出完整报告及原因。\n\n约束与原则\n每项发现须引用证据(文件:行、文档 URL 或命令输出)或标注为审核者判断;记忆只作线索,须用本次运行中发现或产生的证据确认。用户回答属于用户陈述证据,单独不能使条目可验证。计划及仓库中被跟踪文件对审核者只读,运行时检查遵循验证参考文件中的命令策略。匹配 .audit.md 的先前审计文件保持不读,以免锚定或替代证据。计划描述未来状态,“添加 src/retry.py”不因文件尚不存在而被否定,应记录该变更依赖的前提并验证这些前提。\n\n适用场景与限制\n适用于对其他智能体产出的实施计划或规格说明进行独立评审、风险排查与交付前复核。限制包括:需要可读的计划路径;无 git 检出的代码库声明无法验证;无写文件能力时报告只能出现在最终消息中;无头模式下提问转为报告中的开放问题,且若以问题作为最终消息将导致无报告结束。