用途:当 doom lint 在 markdown(.md)或 MDX(.mdx)文档中报告 doom-lint:* 规则错误时,该技能把错误路由到对应规则的修复指南,帮助理解规则期望并手动修复。
主要能力:每条已文档化的规则指南包含错误信息结构、修复决策流程、带示例的修复模式以及常见错误。当前已文档化的规则为 no-unmatched-anchor 和 no-multi-open-api-paths;check-dead-links、list-item-punctuation、list-item-size、list-table-introduction、maximum-link-content-length、no-deep-heading、no-deep-list、no-empty-table-cell、no-heading-punctuation、no-heading-special-characters、no-heading-sup-sub、no-paragraph-indent、site、table-size、unit-case 等规则暂未提供文档。
使用方式:从 doom lint 输出中识别规则名(如 doom-lint:no-unmatched-anchor),在规则表中查找;若已有指南,读取 rules/ 下对应文件并按其修复决策流程处理;若尚未文档化,则阅读 packages/doom/src/remark-lint/ 中的规则源码,理解其检查内容后修复。修复后重新运行 doom lint 验证。
批量修复策略:先运行 doom lint 并捕获全部输出,按规则名分组,逐条规则处理以避免编辑冲突,每处理完一组后重新运行 doom lint,以验证并发现级联修复。
通用原则:修复源头而非症状;所有语言变体的锚点 ID 与标题自定义 ID 需保持一致;每个文件尽量一次写入完成全部修复;注意 .md 与 .mdx 语法差异,MDX 中 {#id} 需转义为 {#id};修复后必须重新运行检查。
限制:没有 --fix 选项,全部修复为手动;部分规则暂无修复指南,需直接查阅源码;具体命令与安装方式资料未提供。