用途：在问题确认解决后立即自动记录，形成可搜索的机构知识库，按问题类型分类组织。
主要能力：通过“that worked”“it's fixed”“working now”“problem solved”“that did it”等确认用语自动触发，或手动执行 /doc-fix 命令。每个问题生成一个 Markdown 文件，存放在对应症状类别的目录中，例如 docs/solutions/performance-issues/n-plus-one-briefs.md。文件使用 YAML frontmatter 作为元数据并支持搜索。
文档捕获遵循 7 步流程：确认触发、仅记录非平凡问题（需多次排查、棘手调试、非显而易见的解法、对未来会话有益；跳过拼写错误、明显语法错误等琐碎修复）、从对话历史提取上下文（模块名、症状、调查尝试、根因、解决方案、预防措施、环境如 Rails 版本、阶段、操作系统、文件与行号引用）、搜索 docs/solutions/ 中相似问题、格式化文件名为 [sanitized-symptom]-[module]-[YYYYMMDD].md、校验 YAML frontmatter、按问题类型确定类别并创建文件。
YAML 校验为阻塞式：需加载 schema.yaml 并按 yaml-schema.md 中的枚举值分类，必填字段齐全且值完全匹配，否则阻止继续。类别由 yaml-schema.md 中的映射确定。创建时使用 assets/resolution-template.md 模板填充。
完成后展示决策菜单并等待用户选择：继续工作流；加入必读（提升为 critical-patterns.md）；关联相关问题；加入现有技能；创建新技能（运行 python3 .claude/skills/skill-creator/scripts/init_skill.py [skill-name]）；查看文档；其他。
限制：若缺少关键上下文（模块名、确切错误、阶段或解决步骤），必须向用户询问并等待。该技能为终端技能，不委托其他技能。关键上下文应已在调用前的对话历史中存在。缺失事实：具体价格、平台要求、版本兼容性等暂未提供。