用途：在问题被确认解决后，把排查过程与解决方案沉淀为机构知识，形成按症状类别组织的可搜索文档库，供后续会话复用。
主要能力：支持在出现“that worked”“it's fixed”等确认语句后自动触发，也可通过 /doc-fix 命令手动执行；仅记录需要多次排查、调试耗时较长、解法不明显或对未来有参考价值的问题，简单拼写错误、明显语法错误和随手修正的琐碎问题跳过。记录内容涵盖模块名、可观察症状（含原始报错信息）、失败的排查尝试、根因、解决方案、预防建议，以及 Rails 版本、阶段（0-6 或实现后）、操作系统版本、文件与行号等环境信息。文档为单文件结构，存放在对应症状类别目录下，文件名格式为 [净化后的症状]-[模块]-[YYYYMMDD].md。写入前强制校验 YAML frontmatter 的枚举值，失败则阻断；同时会搜索 docs/solutions/ 中相似问题，由用户选择新建交叉引用、更新已有文档或其他处理。捕获完成后提供决策菜单，可将高频模式提炼进 critical-patterns.md 必读清单、关联相关问题、并入已有学习技能或新建技能。
使用方式：写入路径为 docs/solutions/${CATEGORY}/${FILENAME}，必要时用 mkdir -p 创建目录，内容按 assets/resolution-template.md 模板填充；新建技能使用 python3 .claude/skills/skill-creator/scripts/init_skill.py [skill-name]。关键上下文缺失时须先询问并等待用户回复。
限制：本技能为终端技能，不调用其他技能，调用前所需上下文应已存在于会话历史中；YAML 校验为阻断式，取值须与 schema.yaml 完全一致；模块不在模块文档中仅告警不阻断；日期范围搜索、按严重度筛选、标签检索、指标统计和导出/导入等能力属于未来设想，当前范围暂未提供。