用途:从工作流工件中提取知识并归档到 wiki、spec 或 issue,供 wiki-digest、spec-load、maestro-plan --gaps 等下游消费。
主要能力:支持三种模式——无参数扫描全部可收割工件并交互选择;传入 session-id 收割指定会话;传入 path 从指定目录收割。可用 --to 强制路由到 wiki、spec、issue 或 auto;--source 过滤来源类型(analysis、brainstorm、debug、lite-plan、lite-fix、scratchpad、session、learning、all);--recent N 限定天数(默认 30);--dry-run 预览不写入;-y 跳过确认;--min-confidence 设定最低置信度(默认 0.5);--prune 进入状态清理模式,配合 --age N(默认 14)将已收割工件升级为 knowhow 并归档。
使用方式:先确保 .workflow/ 已初始化(否则运行 $maestro-init)。路由时 wiki 使用 maestro wiki create --type <type> --slug harvest-<source_type>-<short_id>;spec 使用 $spec-add "<category> <content>";issue 追加到 issues.jsonl 并带 source: "harvest"。
限制:所有写入仅限 .workflow/knowhow/、.workflow/specs/、.workflow/issues/、.workflow/wiki/、.workflow/harvest/ 或 .workflow/state.json,绝不修改源代码或源工件。存在阶段门禁:未发现工件、提取零片段、去重失败或路径不可解析时会阻断。--prune 不删除磁盘文件,写入前备份 state.json。错误码包括 E001 未初始化、E002 无效 --to、E003 无效 --source、E004 会话不存在、W001 无可收割工件、W003 片段低于阈值、W004 重复片段跳过。