• Detailed Workflow (including commands and decision points):

  skills/make_latex_model/docs/WORKFLOW.md

• Word PDF Baseline Creation:

  skills/make_latex_model/docs/BASELINE_GUIDE.md

• Complete Script Usage:

  skills/make_latex_model/scripts/README.md

• Frequently Asked Questions:

  skills/make_latex_model/docs/FAQ.md

• Specifications in CLAUDE.md and skills/README.md of this project
• Style definition pattern of

  @config.tex

  in an existing project
• ⚠️ Reference Scope for

  main.tex

  :
  • ✅ Allowed to reference:

    \section{}

    ,

    \subsection{}

    title texts in

    main.tex

  • ❌ Forbidden to reference: Main content files referenced by

    \input{}

    in

    main.tex

• Title hierarchy format (Level 1, 2, 3, 4)
• ⚠️ Title text content (Word template titles may vary each year)
• Font (Chinese KaiTi + English Times New Roman)
• Font size (Size 3, Size 4, Small Size 4, etc.)
• Color (MsBlue RGB 0,112,192)
• Spacing (line spacing, before/after paragraph spacing, indentation)
• List style (numbering format, indentation)
• Page settings (margins, text area)

• Title text content must be exactly the same as Word
• Title numbering format must be exactly the same as Word (e.g., "1." vs "1．")
• Punctuation must be exactly the same as Word (e.g., full-width/half-width symbols)
• Example: If Word shows "1. Project Establishment Basis", LaTeX must be identical

• Word count per line must be exactly the same as Word
• Line break positions must be exactly the same as Word
• This requires precise adjustments: font size, character spacing, line spacing, paragraph spacing

• Scripts handle deterministic tasks (extraction/comparison/validation/output artifact storage)
• AI handles heuristic decision-making (which parameter to adjust, how much to adjust, whether to roll back/continue iteration)

projects/{project}/.make_latex_model/

• skills/make_latex_model/docs/WORKFLOW.md

• skills/make_latex_model/scripts/README.md

• NSFC releases a new annual Word template
• Obvious style differences exist between the current LaTeX template and the Word template
• Users actively request "align with Word style" or "update template format"

1. Pre-check:

python3 skills/make_latex_model/scripts/check_state.py projects/{project}

1. Validation (the script parses

   --project

   , supports

   NSFC_Young

   or

   projects/NSFC_Young

   ):

cd skills/make_latex_model
./scripts/validate.sh --project projects/{project}

1. For fine-grained alignment, run the iterative loop:

• python3 skills/make_latex_model/scripts/enhanced_optimize.py --project projects/{project} --max-iterations 30 --report

To enable the AI optimization loop of "Analyzer → Reasoner → Executor → Memory" (minimum viable version), add:

```bash
python3 skills/make_latex_model/scripts/enhanced_optimize.py \
  --project projects/NSFC_Young \
  --max-iterations 30 \
  --ai --ai-mode heuristic

Note: The script currently uses heuristic decision-making by default; for "host AI full participation", use

--ai-mode manual_file

(which generates

projects/<project>/.make_latex_model/iterations/iteration_XXX/ai_request.json

, waiting for

ai_response.json

to be written before continuing).

• All traceable change history is recorded in the root

  CHANGELOG.md

  of the repository
• Only keep necessary explanatory comments in

  @config.tex

  (do not maintain version history)

• Precisely modify

  projects/{project}/extraTex/@config.tex

  , retaining:
  • Original comments
  • Code style
  • Conditional judgment structures (e.g.,

    \ifwindows

    )
• Allowed to modify title text in

  projects/{project}/main.tex

  (only modify text in curly braces, do not touch

  \input{}

  )

cd skills/make_latex_model
./scripts/validate.sh --project projects/{project}

main.tex

• Main content files referenced by

  \input{extraTex/*.tex}

  in

  main.tex

• User-written content in

  extraTex/*.tex

  files
• Main paragraphs, tables, images, formulas, etc.

main.tex

• Title text in

  \section{Title Text}

• Title text in

  \subsection{Title Text}

• Title numbering format, punctuation, etc.
• Reason: The text structure of titles is also part of the template style and needs to align with the Word template

% ✅ Allowed modification: title text
\section{{\bfseries（一）立项依据与研究内容}(建议8000字以内)：} % Modified to
\section{{\bfseries（一）研究依据与内容}(建议8000字以内)：}

% ❌ Forbidden modification: main content
\input{extraTex/1.1.立项依据.tex}  % Do not change the reference relationship
% Do not modify the specific content in extraTex/1.1.立项依据.tex

• ✅ Adjust parameter values (font size pt value, color RGB value, spacing em/cm value)
• ✅ Add custom commands
• ❌ Delete or rename existing commands
• ❌ Change package loading order
• ❌ Refactor conditional judgment structures

• Risk of over-development: Introduce bugs, break existing functions, increase maintenance costs
• Risk of under-development: Inconsistent styles, non-compliance with NSFC requirements
• Balance Strategy:
  • Use

    moderate

    level by default
  • Use

    thorough

    level only when necessary
  • Retain the core architecture of the old style

• Retain

  \ifwindows

  conditional judgments
• Ensure correct compilation on Mac/Windows/Linux
• Keep external font paths unchanged (

  ./fonts/

  )

1. Basic compilation:

   xelatex -> bibtex -> xelatex -> xelatex

   without errors
2. Style parameters: Line spacing/font size/color/margins within tolerance (based on

   skills/make_latex_model/config.yaml

   )
3. Title text: Exactly consistent with Word template (text/punctuation/numbering/bold position)
4. Pixel comparison: Only as auxiliary; baseline must come from Word/LibreOffice (do not use QuickLook)