用途:为任何把工作交回流水线的代理提供可复用的汇报契约,规定其最终交接行必须是DONE或BLOCKED两种终态之一,且BLOCKED必须附具体证据,避免模糊的阻塞报告。
格式:DONE需包含一句话交付摘要、artifact(报告/PR/提交路径)与next(下一接手方,如流水线阶段、门禁或"pipeline continues")。BLOCKED需包含一句话障碍摘要,以及tried(尝试过的文件路径、命令、错误特征)、failed_because(具体原因)、need(具体解阻项,如文件访问、缺失配置、CTO决策或其他代理)三项字段。
硬性规则:没有第三状态;含糊表述需自行判断,若附带问题只是表面性/P2+则记DONE,若阻塞下一流水线阶段则记BLOCKED。BLOCKED缺任一字段即被驳回并需重新汇报。无终态输出视为静默,按BLOCKED处理,failed_because记为silent。failed_because须具体,拒绝"环境问题""测试失败""需求不清""上下文不足"等说法;need须指名具体解阻项,拒绝"更多信息""其他代理帮忙""CTO批准"等模糊表述。
写入位置:每条终态同时写入代理输出末行与.great_cto/verdicts/<agent>-<YYYY-MM-DD-HHMMSS>.log(仅追加的审计轨迹)。资料中给出的示例命令为: mkdir -p .great_cto/verdicts VERDICT_FILE=".great_cto/verdicts/<agent>-$(date -u +%Y-%m-%d-%H%M%S).log" printf '%s\n' "$VERDICT_LINE" > "$VERDICT_FILE"
度量与反模式:.great_cto/verdicts/*.log为机器可读,可统计每代理DONE:BLOCKED比例、failed_because聚类(同一原因出现3次以上值得做元修复)及静默率(应趋近零)。反模式包括:同一报告同时写DONE与BLOCKED、将DONE当作礼貌信号、只写stdout而不持久化审计轨迹。资料未提供收费、平台或安装步骤等信息。