用途:把结构化、以证据为基础的评审数据转换为可读的本地 HTML 工件。该技能只负责通用的校验、呈现与交互行为;具体领域的报告要求、工件生命周期与评审流程由调用方技能负责。
主要能力:根据 schema 校验输入;将证据标注为 observed、proposed 或 prototype,且不得把提议或原型当作已观察行为呈现;保持对比中立,可选建议放在每项之后;使用总权重为 100、取值 0 到 5 的评分标准,由渲染器计算加权总分;不允许出现未知字段,校验会拒绝;生成自包含 HTML,本地状态图片以 data URI 内嵌。
必要用法:要求 Python 3 以及该技能的渲染器,二者任一不可用即停止;创建或修改渲染器输入前先阅读 references/schema.md;编写符合 schema 的 UTF-8 JSON 输入文件后运行:
python3 <render-html-skill-directory>/scripts/render_report.py
--input <report.json>
--output <report.html>
打开或渲染 HTML,检查标题、响应式布局、键盘焦点、状态控件、表格、复制状态、链接以及图表(若有);将工件的绝对路径返回给调用方技能。若无法进行内联主机预览,应直接提供绝对路径,而不是静默跳过评审。
适用场景与限制:资料提及适用于工作流需要实现选项评审、回顾等场景。使用须遵守上述证据标注、评分和字段校验约束。资料未提供收费、平台支持范围、渲染器内部实现细节或性能信息。