crane-in-clear-sky/workwit-ai-agent/html-review

⚠️ 环境适配：本技能原为排版管线的 HTML 质检环节，当前系统排版走 generate_word，正文中的质检维度可作方法论参考，无需执行 CLI。

📎 参考文件说明：正文中引用的 references/、rules/、workflows/ 等子文件未随技能导入（系统仅存单 SKILL.md），请直接依据本文方法论执行，不要尝试读取不存在的参考文件。

html-review Skill

何时使用本 Skill

在 generate_word 的路线 A 和路线 B 流水线中，每次 HTML 输出后调用本 skill 执行质量门禁：

• 路线 A：每次 doc-typeset 输出 HTML 后调用
• 路线 B：每次 doc-edit 输出 HTML 后调用

若检测不通过，将修正反馈返回对应 skill（路线 A → doc-typeset；路线 B → doc-edit）做一次定向修正，修正后直接输出，不再复检、不循环。

职责

执行 6 维度 HTML 质量门禁检测，输出结构化 HtmlReviewReport。安全性维度（SC-01~SC-06）为一票否决维度；其余 5 维度参与综合分计算。检测不通过时，生成可操作的修正建议返回给上游 skill。

执行方式（脚本化，0 次 LLM 往返）

6 个维度的检测项全部为确定性规则（正则匹配、标签计数、结构解析、class/属性存在性判断），已由 `scripts/review_html.py` 完整实现（纯 Python 3 标准库，零第三方依赖）。本 skill 直接运行脚本并解析其 JSON 输出作为 HtmlReviewReport，无需读取 `references/` 逐条人工检测，无需任何 LLM 推理往返。

• stdout 输出即为完整 HtmlReviewReport（JSON）。
• 退出码：0 = 通过（passed=true）；1 = 不通过（passed=false）；2 = 运行错误（输入缺失/为空）。
• 脚本失败（退出码 2 或异常）→ 视为 review_skill_failed，由 generate_word 输出当前最佳 HTML（见 generate_word §7）。

references/ 目录下的规则文件是脚本实现的规则来源与说明，仅供维护脚本时对照，运行时无需加载。

输入契约

输出契约

6 维度检测规则

各维度的详细检测项、评分标准和修正建议格式见 references/ 目录下的对应文件——这些是 scripts/review_html.py 的实现依据，运行时由脚本统一执行，无需人工读取：

综合分 = Σ(前 5 维度分 × 权重)（安全性维度不参与综合分计算）

通过门槛

• score ≥ 80
• 所有维度的 passed 均为 true

任一维度 passed = false 则整体 passed = false，无论综合分高低。

安全性维度（SC-01~SC-06）任意触发 → 整体 passed = false，不受 score 影响。

打回修正逻辑（一次，不循环）

actionable_feedback 格式规范

每条反馈须满足：

1. 指明问题位置（CSS 属性名、HTML 元素、class 名等）
2. 给出具体修正方式（替换为什么、添加什么）
3. 使用中文，简洁明了

示例：

• ✅ style="font-size: 14px" 中存在裸字号，请替换为 style="font-size: var(--fs-body)"
• ✅ <h1> 后直接出现 <h3>，标题层级跳级，请补充 <h2> 层级
• ❌ 存在样式问题 （过于模糊）