SuperAPI AI 工具集

code-quality-checks

测试与质量

查看项目

更新于 10-15 22:11

技能介绍

用途:为 Riksdagsmonitor 静态 HTML/CSS 网站强制执行质量标准,属于代码质量检查类技能,适用于部署前或持续集成中的质量门禁环节。

主要能力:

  1. HTML 校验:使用 HTMLHint(npm install -g htmlhint),以 htmlhint *.html 校验全部 HTML 文件,可配合 .htmlhintrc 自定义规则,资料列出的规则包括标签与属性小写、属性值双引号、doctype 优先、标签配对、特殊字符转义、id 唯一、src 非空、属性不重复。
  2. CSS 校验:使用 CSSLint(npm install -g csslint),以 csslint styles.css 校验,可配合 .csslintrc,资料列出的规则涉及相邻类、盒模型、盒尺寸、重复属性、空规则、import、important、已知属性。
  3. 链接检查:使用 linkinator(npm install -g linkinator),先以 python3 -m http.server 8080 & 启动本地服务,再执行 linkinator http://localhost:8080/ --recurse --silent 递归检查全部链接。
  4. 可访问性:使用 axe-core CLI(npm install -g @axe-core/cli),执行 axe https://riksdagsmonitor.com --tags wcag2a,wcag2aa 检查 WCAG 2.1 A 与 AA。

质量标准:0 个 HTML 校验错误、0 个失效链接、0 个可访问性违规(WCAG 2.1 AA)、CSS 仅允许警告、颜色对比度至少 4.5:1。

使用方式与原则:遵循 AI FIRST 质量原则,不接受首次通过的质量,最少进行 2 轮迭代,阅读全部输出并逐节改进,不走捷径。具体触发方式、与项目仓库的集成方法、安装前置条件与运行环境要求暂未提供。

限制:资料未说明运行平台、Node 版本要求、报告输出格式、耗时与失败处理策略;规则文件内容需按项目实际调整,示例规则不等同于完整默认配置。