用途:在问题解决后自动生成结构化文档,把排查过程、根因与解决方案沉淀为可检索的知识库。适合需要多次排查、调试耗时或有非显然解法的问题;简单拼写错误、明显语法错误和立即修正的小问题不记录。
触发方式:出现“that worked”“it's fixed”“working now”“problem solved”“that did it”等确认语句后自动调用,或手动执行 /doc-fix 命令。
主要能力:从对话历史提取模块名、可观察症状(含原始报错信息)、失败尝试、根因、解决方案、预防措施以及环境信息(Rails 版本、阶段 0-6 或实现后、操作系统、文件与行号)。文档采用单文件结构,存放在 docs/solutions/[分类]/ 下,文件名格式为 [清洗后的症状]-[模块]-[YYYYMMDD].md。生成前会用 schema.yaml 校验 YAML frontmatter,problem_type 等字段必须匹配枚举值;校验失败会列出错误并阻塞流程。写入前可用 grep -r "exact error phrase" docs/solutions/ 或 ls docs/solutions/[category]/ 查找相似问题,再让用户选择新建并交叉引用、更新已有文档或按重复处理。若同类问题出现 3 次以上,可追加到 docs/solutions/patterns/common-solutions.md。
完成后的决策菜单包括继续原工作流、加入必读(critical-patterns.md)、关联相关问题、加入已有学习技能、创建新技能、查看文档等。
限制:缺少模块名、确切报错、阶段或解决步骤等关键上下文时会阻塞并等待用户补充;关键信息不足时不继续。YAML 校验未通过不得进入文档创建步骤。文档质量要求包含原始报错、具体文件行号、可观察症状、失败尝试、技术解释、代码示例与预防指引,避免含糊描述和纯代码堆砌。若模块不在模块文档中会警告但不阻塞。该资料未提供收费、价格或平台支持等信息。