用途:对仓库中已有的 Markdown 文档运行外部格式化工具与 yamllint,检查并修复格式问题,而非撰写新内容。
主要能力:编排六个 Markdown 格式化工具加 yamllint;支持 .md/.markdown 及 YAML frontmatter、围栏 YAML 块;以统一 NDJSON 信封输出发现;遵循仓库声明的配置,未声明时使用随附回退配置。
使用方式:通过 md-audit.py 审计、md-format.py 写入、md-fix.py 审计→格式化→再审计、md-audit-frontmatter.py 检查 frontmatter、probe.py / recommend-tools.py 探测工具并给出安装建议(需用户自行安装)。脚本要求 Python 3.10+,仅用标准库。退出码:0 干净,1 有发现或文件被改,2 调用错误,3 无可用工具。
适用场景:发布前审计文档、格式化 Markdown、检查 docs 中的 YAML。
限制:不生成新文字、不发现或总结仓库约定、不校验技能目录规范、不撰写提交信息;不自动安装工具;仅处理 Markdown 与 YAML frontmatter;不检查选定格式化工具之外的问题,自身不新增规则;仓库外回退时忽略 .gitignore。