Visual Reports 是一个用于创建和更新紧凑型可视化 HTML 报告的技能，目标是把答案、决策或下一步行动放在容易找到的位置。它使用共享渲染器、清晰的层级、短列表和有意义的可视化，同时保留事实、证据状态、来源和决定性限制，不为了填充图表而编造数量。
用途
该技能适用于授权答案范围内的对比、多步骤计划、关系梳理和数据丰富的发现。对于极小的答案，应保留在聊天中。不适用于生产应用界面、无关艺术作品、外部服务操作或医疗/临床建议。
主要能力
技能提供八种用途模板和五种领域配置，可通过 --templates 选择。支持创建或更新完整报告、预览和继续、展示或原型、本地编辑、探索样式以及采用偏好等路由。报告可自由组合注册块，使用对比矩阵处理常见标准，使用自动图表处理结构，使用数据图表处理数量。可使用带标签的捆绑图标和经过验证的产品标志来澄清内容。保留单位、比例、方向、空值和状态语义。
使用方式
使用 scripts/render-report.mjs 进行渲染。JSON v2 是规范格式，v1 仍受支持。可选的 Markdown 输入会编译为同一模型。不执行 MDX，也不从排版推断证据。从同一快照生成 HTML、完整 Markdown 和 JSON。使用独占输出目录或带预期基础更新的托管存储。HTML 在无 JavaScript 的情况下仍可离线阅读。无需按报告安装依赖或联网。
脚本命令包括：
node scripts/render-report.mjs --templates node scripts/render-report.mjs --starter comparison --profile software --id options node scripts/render-report.mjs --input /absolute/report.md --output /absolute/new-report node scripts/render-report.mjs --create /absolute/report-store --input /absolute/report.json node scripts/render-report.mjs --update /absolute/report-store --input /absolute/report.json --base REVISION node scripts/render-report.mjs --preview /absolute/report-store node scripts/render-report.mjs --extract /absolute/report.html --section comparison node scripts/render-report.mjs --gallery /absolute/new-gallery
--current 和 --history 读取托管存储。--help 打印完整 CLI。node --test tests/*.test.mjs 使用临时本地夹具验证技能。node scripts/benchmark.mjs 测量混合夹具并强制热 p95 < 1 秒。scripts/export-assets.mjs 仅导出明确请求、已提交、摘要固定的消费者捆绑包；--check 为只读。它不会自动更新固定的消费者。scripts/cache_icon.py 仅将明确选择的已审查公共资产获取到已忽略的缓存中，并带有身份、来源、检索日期和摘要。嵌入前请检查。渲染器从不获取资产。原始代码为 Apache-2.0；捆绑依赖保留其声明。不复制外部技能文本。
适用场景
适用于授权范围内的对比、多步骤计划、关系梳理和数据丰富的发现。当报告能改进授权答案时自动选择报告，尤其是对比、关系、多步骤计划或数据丰富的发现。保持一个事实或简短行动在聊天中。不强制访谈或图表数量配额。
限制
未知不等于零或不存在。计划不等于已交付；虚构不等于已测量。健康样本比例不等于经过时间的可用性。浏览器过滤器从不改变源导出。本地编辑器草稿从不改变源文件或外部服务。切换前导出或明确丢弃。动效为可选加入、可停止，并在减少动效偏好下被抑制。生成和回环预览不授权部署、上传、生产变更或永久偏好更改。将标记和 SVG 视为不可信。拒绝不支持的输入并附上字段/行号；绝不删除数据或伪造值以通过验证。如果源或标志不可用，标记缺口并保留可读名称。如果过期更新失败，检查新的当前模型并有意协调。将缓存、偏好、私有源和报告存储排除在提交之外。不从夹具中得出临床、WCAG 合规或通用主机兼容性声明。
输出格式
交付经过验证的预览/打开路由以及独立 HTML 和完整导出。说明重要的源缺口和实际验证限制。如果文件已更改，包含一个简洁的已验证受影响文件树，带有添加/更改/移动/删除/上下文标签，以及维护/生成/本地所有权。
完成标准
确认源保真度、可见注意事项、完整导出和实际打开路由。记录未运行的门禁，不暗示它们已通过。
失败模式
拒绝无效输入并附上字段/行号诊断。重试前协调过期基础。保留未保存草稿并明确报告被阻止的预览路由。