SuperAPI AI 工具集

markdown-linter-fixer

通用与其它

查看项目

更新于 10-16 04:31

技能介绍

用途:该技能通过结构化流程修复 *.md 文件中的 lint 问题,使用 markdownlint-cli2 先诊断、能自动修复的自动修复,无法自动修复的引导手动处理。适用于修复项目 Markdown lint 错误、统一多文件格式、处理有序列表编号问题(MD029)、为文档建立质量规范,以及首次为项目配置 Markdown lint。

主要能力:检查 markdownlint-cli2 是否安装(markdownlint-cli2 --version),缺失时可用 npm install -g markdownlint-cli2 全局安装,或本地安装 npm install --save-dev markdownlint-cli2,也可用 npx markdownlint-cli2。检查项目根目录的配置文件(.markdownlint-cli2.jsonc、.markdownlint.json、.markdownlint.yaml、.markdownlint.yml、.markdownlintrc),无配置时创建 .markdownlint-cli2.jsonc 并关闭 MD013。诊断先扫描根级文件 markdownlint-cli2 ".md",再递归扫描 markdownlint-cli2 "**/.md"。自动修复使用 markdownlint-cli2 "**/*.md" --fix。

使用方式:按阶段执行——环境准备、诊断评估、问题分析、自动修复、手动修复、验证与报告。常见错误包括 MD001、MD009、MD010、MD012、MD029、MD032、MD047。MD029 常因列表项之间内容缩进不当导致,需参考 references/MD029-Fix-Guide.md;MD036 参考 references/MD036-Guide.md。修复后重新运行 markdownlint-cli2 "**/*.md" 验证,并汇总已处理文件、修复类型与剩余问题。

限制与原则:不得通过修改配置隐藏错误,仅可依据用户明确同意或 .gitignore 内容调整 ignores,添加忽略前须询问用户;修复应保留内容原意,不覆盖既有规则,先自动修复再手动处理。资料未提供具体版本要求、支持平台及性能数据。