用途：帮助理解代码，提供引导式阅读（follow）、问题调查（investigate）、模式拆解（decompose）与第二意见（consult）四种方式。
主要能力与用法： 1）follow：用法 /learn follow <path|wiki-id|topic> [--depth shallow|deep] [--save-wiki] [-y]。自动识别文件路径、wiki ID（maestro wiki get <id>）或主题（maestro search）并解析目标；按依赖关系建立阅读顺序，逐段应用四个追问（模式、替代方案、隐含假设、改动影响）；结果写入 .workflow/knowhow/KNW-follow-{slug}-{date}.md，并向 .workflow/specs/learnings.md 追加 spec-entry。 2）investigate：用法 /learn investigate <question> [--scope <path>] [--max-hypotheses N] [-y]。围绕问题并行收集代码、导入链、git 历史等证据，写入 evidence.ndjson，形成并按可验证性排序假设，逐一测试；全部失败时触发升级，最终输出 report.md 与 understanding.md。 3）decompose：用法 /learn decompose <path|module> [--patterns <list>] [--save-spec] [--save-wiki] [-y]。并行启动结构、行为、数据、错误四个维度分析代理，提取设计模式并给出 file:line 锚点；与 coding-conventions.md 及已有 learnings 交叉比对，标记 documented/known/new。 4）consult：用法 /learn consult <target> [--mode review|challenge|consult] [-y]。目标可为文件、wiki ID、HEAD/staged 差异或阶段号；以多个视角（如 Pragmatist、Purist）产出共识、分歧、结论与建议，写入 KNW-opinion 文件。
限制：所有写入仅限 .workflow/knowhow/ 与 .workflow/specs/learnings.md，明确禁止修改源码或其他路径；各子命令含强制阶段门与确认门槛（-y 可跳过，但用户拒绝确认时需调整后重试）；缺少 coding-conventions.md 时模式标记为未知状态；目标超过 1000 行自动降为 shallow。错误码包括 E001/E002（目标缺失或不可解析）与 W001-W003（上下文缺失、匹配过少、目标过大）。
适用场景：接手陌生代码库、排查行为原因、沉淀项目模式、对既有改动获取第二意见。前提文件（run-mode.md、codex-run-mode.md）为必需阅读项。