用途:spec-retro 用于从既往实践中改进规范体系。它与 spec-pipeline 分开,跨多个会话、多个既有 spec、计划与执行结果、治理回执、报告与遥测、范例库以及重复失败模式工作。其最高价值产出不是当前实现规范,而是一小组可执行的规则更新,如流水线门禁规则、挑战规则、fresh-eyes、lint 规则、模式路由、治理回执、工具、子代理策略、范例与度量更新。没有可执行规则或度量时,不应只增加流程文字。
触发条件(满足任一):自上次回顾以来有 5 次或以上完整 spec-pipeline 运行;出现 2 次或以上重复的门禁/挑战/fresh-eyes/lint 失败;报告显示阶段影响不可见;未就绪即开始执行;计划或目标反复变更;no-grill 理由反复泛化;子代理扇出反复无影响;严格度配置反复不匹配;当前报告无法区分通过无增量与改变路线的阶段。不应在每个 spec 后都运行。
输入:可用的 spec_governance_receipt / SGR-v2 记录、完整 spec 输出、计划产物、grill-me 快照、执行结果、spec-pipeline 报告、会话历史、seq 结果、.learnings.jsonl、用户提供的回顾报告。证据要求区分观察模式、支持来源、反证、置信度、拟议自动化和预期度量变化;不能从一次模糊会话推断全系统规则。
变更检测:给定多个计划/spec 文件时可运行 python codex/skills/spec-retro/scripts/spec_churn_detect.py <files...>。该辅助脚本是启发式的,是否属于实质性变更仍由模型判断。
输出:一个紧凑对象 spec_retro_update,含 update_version(SRETRO-v2)、report_window、trigger、observed_patterns、pipeline_updates(mode_routing、gate_contract、challenge_contract、fresh_eyes_contract、lint_contract、governance_receipt、output_templates)、tool_updates(spec_gate、spec_lint、sgr_gate、churn_detector)、subagent_policy_updates、exemplar_updates、measurement_updates(metric、baseline、expected_change、next_report_query)、recommendations(keep、revise、retire)、apply_now、next_owner。
决策标准:提议的变更只有日后可评分才有用。每条建议需说明假设、预期行为变化、度量、下次报告查询、保留/修改/淘汰条件。子代理:首选历史工作者 spec_retro_miner,仅在证据跨越足够多产物时使用,根代理负责综合与建议。
限制:不创建当前实现规范;不以 lint 或挑战单个当前 spec 为主要任务;除非明确要求不改技能文件;不追踪旧的独立伴生技能激活次数;不把阶段通过无增量变成成功表演;不提出无未来度量的流程规则;不作为逐 spec 仪式运行。