用途:校验并修复架构文档、README 和代码注释中常见的 ASCII 方框绘制图表的对齐问题。
主要能力:提供校验脚本,检测错位字符并给出文件:行:列 的定位;输出可操作的修复建议;支持单文件、多文件或整个目录校验。检查规则包括垂直对齐、角连接、交汇点有效性、线条连续性与方框闭合。问题分为 error、warning、info 三级。退出码:0 表示无问题,1 表示存在错误,2 表示仅有警告(使用 --warn-only 时忽略错误)。
使用方式:以下命令保持原样。 单文件: /usr/bin/env bash << 'PREFLIGHT_EOF' uv run "$(cc-plugin-root doc-tools)/skills/ascii-diagram-validator/scripts/check_ascii_alignment.py" docs/ARCHITECTURE.md PREFLIGHT_EOF 多文件与目录可将末尾参数替换为 docs/*.md 或 docs/。 在 Claude Code 中创建或编辑 ASCII 图表后,运行校验脚本、查看错误、按建议修复并重复直至通过。
支持字符:单线角 ┌┐└┘,线 ─│,T 形 ├┤┬┴,交叉 ┼;双线角 ╔╗╚╝,线 ═║,T 形 ╠╣╦╩,交叉 ╬;混合 ╞╟╤╧╪╫。
适用场景:编写或修改 Markdown 中的 ASCII 架构图、评审含方框图的文档、修复“图看起来不对”的问题,以及在提交 docs/ARCHITECTURE.md 等文件前检查。
限制:只检测结构对齐,不检查美观间距;要求统一使用 Unicode 方框字符,不识别 +---+ 形式的混合 ASCII;制表符可能造成误报,建议先转换为空格;不执行 Unicode 规范化,应使用预组合字符。若提示脚本未找到,可用 claude plugin list 确认插件是否安装。处理复杂嵌套图时,可结合输出的行号只校验局部。以上为资料提供的信息,其他细节暂未提供。