⚠️ 环境适配：本技能原为排版管线的 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 的实现依据，运行时由脚本统一执行，无需人工读取：
| 维度 | 权重 | 规则文件（脚本实现依据） |
|---|---|---|
| design-token 合规性 | 25% | references/design-token-compliance.md |
| 结构完整性 | 25% | references/structural-integrity.md |
| 排版合理性 | 20% | references/typographic-quality.md |
| 文体契合度 | 20% | references/genre-fit.md |
| 装饰使用合理性 | 10% | references/decoration-usage.md |
| 安全性审查（XSS 防护） | 一票否决 | references/security-check.md |
综合分 = Σ(前 5 维度分 × 权重)（安全性维度不参与综合分计算）
通过门槛
score ≥ 80- 所有维度的
passed均为true
任一维度 passed = false 则整体 passed = false，无论综合分高低。
安全性维度（SC-01~SC-06）任意触发 → 整体 passed = false，不受 score 影响。
打回修正逻辑（一次，不循环）
actionable_feedback 格式规范
每条反馈须满足：
- 指明问题位置（CSS 属性名、HTML 元素、class 名等）
- 给出具体修正方式（替换为什么、添加什么）
- 使用中文，简洁明了
示例：
- ✅
style="font-size: 14px" 中存在裸字号，请替换为 style="font-size: var(--fs-body)" - ✅
<h1> 后直接出现 <h3>，标题层级跳级，请补充 <h2> 层级 - ❌
存在样式问题（过于模糊）
