用途：把“看起来没问题”变成可重复的工具证据，对 HTML 项目执行代码规范门禁，并诚实区分通过、失败、无法验证与 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证，或出现 npx --no-install htmlhint '{file}' 相关失败时。
主要能力：识别 .html、.htm 工作区（无专用标记文件）；执行 npx --no-install htmlhint '{file}'，保留退出码、作用域和工具版本；区分格式、静态规则、配置、依赖与环境类失败；用 prettier --write 处理可逆问题并复扫；分层汇报本地、CI、构建与测试证据。
使用方式：先确认仓库根与工具可用性。探测：npx --no-install htmlhint --version。项目级门禁：bash -c 'find . ( -name '"'"'.html'"'"' -o -name '"'"'.htm'"'"' ) -type f -not -path '"'"'/node_modules/'"'"' -exec grep -L '"'"'<%'"'"' {} + | xargs -0 -r npx --no-install htmlhint'。工具准备：npm install -g htmlhint。只对可安全修复项执行 prettier --write，修复后必须复跑同一 lint 命令，再运行项目已有测试与构建。输出状态为 PASS / FAIL / UNVERIFIED / PLANNED。
适用场景：提交前验证 HTML lint、测试和构建证据；CI 中出现相关 htmlhint 失败；判断问题可否自动修复或需人工处理。
限制：不把 formatter 通过当作编译、测试或安全审计通过；不静默安装工具、升级依赖或修改团队规则；不用 suppress/ignore/调高阈值掩盖真实问题；缺工具或配置时不得声称“检查通过”。扫描生成代码、vendor、缓存目录须遵循仓库规则。模板文件含服务端语法时，HTMLHint 解析失败应先确认是否改用模板专用工具。不收集、上传或存储用户代码和凭据，默认只读本地配置并运行本地工具，不联网安装依赖。