用途
beamer-compile-qa 用于编译 Beamer 教学幻灯片(tutorial deck),并将编译结果(成功或失败)记录到一份稳定的构建报告中。它面向 source-tutorial 流程的 C4 阶段,在已有 latex/slides/main.tex 的前提下,产出 PDF 与编译报告。
触发与路由
触发词包括:beamer compile、slides compile、tutorial slides pdf、编译幻灯片、beamer pdf。
适用场景:source-tutorial 的 C4,已有 latex/slides/main.tex,需要输出 latex/slides/main.pdf 和编译报告。
跳过条件:slides scaffold 还没完成。
网络:none(不使用网络)。
护栏(Guardrail):编译失败也要落盘可读报告,不能只返回报错。
主要能力
- 将 latex/slides/main.tex 视为编译入口。
- 输出 latex/slides/main.pdf。
- 输出 output/SLIDES_BUILD_REPORT.md,记录编译成功或失败。
输入与输出
输入:
- latex/slides/main.tex
输出:
- latex/slides/main.pdf
- output/SLIDES_BUILD_REPORT.md
使用方式
快速开始:
uv run python .codex/skills/beamer-compile-qa/scripts/run.py --workspace <workspace>
全部选项:
- --workspace <dir>(必填)
- --unit-id <U###>
- --inputs <semicolon-separated>
- --outputs <semicolon-separated>
- --checkpoint <C#>
示例(编译 Beamer 幻灯片):
uv run python .codex/skills/beamer-compile-qa/scripts/run.py --workspace <workspace>
适用场景
适用于需要将 Beamer 教学幻灯片源码编译为 PDF 并留存构建报告的流水线环节,尤其是 source-tutorial 的 C4 阶段。
限制
- 若 slides scaffold 尚未完成,应跳过本技能。
- 不使用网络。
- 编译失败时仍需生成可读报告,而非仅返回错误信息。
- 关于收费、价格、平台支持范围、编译效果等细节,资料暂未提供。