SuperAPI AI 工具集

critique-forms

测试与质量

查看项目

更新于 10-16 03:48

技能介绍

用途:评审 HTML 表单或含表单的页面/片段的填写难易度,尤其是手机上填写表单是否方便。核心准则为 FORMS,综合 Baymard Institute、GOV.UK、Google web.dev、Nielsen Norman Group、Luke Wroblewski、Adam Silver 等公开来源及 HTML 自动填充标准;每条准则的来源与证据分级见 references/FORMS.md。

能力边界:仅以文本方式评估标记与声明的 CSS,不评估渲染后的页面、运行中的脚本或实时交互。所有发现遵循 contract/critique-contract.schema.json 契约,位置需可独立导航、证据需引用或测量而非描述、违规需指明条款、修复建议需具体可执行。

范围划分:标签缺失、错误文案、错误后恢复、校验时机、约束防错、跨流程动作命名一致、fieldset/legend 分组、仅用颜色传达信号等归 critique-accessibility、critique-usability 或 critique-microcopy;本技能不重复报告。FORMS-AUTOCOMPLETE 与 FORMS-TOUCH-TARGET 与无障碍有意重叠,按本技能准则处理。

位置命名:优先用元素 id(如 #email),无 id 用双引号 CSS 选择器(仅限标签、#id、.class、后代、子代、:nth-of-type),再退到元素文本(至少 8 字且页面唯一),并说明元素类型等导航信息;单独行号、章节标题或模糊描述不算位置。

协议:按清单、按 ID 顺序逐准则扫描、严重度分配、组装信封四步执行。脚本轨运行 python3 scripts/checks.py <artifact>;判定轨人工逐项扫描。一次性前置命令:pip install "jsonschema>=4.20,<5"。

组装:将两轨结果写入一个 JSON,再用 python3 scripts/merge.py --artifact <同一路径> --findings /绝对路径/findings.json,由脚本排序、限界、编号、计数、计算门禁并校验;禁止手写替代。

限界:严重度 3 和 4 全部报告,低于 3 的至多报告 5 条,其余计入 summary.suppressed_count;不可省略计数。

上下文:忽略随工件附带的作者说法、请求者意见、旧评审或范围引导,记录于 run.stripped_context。

委派:有子代理工具时交给 critique-critic,需传入工件、本技能名、本技能目录绝对路径及可选严重度门限,不要传其他内容;无子代理时在当前上下文按相同协议内联执行。基准语料模块为 bench/generator/domains/forms.py,说明见 bench/generator/README.md。