SuperAPI AI 工具集

qa-quarto

前端与建站

查看项目

更新于 10-16 07:57

技能介绍

用途:将 Quarto HTML 幻灯片与其 Beamer PDF 基准进行对抗式一致性检查,以 Beamer PDF 为金标准,要求 Quarto 翻译在各方面至少不逊色。

主要能力:工作流分为 Phase 0 预检、Phase 1 critic 审计、Phase 2 fixer 修复、Phase 3 复审,循环直到 APPROVED 或连续两轮无新增严重问题(dry),回退上限 5 轮。硬性门禁包括:无内容截断、交互图表不劣于静态图、无缺失幻灯片/公式/文本、视觉无回归、幻灯片内容居中不跳动、数学记号与 Beamer 逐字一致。

使用方式:先定位 Beamer(.tex/.pdf)与 Quarto(.qmd/.html)文件,检查新鲜度并在必要时重新渲染,验证 TikZ SVG。用 "${SLIDE_QA_PYTHON:-python3}" scripts/slide-qa.py Quarto/[Lecture].html 测量渲染,脚本在无头 Chrome 中加载幻灯片并输出 quality_reports/audits/slide-qa/[Lecture]/report.md 及每页截图;退出码 1 表示发现问题,退出码 2 表示无法运行(通常缺 Playwright,脚本会打印一次性 venv 安装与 SLIDE_QA_PYTHON 设置)。随后启动 quarto-critic 智能体全面比较,报告存至 quality_reports/[Lecture]_qa_critic_round1.md;未通过则启动 quarto-fixer 按 Critical→Major→Minor 修复、重渲染并验证,再复审。最终报告存至 quality_reports/[Lecture]_qa_final.md。

审查发现需通过 finding-schema.json 的机器校验契约,报告为 JSON 数组。可先运行 echo '[]' | python3 scripts/validate-findings.py 冒烟测试。审查智能体只读,由本技能写文件:将散文报告保存到对应路径,把结尾 fenced json 块复制到临时文件并校验填充 id:python3 scripts/validate-findings.py --fill-ids block.json > <report>.json.tmp && mv <report>.json.tmp <report>.json || rm -f <report>.json.tmp,再运行 python3 scripts/validate-findings.py --check-quotes <report>.json。未返回 json 块或校验失败的审查视为未完成,需带校验错误重派一次,否则报告该视角缺失。

限制:资料未提供具体收费、价格、平台支持范围或效果保证;迭代上限与门禁为流程约束,实际结果取决于输入文件与运行环境。