用途：在问题解决被确认后立即记录，形成可搜索的机构知识库，按问题类型分类组织。
主要能力：自动触发（用户说“that worked”“it's fixed”“working now”“problem solved”“that did it”等）或手动 /doc-fix；从对话中提取插件名、症状（精确错误信息）、阶段（0-6 或实现后）、解决方案（代码/配置变更）、排查尝试、根因、JUCE 版本、操作系统版本、文件/行引用；先按问题类型搜索目标分类目录，再扩展到全部分类；发现相似问题时提供决策选项（新建并交叉引用、更新已有文档等）；生成带枚举校验 YAML frontmatter 的文档；支持交叉引用、常见模式库和关键模式提升。
使用方式：文档为单文件架构，每个问题一个 markdown 文件，存放在症状分类目录下，如 troubleshooting/build-failures/cmake-version-mismatch.md。文件名格式为 [sanitized-symptom]-[plugin]-[YYYYMMDD].md。搜索示例：grep -r "exact error phrase" troubleshooting/[category]/，无匹配时扩展为 grep -r "exact error phrase" troubleshooting/。创建目录示例：mkdir -p "troubleshooting/${CATEGORY}"。若缺少关键上下文（插件名、精确错误、阶段或解决步骤），会阻塞并等待用户补充。YAML 校验不通过时也会阻塞，需加载 schema.yaml 展示允许的枚举值并等待修正。
适用场景：需要多次排查尝试的问题、非显而易见且未来会话会受益的解决方案、棘手的调试或根因分析。跳过单次尝试即可修复的问题（拼写错误、语法错误、明显失误）。
限制：不适用于简单修复；关键模式提升到 Required Reading 需用户通过决策菜单选择，绝不自动提升；常见模式需 3 个以上相似问题才建立；该技能为终端技能，不委托其他技能；调用前所需上下文应已在对话历史中。