learn-follow

learn-follow 是一个用于引导式阅读代码或 wiki 并提取模式的工作流。用途：将文件、wiki 条目或主题解析为可读内容，按结构分段阅读，提取设计模式、命名约定、错误处理方式、数据流与假设。主要能力：目标自动解析（文件路径读取源码；wiki ID 通过 maestro wiki get 获取；主题字符串通过 maestro search 取首个结果）；构建一跳上下文邻域（imports/exports 或 wiki 链接）；确定阅读顺序（单文件按函数/类边界分段，目录按入口→核心模块→工具→测试）；每段应用四个强制问题（用了什么模式、为何选此方案、依赖什么假设、改变会破坏什么）；提取带 file:line 锚点的模式，并与 coding-conventions.md 交叉引用。用法与限制：支持 --depth shallow（默认，仅顶层结构与关键模式）和 --depth deep（每个函数、分支与假设）；--save-wiki 可创建 wiki 笔记。输出写入 .workflow/knowhow/REF-{slug}-{date}.md，确认后追加到 .workflow/specs/learnings.md；禁止修改源码或路径外文件。持久化前须经用户确认（-y 可跳过）。存在阶段门禁：目标无法解析、段落跳过强制提问、存在无锚点模式或用户拒绝确认时阻塞。错误码：E001 目标不可解析；W001 wiki 图不可用；W002 未找到 coding-conventions.md；W003 目标超 1000 行自动转浅读。