artifact_testing

artifact_testing 是一个交付物验证技能，归属于 artifact 命名空间，为各类交付物提供统一的验证入口。它的核心规则是：一个交付物应当通过查看用户将看到的新鲜渲染结果来验证，而不能信任生成它的代码。在任何验证关卡失败时都不得返回链接；在三次修复尝试失败后，应报告具体失败情况并请求方向指引，而不是继续迭代。\n\n用途与主要能力\n该技能按产物类型设置验证关卡，并在关卡之后要求人工目视检查。文件类产物的关卡如下：pdf 使用 render_audit.mjs，并带上 pdf 技能 workflow.md 指定的参数，然后运行 /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_ms 设置得长于预期运行时间，并读取参数指定的报告文件，而不是依赖后台命令的静默。\n\n使用方式\n完成渲染后需要目视检查：以全新的眼光阅读每一张验证 PNG 或页面图像，因为生成上下文容易看到它预期看到的内容，而非实际渲染结果。检查顺序为先看文字溢出或内容截断，再看重叠、碰撞、局促或不均匀的间距、低对比度文字，以及残留的模板装饰。返回前还需扫描交付物文本中遗留的脚手架内容，包括 TODO、lorem、placeholder、[insert、xxx、用户未要求的示例行等；发现任何此类内容都应修复，而不是随交付物发出。\n\n适用场景与限制\n该技能适用于即将返回文件交付物（pdf、pptx、docx、xlsx、csv）或网页产物的构建流程。网页产物继续使用自身的审计工具（web_artifacts.build 与 web_artifacts.audit 运行同一捕获引擎并执行强制检查），但本技能的新鲜渲染与占位内容规则同样适用于其输出。关于支持的产物类型之外的格式、具体错误码含义、报告文件的详细字段、yield_ms 的建议取值、依赖安装方式以及工具的输出格式，资料暂未提供。