用途：在问题被确认解决后，立即把解决过程沉淀为可检索的机构知识。适用于需要多次调查、调试耗时、方案不直观、对后续会话有价值的问题；简单拼写错误、明显的语法错误、立刻修正的琐碎问题可跳过。
触发方式：检测到“that worked”“it's fixed”“working now”“problem solved”“that did it”等确认性短语后自动调用，也可手动使用 /doc-fix 命令。
主要能力：从对话历史提取模块名、症状（含确切报错）、尝试过但失败的调查、根因、解决方案、预防措施、环境细节（Rails 版本、阶段 0-6 或实现后、操作系统版本、文件/行引用）。文件采用单文件结构，存放在 docs/solutions/[类别]/[文件名].md，文件名格式为 [净化后的症状]-[模块]-[YYYYMMDD].md，需小写、空格转连字符、去特殊字符、长度小于 80 字符。搜索相似问题时使用 grep -r "exact error phrase" docs/solutions/ 或 ls docs/solutions/[category]/。
关键约束：YAML frontmatter 必须通过 schema.yaml 的枚举校验，problem_type、severity、symptoms 等字段需匹配允许值，校验失败会阻断流程，直到提供修正值。类别由 problem_type 映射决定。若缺少模块名、确切报错、阶段或解决步骤，会先向用户询问并等待答复。
文档完成后展示决策菜单：继续工作流、加入 Required Reading（关键模式）、关联相关问题、加入现有技能、创建新技能、查看文档等；关键模式仅由用户选择是否提升，不自动提升。
限制：仅依据提供的资料，具体 schema 文件内容、模板细节、可用类别完整列表和平台支持范围暂未提供。