Consensus Summary HTML 是一个把已有 models-consensus 结果转成自包含 HTML 决策简报的技能。它不派发新的 worker，也不重新运行议会或修改议会决定，只负责组装、校验和检查可视化产物。
用途
当需要把一份议会（council）报告可视化时使用。目标是生成一个 HTML 页面，让读者在一分钟内理解议会结果，并在不打开原始逐字记录的情况下查看证据。页面被定位为“决策界面”（decision surface）：先给出结论，再让读者从主张逐层下钻到证据、分歧、置信度和行动。
输入契约
使用已完成的 models-consensus 结果，不运行新的议会，也不修改议会决定。以持久化的 report_path Markdown 文件作为主要叙述来源；存在持久化的 state_path JSON 文件时一并使用，它提供状态、模式、轮次、席位保真度、有效提供方与模型、独立性核算和置信度值。若结果为内联形式，则使用提供的 report 与 state 部分。字段缺失时显示 Not reported 并指出证据缺口。仅在需要补齐某个必需类别时才读取原始轮次输出文件，默认不加载完整逐字记录。当产物模式、报告结构或状态键不清晰时，先阅读技能目录下的 references/input-contract.md。
证据优先于装饰。缺失席位、格式错误输出、超时、共享提供方或未解决分歧都必须保持可见。使用席位保真度：仅当结果记录了某席位的有效提供方或模型时才命名该席位，绝不从请求名称或自我声明推断模型。
工作流程
-
定位并冻结结果：在结果对象或用户提供的上下文中找到报告与状态路径，记录会话 id、问题、状态、模式、产物模式和报告日期。若状态不是 complete，则把页面标注为 partial、failed、awaiting human input、cancelled 或 ceiling hit，不得把部分结果当作最终决定。
-
规范化证据：在写 HTML 前建立紧凑的内部映射，并在每项旁保留来源路径。内容包括：问题与状态（任务、当前状态、模式、轮次及任何模式切换）；结论（先用平实语言；对采纳类问题，从 Adopt、Trial、Hold、Reject、Not our problem 中给出恰好一个评级，并附在平实句子后；其他问题形态则直接给出建议，不虚构评级）；共识点（议会支持的 3 至 6 点，最强证据在前）；分歧（每个实质性分歧、最强各方立场及其解决或开放状态，使用 flag 而非覆盖，不因多数派更大而隐藏少数派立场）；盲点与证据缺口（议会无法核实的事实、缺失上下文、格式错误席位及本次运行的局限）；置信度（答案置信度与多样性置信度作为两个独立值，附各自区间理由，不得互相转换）；席位与轮次（已选、省略、不可用和重复席位；记录时的有效提供方与模型；轮次结果与收敛情况）；下一步（恰好一个具体行动；若议会给出多个，选最高杠杆的一个，其余放入后续备注）。采用选择而非压缩：删除重复文字，而非证据、注意事项或异议。
-
组装决策界面：把技能目录下的 assets/template.html 复制到约定输出路径，替换每个标记槽位并移除所有占位符。默认路径：当 report_path 已持久化时使用 <report directory>/<session_id>-summary.html；无报告路径时使用 docs/consensus/<slug>-summary.html。明确要求更新该产物时才授权范围化编辑；若未选择替换已有目标，则使用新路径或询问更新哪个产物，并保留无关内容。
页面使用固定顺序与 id：overview（问题、状态、模式、会话及一段摘要）、verdict（平实语言建议，仅采纳类问题附评级）、agreements（议会一致成立的点）、divergences（已解决与开放分歧，附解决理由）、evidence（轮次时间线、席位表、有效模型凭据与来源路径）、confidence（分开的答案与多样性置信度，源中无值时显示 Not reported）、next-step（一个行动，源中给出时附负责人或目标）、limits（缺失证据、省略席位、开放问题及运行局限）。
页面需在三个深度可用：扫一眼（首屏展示问题、状态、结论与下一步）、浏览（卡片与轮次时间线展示共识、分歧、席位与置信度）、下钻（可展开详情展示来源路径、解决说明与紧凑轮次证据）。
视觉规则：先阅读 shared/references/html-page-conventions.md，其中固定了自包含、三个深度、文字加颜色状态和转义要求。决策界面专属规则：首屏保持聚焦，使用深色高对比布局，一个强调色表示正面共识、一个表示警示、一个表示开放分歧；仅对源中存在的值使用条形或环形，视觉不得暗示议会未报告的精度；卡片保持简短，长文本放入 <details> 面板，不粘贴原始逐字记录；所有来源标签保持可读，如 report.md、state.json 或 round-2-digest.md，仅在从输出目录可用时使用相对链接。语言跟随用户请求：英文使用 ASD-STE100 简化技术英语，葡萄牙文使用简明巴西葡萄牙语；作为证据的名称、路径、枚举值和议会引文保持不变。
- 校验产物：组装后运行校验器，在同一次 shell 调用中设置 SKILL_DIR 为该技能目录的绝对路径：
SKILL_DIR="<absolute path of this skill directory>"; python3 "$SKILL_DIR/scripts/validate_consensus_summary.py" <output-file.html>
修复所有报告的错误。校验器检查必需 section id、分开的置信度字段、席位表、单一 next-step、本地自包含及残留模板标记。有浏览器时按共享约定验证（桌面与窄宽度、展开控件、每个导航链接到达真实 section），并额外确认开放分歧在首屏可见；无浏览器时报告机械检查通过但无法进行视觉检查。
- 交付：先返回绝对输出路径，再报告议会状态、结论、下一步、校验命令与结果，以及任何无法视觉检查的部分。议会状态不是 complete 时，不得声称页面为最终版。
输出契约
输出为一个自包含 HTML 文件，必须包含：默认文件名模式（持久化报告旁为 <session_id>-summary.html，内联结果为 docs/consensus/ 下的 <slug>-summary.html）；title、lang、charset 和 viewport；一个可见的问题标题和一个可见的状态标签；上述全部八个 section id；恰好一个 data-role="next-step" 元素；data-role="answer-confidence" 与 data-role="diversity-confidence"，各带值或 Not reported；至少一行的席位表（即使唯一一行说明未报告席位数据）；至少一个来源标签，源细节缺失时给出明确证据缺口；不得有 <!-- SLOT 注释、{{...}} 标记、TODO、Replace with text 或外部脚本/样式表依赖。验收标准：校验器退出码为 0，页面无需服务器即可作为本地文件打开，首屏包含结论，读者可从页面导航到达共识、分歧、证据、置信度、下一步和局限各 section。
注意事项
共识不等于独立性证明，需保留共享提供方与自配对说明。只有一个席位的议会不是多模型共识，应显示降低的多样性置信度。高答案置信度不能弥补低多样性置信度。不要因为存在建议就把开放分歧变成已解决卡片。不要虚构百分比、席位名称、来源链接或解决理由。不要把原始模型请求名称当作有效模型凭据。不要用 HTML 页面掩盖格式错误或不可用的席位，可观察的失败也是结果的一部分。