用途:提高用户对 agent 的信任,把人从“传话员”位置撤下来。每次用户纠正或插手 agent,都说明环境缺了东西,该技能负责找出缺口并补进环境。
三条杠杆:给 agent 验证能力;收紧环境使错误写法写不出或过不了检查;把外部信息接进 agent 工作循环。改法层级按 references/signals.md 的五层顺序从强到弱选。技能只做诊断和建议,除状态目录文件及用户采纳后建的问题外,不修改任何仓库,不提交、不推送。
状态目录:$RELAY_AUDIT_HOME,默认 ~/.local/state/relay-audit/,不要放进任何仓库。含 ledger.json(建议及状态)、reports/<时间>-digest.md(脚本摘要)、reports/<时间>-report.md(每轮报告)、issues/<项目>/<ID>.md(无 Fast Ship 项目和 GitHub 远程时的本地问题)。
用法:用户对上一轮建议做决定(如“采纳 R-012”)时按“处理决定”执行,否则跑一轮审计。审计步骤:同步已采纳条目进度(Fast Ship、GitHub、本地 markdown 三种方式查状态);采集(运行 node ~/.agents/skills/relay-audit/scripts/collect.mjs,记下 windowEnd);复盘 done、verified、ineffective 条目;按项目读摘要分节并归入七类信号;提建议前先查实缺口是否存在;每轮最多 5 条新建议;写报告并更新 ledger;在线程回复精简版。
限制:仅限用户主动调用;脚本报“数据库结构变了”时应立即停止并告知用户更新脚本,不要猜数据;人类消息只能看到用户插手处,agent 命令和坏模式能看到未注意处,两边都要看;公开仓库问题正文只写概括,不引用对话原话。技能自身的问题可作为针对 skills 仓库的建议提出。具体判定阈值等细节以资料中的 references/signals.md 和脚本输出为准,本文未展开。