studyforge-review-skill

name

studyforge-review-skill

description

Create StudyForge-style Chinese XeLaTeX review and exam PDFs from user-provided exam papers, notes, question banks, course review materials, PDFs, Markdown, Word documents, images, or scanned study materials. Use when Codex must coordinate sub-agents to produce a question-only paper collection, an answer-and-zero-base-explanation version, and a knowledge review PDF with content validation, using the StudyForge LaTeX template and requiring the main agent to run in /goal mode.

StudyForge Review Skill

Core Contract

Use this skill to turn course papers and review materials into three polished XeLaTeX PDFs:

• 课程名称-题目纯享版.pdf
• 课程名称-答案解析版.pdf
• 课程名称-知识点复习.pdf

The main agent must create and complete a /goal for the whole job. Sub-agents do not need their own /goal.

Every core task must be delegated to a newly spawned sub-agent by the main agent. The main agent coordinates, integrates, compiles, validates outputs, and marks the goal complete only after all three PDFs exist and the content checks have been applied.

If you are already running as a sub-agent, do only the single assigned subtask. Do not try to execute the entire workflow, create a /goal, or spawn more agents unless the main agent explicitly assigned that responsibility and the tool is available.

Non-Negotiable Rules

• Do not use scripts, code generation, concatenation tools, templating tools, or programmatic writers to create or rewrite .tex files.
• Require every .tex file to be manually written or manually edited by an agent.
• Apply the no-script-TeX rule to sub-agents as well.
• Let agents choose the best read-only extraction method for source materials: direct file reads, PDF text extraction, visual inspection, office-document extraction, OCR-like tools, or read-only helper scripts.
• If a source PDF/image/scan cannot be parsed reliably, stop content generation for that source and ask the user to parse it at https://mineru.net/ into Markdown, then continue from the Markdown.
• Preserve source fidelity: do not invent missing questions, answers, or course names. If the course name cannot be inferred from user input or materials, ask the user for it.
• Name final source and PDF files with the course name prefix.

Workflow

Read references/workflow.md before starting a real task. It defines the required sub-agent decomposition, parallelism, validation passes, and handoff format.

Read references/studyforge-latex-guide.md before writing or reviewing .tex files. It summarizes the bundled StudyForge template macros and layout expectations.

Use the bundled template assets from assets/studyforge-latex-template/. Copy studyforge-study-exam.sty into the output tex/ folder before compiling.

Output Layout

Create a task output folder chosen by the user or, by default, a clear course-specific folder in the current workspace. Inside it, use:

tex/
  studyforge-study-exam.sty
  课程名称-题目纯享版.tex
  课程名称-答案解析版.tex
  课程名称-知识点复习.tex
pdf/
  课程名称-题目纯享版.pdf
  课程名称-答案解析版.pdf
  课程名称-知识点复习.pdf

Auxiliary LaTeX files may remain in tex/, but final user-facing PDFs must be copied or emitted under pdf/.

Compilation

Prefer scripts/compile_xelatex.py for deterministic compilation of existing hand-written .tex files:

python path\to\studyforge-review-skill\scripts\compile_xelatex.py --workdir path\to\output\tex --tex 课程名称-题目纯享版.tex 课程名称-答案解析版.tex 课程名称-知识点复习.tex --runs 2 --pdfdir path\to\output\pdf

This script may compile and copy PDFs only. It must not create or edit .tex content.