用途:在交付产物前进行验证,覆盖文件类交付物(pdf、pptx、docx、xlsx、csv)和网页产物。核心原则是“看渲染结果,不看生成代码”:产物必须重新渲染并由“新鲜的眼睛”检查,且占位符、脚手架残留必须修复而非交付。
主要能力与使用方式:
- pdf:先按 pdf 技能 workflow.md 指定的标志运行 render_audit.mjs,再执行 /opt/hatch/skills/artifacts/scripts/validate_pdf.sh。
- presentation(演示文稿):先运行 assemble_deck.mjs,再按 workflow.md 指定标志运行 render_audit.mjs。
- docx:用无头 LibreOffice 转 PDF(soffice --headless --convert-to pdf),再栅格化(pdftoppm -jpeg -r 100)。
- xlsx:运行 /opt/hatch/skills/artifacts/scripts/validate_xlsx.py。
- csv / md:回读解析(csv 用 Python csv 读取;md 直接读取文件)。
共享渲染引擎为 /opt/hatch/skills/artifacts/scripts/render_audit.mjs。渲染可能超出 muse.exec 默认的 yield 时间,因此应把 yield_ms 设置得长于预期运行时间,并读取标志指定的报告文件,而不是仅依赖后台命令的“无输出”。
检查要点:逐张查看验证 PNG 或页面图像,优先检查文字溢出或内容被截断,其次检查重叠、碰撞、拥挤或不均匀间距、低对比度文字,以及遗留的模板装饰。返回前扫描 TODO、lorem、placeholder、[insert、xxx runs 等占位内容,发现即修复。
限制与边界:网页产物保留自身的审计工具(web_artifacts.build 与 web_artifacts.audit,使用相同捕获引擎并强制执行);本技能的“重新渲染”与占位符规则同样适用于其输出。若验证门槛失败,不得返回链接;三次修复失败后,报告具体失败并请求方向,而不是继续迭代。其他未在资料中说明的细节暂未提供。