用途:在编写面向人类读者的 Markdown 文件前了解格式化契约,减少被自动改写。它本身在 PostToolUse 钩子中运行 markdownlint-cli2 --fix 和 prettier --write,作用于所有写入或编辑的 Markdown 文件。
主要能力:prettier 会统一列表符号为 -,把 1) 改为 1.,将 强调 改为 强调、加粗 改为 加粗,*** 分隔线改为 ---,多个空行合并为一个,行内连续空格改为单个空格,表格单元格补齐列宽,并补上结尾换行;不改写正文换行,长行保持原样。markdownlint 会修复 # 后缺空格、标题与围栏块前后缺空行、行尾空白和裸 URL。关闭四条规则:MD013(行长)、MD024(重复标题)、MD029(有序列表前缀)、MD033(内联 HTML)。
无法修复的规则:MD003(标题风格,Setext 形式的 === 或 --- 下划线会报错,应使用 ATX 的 #)、MD025(每文档仅一个 H1)、MD045(图片需 alt 文本)、MD042(链接需目标地址)、MD040(围栏代码块需指定语言)。这些作为钩子反馈返回给模型,需手动修改。
规范写法:以单个 # 标题开头,使用 ATX 标题、- 项目符号、强调、加粗,块之间保留一个空行,每个围栏指定语言,每张图片写 alt 文本,文件末尾加换行。
限制:SKILL.md、plan 文件以及 .llmtmp/、.llmdocs/ 目录被排除;有关具体安装命令和更完整的配置信息暂未提供。