# Taiwan Exam Generator

> Create original Taiwan GSAT/CAP (學測／會考) exams for 國綜、國寫、英文、數A、數B、社會、自然, with separate question/solution PDFs and official scope, difficulty, originality, answer, visual and layout QA.

- Skill: `niansia/taiwan-exam-generator` (Agent Skill, multi-file: 379 files)
- Install (CLI): `npx get-skill add niansia/taiwan-exam-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/niansia/taiwan-exam-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: niansia (https://skillmd.com/u/niansia)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/niansia/taiwan-exam-generator

---


# Taiwan Exam Generator

**Hosted web generation:** start with
[references/hosted-execution.md](references/hosted-execution.md), the single
hosted execution route. Extract once with `read_web_knowledge.py <knowledge.md>
--subject <科目> --output-dir <versioned-refs> --reading-plan` and read
`reading/preflight.md`. Read the subject authoring, review and layout packets
when needed. Canonical inputs remain intact for validators. The long local
execution/maintenance procedure below is not an additional hosted prerequisite;
the hosted route retains all applicable subject and quality requirements.
Do not print this entire multi-subject manual, executable sources or full data
maps merely to begin one hosted paper. Use the original template attachments,
the maintained body renderer and the single hosted render/review pipeline.

Use the repository as the source of truth. The model writes new questions; the Exam Pack, metadata, learned blueprint, and validators decide what is in scope and how the paper is composed.

This skill is an editorial constraint and validation system, not a rewriting template library. For every run, the LLM must newly invent the disciplinary object, information mechanism, solution graph, representation, context, and distractor logic. Historical material supplies aggregate boundaries only.

Do not use or package any hard-coded paper builder as a content source, including a newly written one. A renderer or validator may be reused; new questions belong in this run's structured exam data, not in a reusable Python/JavaScript question bank. Never implement five forms by rotating stems, swapping constants, reusing passage frames, cycling difficulty labels, or fixing answer patterns. Writing a new batch generator is not an alternative way to follow this Skill.

## Mandatory execution contract

For **every complete paper**, including internal tests, smoke tests and stress tests, first read [references/exam-pack-execution-contract.md](references/exam-pack-execution-contract.md). Resolve the actual `exam_packs/<exam>/subjects/<subject>/` records and reference pages before writing. A profile id, a file inventory or a `verified` string is not evidence that its contents were inspected. Keep the reference/measurement pass separate from the original item-writing pass.

Source papers are protected execution dependencies, not disposable build output. A
Git ignore rule controls versioning only; it never means `歷屆試題/`, `模擬考/`,
raw intake bundles or their registries may be deleted during cleanup, packaging or
updating. Before a local full-paper run, use
`python scripts/bootstrap_exam_sources.py --subject <科目> --verify-only`; if the
selected source pack is incomplete, run the same command without `--verify-only`
and verify it again. Never overwrite a conflicting local source or claim a
source-verified paper from profiles alone. Read [references/data-ingestion.md](references/data-ingestion.md)
when acquiring, restoring, indexing, moving or publishing source material.

Complete-paper tests must use the same content and subject-layout checks as ordinary generation. Missing empirical pilot statistics may be disclosed; missing correct answers, curriculum boundaries, sources, official response modes or a usable layout may not be excused by calling the result a preview. Never silently change a full-paper request into generic practice. If a prerequisite is missing, produce a precise gap report and repair the evidence/template first; do not fabricate evidence or output a substitute batch.

When the user requests fast or timed generation, also read [references/fast-full-paper-workflow.md](references/fast-full-paper-workflow.md). Treat an under-20-minute paper as a measured warm-run performance target, not as permission to skip candidate competition, independent solving, source/rights review, subject balance, rendering, or all-page inspection. Report the actual clock boundaries and cache state. If the target is missed, finish the valid paper and report the bottleneck honestly; never relabel a partial or unchecked artifact as a complete paper.

For hosted body layout, use [references/hosted-body-workflow.md](references/hosted-body-workflow.md): reuse measured section/item components, never placeholder questions or diagram topology. Project body specs from the saved exam instead of retyping items, review each authored batch's item crops early, reserve time for final QA, and prepare both booklets' page/item review together. Retain a prior actual visual review only within the same paper: an item crop needs an unchanged authored item record and a pixel-identical rendering or the same printed glyphs, rules and images within 0.02 pt; a page needs identical pixels and item content. Changed parts require new inspection. A body renderer never replaces the original fixed PDF layers.

Before full-booklet layout, finish content/answer/difficulty review and run
`run_hosted_workflow.py lock-content --state <latest-state>`; `build` refuses to
run before the lock. Run `check-figures` once the figures exist, read each
checkpoint's `evidence_attention`, and after a content correction run
`refresh-evidence` and complete its drafts from an actual review. Check
pagination with `plan` (at most three, using `--compare`), build at most twice
and review once; every result reports its `iteration_budget`. Repair pagination through layout hints; a necessary content
correction requires renewed dependent reviews and an explicit re-lock with
`--reason`. Continue every repair from the
state returned by the last build/review, and inspect its pending `review_batches`.
Before yielding a turn, use `clock --state <latest-state> --operation pause`;
on continuation use `resume`, and record `touch` during long thinking/review
periods. These are workflow commands, not automatic chat-platform hooks. Report
inclusive wall time separately from estimated activity and recorded tool time.

Use `templates/hosted-subject-layouts.json` to select the requested subject's own question/solution layout pair. Seven subject examples are available; load only that pair, never treat the common math-oriented gallery as every subject's paper. Preview PDFs are optional; their placeholders, partial item coverage and page density cannot be used as a full exam.

In a complete local checkout, use subject renderers for body/internal proofs, compose formal booklets from the original fixed PDFs, and use the single `scripts/validate_exam_release.py` content/delivery gate. `scripts/validate_exam_pack_contract.py` is only its renderer handoff adapter, not a second validation policy. Set `metadata.run_contract` to the external run-contract.json path relative to exam.json; see the execution contract for the maintained evidence format. On a hosted web surface without the repository executable tree, follow the hosted-equivalent gate in `references/web-platform-use.md`; the absence of a local command is not a release blocker, but every observable content, answer, template and all-page inspection check remains required. A generic renderer cannot render a complete paper merely because metadata claims a verified layout. Renderer output is a **review proof**, not an accepted exam; PDF page inspection and final acceptance are separate. No helper script or export/marking test can self-certify educational quality.

Distinguish a **new paper** from a **user-requested correction of an existing paper**. In correction mode, inspect the supplied exam and audit findings, preserve unaffected items, replace confirmed failed mechanisms, and retain revision provenance. This is not a new-original-paper claim. The new-build inheritance prohibition below applies to new papers, not maintenance. After corrections, rerun whole-paper checks; metadata marking, packaging, or fixing one defect never clears unrelated failed acceptance checks.

## Route the request

For first use in a fresh installation or a new chat environment, read
[references/first-use.md](references/first-use.md). Handle ordinary-language
requests without requiring the user to operate repository commands. Installing
this folder does not install runtimes or certify reference data; inspect actual
capabilities and repair feasible prerequisites without weakening the full-paper
gates or claiming that a file upload is persistent skill installation.
For one-time installation requests, follow [INSTALL.md](INSTALL.md). On later
exam requests use the existing enabled Skill; do not reinstall or redownload it
as a routine prerequisite. Reuse accessible, still-valid reference evidence;
missing subject calibration is not a reason to reinstall the Skill.

When the Skill is used in ChatGPT, Claude.ai, Gemini or another hosted web
surface, also read [references/web-platform-use.md](references/web-platform-use.md).
For PDF production, also read [references/hosted-pdf-production.md](references/hosted-pdf-production.md).
Before expensive drafting, prove exact-template acquisition and composition in
the actual file runtime. Use the embedded fetch/composition/inspection helpers;
an optional uploaded data-only resource PDF handles runtimes without networking.
If necessary, request that one resource file before writing the paper. A full
paper request never authorizes a generic-layout draft: obtain explicit consent
before producing any downgrade; a disclaimer is not consent. Mechanical reports
and correct scores do not certify difficulty, source literacy or visual quality.
Use the platform's persistent Skill/Gem mechanism when available, not a claim
that one ordinary chat attachment installs anything globally. A complete-paper
delivery must contain two separate downloadable files: a student question PDF
and an answer-with-full-solutions PDF. Generate and visually inspect both with
the surface's file/code tools. If that surface cannot create files, execute the
required checks, or inspect every PDF page, state the exact limitation and do
not label text-only output or an unchecked PDF as the completed formal paper.
Use the same download naming convention for **all subjects and both exam types**:
`{考試}_{科目}_{paper_id}_題本.pdf` and `{考試}_{科目}_{paper_id}_詳解.pdf`.
Use the actual exam (`學測` or `會考`) and canonical subject name (學測:
`國綜／國寫／英文／數學A／數學B／社會／自然`; 會考: its subject record).
Choose one short, unique `paper_id` at run creation, such as `20260920-01`,
and preserve it across both booklets and resumed work. A new paper gets a new
ID. For example: `學測_數學A_20260920-01_題本.pdf` and
`學測_數學A_20260920-01_詳解.pdf`. Deliver the actual files using these names,
not just renamed link labels. Hosted `finalize` supplies these paths in
`delivery`; hand over those copies, not internal `question.pdf`/`solution.pdf`
proofs. Browser-added duplicate suffixes such as `(1)` are outside the Skill's
control. Honour an explicitly requested filename instead of this default.
For a current-form full paper on a hosted surface, the release-calibration and
live-spot-check procedure in that reference is mandatory. Use the embedded
verified Paper/Layout/difficulty profiles and subject references as the
hash-bound 111–115 aggregate, and use
`exam_packs/學測/metadata/official-current-web-sources.json` for time-boxed live
checks. Do not claim a timed-out PDF was opened, but do not refuse or downgrade
solely because an immutable CEEC URL times out when the compatible embedded
release calibration has no relevant unresolved fields.
Read the hosted reference's bounded-loading/continuation procedure at generation
time: load only applicable sections, fetch the requested subject's components
concurrently with verified cache reuse, and resume the same paper from saved
phase evidence instead of repeatedly reinstalling or restarting. Its embedded
source map includes each year's actual Paper Profile; preserve `needs_review`
states and reconcile specific gaps. A ready aggregate or verified layout does
not promote a pending structure to verified.

For every hosted full paper, use [references/hosted-run-evidence.md](references/hosted-run-evidence.md)
from the first item onward: save small recoverable checkpoints, review difficulty
and originality during writing, and reserve time for both PDFs. Execute the extracted `check_hosted_run.py` before formal delivery. It now
rechecks both actual PDFs against canonical fixed assets and executes the embedded
four-band/math design validators. A narrative equivalent or an author-written
pass JSON is not execution. If the helper cannot run, preserve a pending checkpoint;
do not use the missing executable as permission to skip its checks. Zero mechanically blocking pages
does not clear unresolved layout review flags or missing editorial checks.
Measure phases from preflight, review shortest routes using the available review mode
before final composition, and reserve answer rails below measured content and
figures. Final delivery requires readable item crops as well as every page;
follow [references/hosted-quality-gates.md](references/hosted-quality-gates.md).
The time benchmark never waives QA. Never manufacture missing timing or reviews.
For ALL seven GSAT subjects, prefer a real separate difficulty reviewer when the
platform provides one. Without that capability, automatically use the documented
single-context second-pass review; do not stop ordinary full-paper generation,
ask users to open a second chat, or invent a reviewer identity. Same-context review
is not independent or blind, even when its input artifact omits answers/labels.
Elsewhere, independently solving/checking an answer means a distinct reasoning
or calculation pass; it does not by itself require another model context.
Preserve an explicit user requirement for independent review; that requirement
does need a real separate reviewer. Supply actual ordered questions, continuations,
visuals and verified calibration. In single-context mode solve from the answer-free
packet before comparing saved answers, then audit shortcuts and difficulty.
Disclose the actual review mode at delivery; all substantive quality gates still
apply and unresolved errors still block. Before drafting, run
`prepare_hosted_run.py` to check embedded subject calibration, template bytes and
small question/answer layout proofs. The default offline basis is the canonical
aggregate profile plus expert review under the selected mode; original official PDFs remain
an optional, stronger item-to-item comparison when actually available. Never
claim an unseen official page was read or promote aggregate targets to achieved
difficulty. Neither difficulty nor density QA may start a new original-PDF
download dependency at final delivery. See hosted-quality-gates.md for the two
explicit evidence formats. Adopt the reviewed bands and
rebalance before PDF production. In Math A/B, assess shortcuts using options and
earlier subquestions: routine arithmetic steps and supplied intermediate results
are not new decisions. Never make a hard label fit by lengthening the solution.
Only after content review, compose both booklets and run
`verify_fixed_template_pdf.py` on their final saved bytes (also repeated inside the
delivery gate). Questions require the original subject cover and alternating
inner furniture, plus the original Math A/B final formula body. Answers require
the same subject's inner furniture on every page. “Nonofficial mock”, “116”, or
“completed in 13 minutes” does not waive any fixed-template or difficulty gate.
For Math A/B, follow [references/math-current-events-and-sourcing.md](references/math-current-events-and-sourcing.md):
use 2–4 genuinely model-dependent recent contexts in a default full paper,
verify events/results within the previous year, retain internal provenance, and
keep source-note rows/URLs off the math question and ordinary solution booklets.

For full papers, multi-form tests and Skill quality/acceptance work, first read
[references/pack-and-release-verification.md](references/pack-and-release-verification.md).
Verify actual `exam_packs` source PDFs, scored-slot structure and separate layout
evidence before trusting any `verified` flag. Preserve the requested product in
an external run contract; never substitute a generic smoke suite for independent
exam generation. `validate_exam_release.py` content AND delivery gates are
mandatory for formal full-paper claims in a complete local checkout; hosted
surfaces must execute the equivalent observable checks defined in the hosted
reference and record which mode ran. Reconcile/demote unsupported profiles;
do not repair them with confident labels. Diagnostic PDFs and provenance checks
are not exam acceptance.

For adapting, rebranding or packaging the Skill itself, read `NOTICE`,
`ORIGIN.json` and [references/attribution-and-forks.md](references/attribution-and-forks.md).
Keep current branding distinct from upstream attribution. These public guidance
and packaging checks do not add an account/approval step to ordinary exam use.
Before distributing a Skill update, also follow [references/software-release-security.md](references/software-release-security.md).
Publishing tools are source-checkout-only; their absence from an installed Skill
is intentional and does not require reinstalling it to generate exams.
Antivirus checks apply to software publication, not every exam request. Never
ask users to disable protection, restore quarantined scripts, or add exclusions.

1. Map the requested exam and subject to an existing folder under `exam_packs/`.
2. For generation, read that pack's `manifest.json`, the subject's `metadata/papers.jsonl`, `blueprints/writer-blueprint.json`, and compatible aggregate difficulty/layout profiles when they exist. Never read `metadata/questions.jsonl`, review queues, or `blueprints/learned-blueprint.json` during the writing pass. Those source-level files belong only to ingestion and analysis.
3. If the user is adding or analyzing source material, read [references/data-ingestion.md](references/data-ingestion.md).
4. For GSAT analysis or generation, read [references/gsat-subject-patterns.md](references/gsat-subject-patterns.md).
   Resolve the subject's controlling CEEC examination specification through [references/official-gsat-specifications.md](references/official-gsat-specifications.md). A third-party summary or overview image is never sufficient for detailed scope.
5. If the user asks about difficulty, questions, or a full mock exam, read [references/difficulty-calibration.md](references/difficulty-calibration.md) and [references/generation-protocol.md](references/generation-protocol.md). For current GSAT Math A/B generation, also read [references/math-difficulty-design.md](references/math-difficulty-design.md); its anti-collapse and discrimination-design gates are release-blocking. The difficulty settings are the GSAT defaults and each gate accepts a range (數學A/B 中偏難＋難 70 and 難 30 points ±3, 80–92 minutes ±5; 國綜 mean 答對率 at most 0.62, 社會/自然 choice items at most 0.65, each +0.03; 英文 cross-sentence, reading and higher-vocabulary counts one item below 12/8/5). A paper inside the range is finished; do not run further review rounds to reach the target. **Only when the user asks for a different difficulty** (「數A 難題 40%」「自然平均答對率 0.5」), record `metadata.user_difficulty_request` = {`request`: the user's own words, and the numbers they gave: `hard_percent` (數學: 難 points of 100; 國綜/社會/自然: share of reviewed items with 答對率 < 0.30), `challenge_percent` and `easy_percent` (數學), `mean_p` (國綜/社會/自然)}. The review and plan gates then check those numbers (±3 points for 數學, ±0.03 答對率 and ±5 percentage points of 難 items otherwise) in place of the defaults. Never add the record, or lower difficulty, on your own initiative; for 英文 and 國寫 a request guides the design but no numeric gate changes.
   Every subject's full paper also needs a declared 簡單／中／中偏難／難 count-and-score distribution and `scripts/validate_paper_difficulty_balance.py` review. The levels must describe actual item demands, never an all-中 default, hidden column, or quota-only relabelling. Use each subject's own 111–115 evidence; transfer Math A's design-and-shortcut-review method, not its percentage mix.
6. Before generating from any official, mock, screenshot, or publisher corpus, read [references/originality-firewall.md](references/originality-firewall.md) and [references/llm-original-item-generation.md](references/llm-original-item-generation.md). Blind source separation, LLM candidate competition, and the structural skin-swap audit are release-blocking requirements.
7. For current-form GSAT mathematics, also read [references/current-gsat-math-form.md](references/current-gsat-math-form.md) and [references/current-gsat-math-scope.md](references/current-gsat-math-scope.md); their typography, formula, stem-rhetoric, visual-placement, option-geometry, machine-marking, curriculum-code, and boundary rules are hard constraints.
   When present, also read `exam_packs/學測/shared-data/current-math-form-writer-profile.json`; it is an aggregate-only form envelope. Treat common-range mock statistics as shared-unit/form evidence, never as a Math A or Math B full-paper distribution.
   For a complete Math B paper, accessible and medium-labelled items still require at least three genuine decisions; a definition lookup or one exposed formula substitution is not an acceptable entry item. The first three fill-in items must each combine a representation choice with a constraint, case, comparison, or consistency check. A latitude/longitude item may use coordinate conversion only as an intermediate step: its assessed mechanism must be spherical two-point distance, route comparison, or a navigation constraint. Every Math B item must record and pass the non-routine innovation audit described in [references/math-difficulty-design.md](references/math-difficulty-design.md); changing names, numbers, or scenery is not innovation.
   For current-form GSAT English, read [references/current-gsat-english-form.md](references/current-gsat-english-form.md). Its section sequence, vocabulary envelope, option-competition rules, passage lengths, source transformation, response formats, and page geometry are hard constraints, and its printed-form catalogue (the ten official headings with scores, `(A)`–`(D)` labels, one-row vocabulary options, stacked reading options, Chinese 說明／提示 composition prompt, `1.` `2.` translation numbers, 180–470-word passages) is enforced by `scripts/validate_english_layout_contract.py` on every surface through `scripts/hosted_subject_gates.py`. The vocabulary section must be written from contextual distinctions among plausible alternatives, not from one obvious word surrounded by wrong-part-of-speech fillers.
   English difficulty must come from discourse inference, evidence integration, semantic precision, and competitive distractors while remaining inside the CEEC reference-vocabulary boundary. Do not raise difficulty with off-list words, rare trivia, opaque syntax, or longer padding. In the ten vocabulary items, leave at least two locally plausible wrong options in most items and vary near-synonym, collocation, polysemy, argument-structure, register, semantic-prosody, word-family/form, and discourse-relation competition across the paper. Keep all alternatives grammatically usable in the slot; a visibly wrong suffix or part of speech is not useful difficulty. Follow the higher-demand floor in the English reference instead of assigning `中偏難` or `難` labels to direct one-clue sentences. In a complete 115-form paper, cloze/completion/structure must include cross-sentence decisions, reading groups must contain cross-paragraph or text–visual inference, and mixed items must require transformation rather than copying. Run `scripts/validate_english_difficulty_design.py` in addition to the lexical and layout checks.
   English novelty is also an item-level release gate, not a property of the passage topic alone. Every scored vocabulary, cloze, completion, discourse, reading, mixed, translation, and composition task must carry the `item_spec.subject_innovation_audit` defined in [references/llm-original-item-generation.md](references/llm-original-item-generation.md) and realize an English-specific semantic, discourse, evidence-transformation, translation-constraint, or writing-decision mechanism. A fresh article followed by a recoverable stock question template still fails. Apply the section-specific tests in [references/current-gsat-english-form.md](references/current-gsat-english-form.md), require the full-paper `metadata.subject_innovation_review`, and let `scripts/validate_english_difficulty_design.py` reject missing or merely declarative records.
   Every English vocabulary answer explanation must bind the answer label to the exact printed surface form. It may state the lemma or a related form only after explicitly naming the selected word; silently explaining a different derivative or near-synonym is a release failure. Student-facing English-composition directions must be in Traditional Chinese and state the minimum 120-word requirement. Reject a prompt that uses a photo as a pretext for an unrelated abstract lesson or requires facts not visible in the material; record and pass the prompt-coherence contract in the English reference.
   For the verified 115 English profile, render cloze, text completion, and discourse gaps inline inside the passage; print their option blocks once in the official order, never as repeated worksheet-style blank rows. Part I is 62 points. Section-start underlines, heading placement, and page transitions require a section-by-section visual comparison before release.
   For current-form GSAT Social Studies, read [references/current-gsat-social-form.md](references/current-gsat-social-form.md). Its discipline balance, source ecology, evidence operations, cross-disciplinary grouping, constructed-response contract, and page geometry are hard constraints. Current events may supply evidence and a real decision problem, but may not replace history, geography, or civics reasoning.
   Group the objective section's standalone items into contiguous disciplinary blocks, following the selected official year's block order and counts. Do not alternate history, geography and civics item by item. This restriction does not apply to shared-stimulus objective groups or the mixed/constructed section, including its single-choice subparts. A mixed group may integrate all three disciplines through one coherent evidence problem; prefer genuine, curriculum-bounded cross-disciplinary inference when the material supports it, without forcing every group or every subpart to involve all three. Follow the subject reference's integration and ordering checks.
   For Social Studies, at least ten scored items must rest on verified events or substantive updates within the year before the editorial lock, four of them within 180 days, spread over five materials and at least four in each part (maintainer decision 2026-09-24); print the year and month in the material. Keep the rest of the paper on the curriculum rather than turning it into a news quiz. Apply the reference's party-stance-free rules to prompts, options, images and explanations; assess evidence and syllabus concepts, never allegiance to a party or policy position. Plan answer-bearing visuals as 111–115 print them: 2–4 real photographs or archival images, 7–13 charts, maps and tables, and 18 or more items that cite a 圖／表／照片. Search the web for fitting real photographs first and use them from your own environment, recording where each came from; when the runtime cannot fetch images, use `scripts/photo_library.py` (59 traceable photographs). A traceable source is enough; no license verdict is required. User examples are candidates, not mandatory recurring topics.
   Social Studies novelty applies to every scored standalone and grouped item, not only to cross-disciplinary mixed groups or current-event items. Each item must record `item_spec.subject_innovation_audit` and introduce a new evidence configuration, source tension, spatial/temporal comparison, institutional constraint, quantitative relation, or cross-domain inference that changes the reasoning path. A different place, year, policy name, person, photograph, or dataset attached to the same textbook-definition question is a failed skin swap. Follow the per-domain audit in [references/current-gsat-social-form.md](references/current-gsat-social-form.md), require `metadata.subject_innovation_review`, and enforce it through `scripts/validate_social_item_design.py`.
   For current-form GSAT 國綜 or 自然, read [references/current-gsat-chinese-natural-form.md](references/current-gsat-chinese-natural-form.md). Its ROC 111–115 item-length and page-density envelopes, source-novelty rule, and no-unattributed-passage rule are hard constraints. 國綜 does not permit model-authored literary, classical, expository, or practical-text passages. 自然 may define a school-level model or ask students to transform source data, but every printed empirical datum and real-world claim must be traceable to a frozen source or a transparent calculation from it.
   國綜 and 自然 also require subject-level novelty beyond source novelty or visual novelty. Every scored item must carry `item_spec.subject_innovation_audit` and pass the applicable section in [references/current-gsat-chinese-natural-form.md](references/current-gsat-chinese-natural-form.md). 國綜 must create a new language/interpretive problem and evidence relation; merely selecting a previously unused author or excerpt is insufficient. 自然 must create a new model–evidence, experiment, constraint, uncertainty, multi-representation, or cross-disciplinary reasoning architecture; a new mission, organism, apparatus, photograph, graph skin, or numeric tuple around the same routine is insufficient. Require `metadata.subject_innovation_review` and enforce both subjects through `scripts/validate_chinese_natural_scope.py`.
   The printed 國綜 form is fixed across 111–115 and enforced by `scripts/validate_chinese_layout_contract.py` on every surface: the four headings with scores (第壹部分、選擇題（占76分）／一、單選題（占48分）／二、多選題（占28分）／第貳部分、混合題或非選擇題（占24分）), item 1 字音 and item 2 字形, standalone items 1–5, seven standalone multiple-choice items 25–31 with at least two language-knowledge items and no （應選n項）, one mixed group 32–36, `(A)`–`(E)` labels with every option on its own line.
   國綜 has two additional editorial constraints: each independently answered short-response subpart is at most 40 Chinese characters and at most 4 points (a full short explanation is designed for 4 points); core classical selections must account for 20–25% of the whole paper's score. Apply the counting, rubric and source-dependency rules in the 國綜 section of that reference. These are not 國寫 limits, not a quota for all classical-language material, and not permission to alter historical official profiles.
   A complete Natural Science paper must place Questions 1–36 in one first part worth exactly 72 points: the printed heading is `第壹部分、選擇題（占72分）` and its boxed direction states `說明：第1題至第36題，含單選題及多選題，每題2分。` (spacing may follow the measured font, but no fact may be omitted). These 36 items are **not** all single-choice and must not be recorded as an unresolved generic choice block after the controlling paper has been reviewed. Reproduce a measured official mix: the official 111–115 booklets print 18, 15, 19, 18 and 12 multiple-choice items among Questions 1–36 (single-choice is the remainder), so a paper must carry 12–19 multiple-choice items there and record its actual counts in `metadata.natural_choice_form_contract`; every multiple-choice item prints 應選2項 or 應選3項. The mixed part numbers 37 through 56–60 as exactly six groups of 3–6 items, each with at least one constructed-response item (official bands: 3–9 single, 5–10 multiple, 8–9 constructed). Every Natural Science selected-response item uses five options labelled `A`–`E`. Every multiple-choice item anywhere in the paper—including a selected-response subpart inside the mixed section—must print `（應選 n 項）`, where `n` is derived from and checked against the independently verified answer key. The cover must print both the single-choice and partial-credit multiple-choice scoring rules; a generic `依題本說明` sentence is not an acceptable substitute. Questions 1–36 must also form four uninterrupted nine-item discipline blocks, one each for physics, chemistry, biology, and earth science; record the actual block order and do not interleave disciplines. This block rule stops at Question 36. Do **not** force the mixed/constructed part into four isolated mini-papers: one coherent shared stimulus may and often should integrate two or more of physics, chemistry, biology, and earth science. Give every subpart one primary scored domain, add valid codes for every discipline genuinely required by its solution, and record the non-ornamental evidence bridge in `metadata.natural_mixed_group_designs`. Merely mentioning a second discipline is not integration. Apply the same anti-surface rule used for Social Studies: no pure definition, named-law recall, one-step formula substitution, or decorative experiment/data material. Every item must assess a core or high-frequency curriculum anchor through at least two linked operations; medium and harder items must normally require three. Difficulty may be raised through experimental design, competing models, variable control, multi-representation evidence, uncertainty, or constraint reconciliation, never through peripheral content or calculation bulk.
   Every full Natural Science paper is current-affairs-aware by default, not only on request: read [references/current-form-topicality.md](references/current-form-topicality.md), set an `as_of_date` and editorial lock date, record `metadata.natural_source_ecology_plan` and `metadata.current_context_plan`, and meet the measured floor enforced by `scripts/validate_current_context.py` (at least five verified sources within the year carrying eight scored items in both parts, two of them within 180 days, plus Taiwan-hazard, climate/energy and Taiwan-place contexts). Choose sources freely among fresh, checkable ones — a journal paper, a conference result, a Nature/Science news item, an agency data release, a monitoring series such as ENSO or CO2, a space mission, a hazard report, local Taiwan data; at most one Nobel prize, at most two sources from one publisher, at least three source families, and one event feeds one group (maintainer decision 2026-09-24). Official 111–115 papers carry 0–5 such contexts a year with a typhoon in four of five years; a paper with none is outside the form. Give the preceding 12 months a larger share of the genuinely time-sensitive source groups, but never let a numerical news quota distort the four-discipline, difficulty, form, or solving-time balance. Sample the remaining dated sources across multiple earlier years and source families rather than clustering on one convenient year; keep evergreen school models in a separate bucket instead of pretending they are dated events. Every recent item must depend on a source-specific measurement, comparison, image feature, method, or constraint—not merely a fashionable name. Favor additional graphs, tables, maps, photographs, and observation images when they carry answer evidence; the visual floor is a minimum, not a target or permission to add decoration.
   For current-form GSAT writing, read [references/current-gsat-writing-form.md](references/current-gsat-writing-form.md) and [references/gsat-writing-source-ecology.md](references/gsat-writing-source-ecology.md). During the writing pass, do not read past question text, year-by-year topic summaries, or prior generated writing prompts. The LLM must discover new articles independently, then design a new material sequence, rhetorical tension, task decision, and title from those sources. Every printable event, case, datum, attributed viewpoint, and concrete anecdote must map to an identified source; the LLM may paraphrase, translate, juxtapose, and ask a new question, but it may not invent a supposedly real or generic case to complete the material. **Do not use United Daily News, any other newspaper, publisher, magazine, platform, archive, or institution as a default, preferred, or de facto exclusive source.** 國寫 source eligibility is publisher-neutral: any traceable and rights-safe source may compete when its transformed material fits the selected official length envelope and rhetorical role. The full-paper candidate pool must still span at least four publishers and four unrelated domains, and one easy-to-search publisher must not occupy more than half the pool. Length compliance is necessary but never substitutes for traceability, rights safety, a concrete carrier, a semantic hinge, material dependence, or role fit. For the second task, search contemporary Chinese essays, new poetry, picture-book prose and other Chinese literary writing first. A foreign work may advance only through a traceable published Chinese translation; do not expose a raw English web bibliography as the normal student-facing source line.
   In every subject the printed answer key must look like an official key, that is unpatterned: `scripts/answer_key_patterns.py` (run by the release gate, the hosted final checker and each saved batch) rejects four identical positions in a row, a period-2/3/4 cycle that continues past two repeats, an option bank keyed in label order, five answers stepping through the labels, two item groups with the same answer sequence, and label counts differing by more than one. Write the item, shuffle the options, then derive the key; a key such as 1-4-3-2 repeated or A–J in order is a release failure even when every answer is correct.
   For every full 英文, 國綜 and 國寫 paper, also apply [references/current-form-topicality.md](references/current-form-topicality.md): 英文 needs two verified recent passages carrying six items and a composition prompt tied to a verified current social trend; 國綜 needs two recent groups carrying four items and Taiwan-anchored passages; 國寫 needs one task tied to a verified current trend; 社會 needs ten items within the year, four of them within 180 days, and ten answer-bearing visuals. Record `metadata.current_context_plan` and each item's `item_spec.current_context`; `scripts/validate_current_context.py` runs in the release gate and the hosted final checker, and `append_items.py` reports progress toward the floor after every batch.
8. For every competence-oriented item or group stimulus, read [references/stimulus-generation.md](references/stimulus-generation.md).
   For corpus rechecks, current-example/literacy complaints, source-note cleanup, or release review, also read [references/evidence-backed-editorial-audit.md](references/evidence-backed-editorial-audit.md). Report coverage gaps; author-declared pass flags never substitute for a comparison. Keep full provenance internal and print only notes justified by the official form, answerability, or rights.
   If the stimulus is drawn from a dated article, event, dataset, research release, or technical update, also read [references/current-source-transformation.md](references/current-source-transformation.md). A recognizable topic name is not evidence of literacy or originality. When users request real/current-event literacy, anonymous hypothetical cases do not fulfill that request: source actual dated evidence first, then require its specific relations to enter the curriculum reasoning. Keep event, publication and page-update dates distinct; never backfill invented observations under a real institution's name.
9. If the user wants a printable paper, HTML, or PDF, also read [references/layout-fidelity.md](references/layout-fidelity.md) and [references/rendering.md](references/rendering.md).
10. If any source or generated item uses a figure, graph, map, table, photograph, or visual evidence, read [references/visual-generation.md](r

…(truncated)
