用途:harvest 在工作流退出时触发,读取工作流轨迹与 docs/issues-filed.json,把本次工作流中值得沉淀的知识写入 substrate。
主要能力:识别四类信号——项目专有词汇、非显而易见的架构决策(ADR)、应避免的错误(反模式)、可复用解决方案模式;并检查 issues-filed.json 中同一标签出现 3 次及以上非重复条目所构成的反复延期类别。若工作流在门禁被拒,会把拒绝原因写成 ADR 或反模式。
使用方式:先确认 docs/harvest/<workflow_id>.md 存在,否则立即停止;读取轨迹中的结果、门禁结果与拒绝原因、信号段落;读取 issues-filed.json 并按标签分组统计;惰性读取四个 substrate 索引(仅索引层)以检查 id 冲突或重叠,必要时才用 substrate-read 取正文;按阈值筛选信号,超过 4 条时按优先级裁剪;无信号时输出明确的无信号结论且不写任何文件;有信号则通过 substrate-write 写入,最后输出报告。
限制:每次工作流最多写 4 条,上限无条件;无信号时不得写入;所有写入必须经 substrate-write,不得直接改 .substrate/ 文件或索引;索引惰性读取,不预加载正文;条目 id 须为 kebab-case 且类型内唯一;反复延期阈值为 3;不得提及特定 harness。