njau-opening-report

name	njau-opening-report
description	Build, revise, and visually verify 南京农业大学研究生开题报告 DOCX files. Use when the user needs a 南京农业大学/NJAU graduate thesis opening report, 开题报告, 开题论证材料, or a draft converted into the school reference style with cover fields, six required sections, literature review, references, polished academic Chinese, and render-checked Word formatting.

NJAU Opening Report

Use this skill to produce a submission-ready 南京农业大学研究生开题报告 DOCX in one pass from a school reference template plus a student's draft/materials.

Required Inputs

Look for these files in the working directory before asking the user:

• School template: usually 附件2：南京农业大学研究生开题报告（参考样式）.docx.
• Optional论证表: usually 附件3：南京农业大学研究生开题报告论证表.docx.
• Existing draft: DOCX, Markdown, PPTX, notes, or pasted text.

Collect or infer these metadata fields:

• title, name, student_id, advisor, first_discipline, second_discipline, opening_date.
• If a required field is unknown, keep （待填写） instead of inventing it.

Workflow

1. Read references/njau-format.md before drafting.
2. Extract the student's current research materials from DOCX/Markdown/PPTX using structured tools. Do not rely on filenames alone.
3. Rewrite the content into the fixed NJAU report order:
   • 一、课题来源及选题依据
   • 二、课题研究方案
   • 三、研究基础
   • 四、研究计划和进度
   • 五、预期研究成果
   • 六、研究经费预算与来源
   • 文献综述
   • 参考文献
4. Tighten content before formatting:
   • Keep the thesis scope feasible for a master's opening report.
   • Turn broad ideas into concrete research objects, methods, experiments, deliverables, and risks.
   • Remove chatty phrases, repository names as research substance, and over-promising.
   • Preserve true prior work, but phrase it as research foundation, prototype, data, methods, or conditions.
5. Build the DOCX with scripts/build_njau_opening_report.py.
6. Render the DOCX to page PNGs with the doc or documents skill renderer, then inspect the cover, first body page, a middle body page, and the references page.
7. Fix any pagination, clipped text, awkward title wrapping, table overflow, or leftover template prompt text. Re-render after fixes.
8. Return only the final DOCX path unless the user explicitly asks for intermediates.

Script Usage

Create a metadata JSON and a content JSON, then run:

python3 /Users/mayuanyuan/.codex/skills/njau-opening-report/scripts/build_njau_opening_report.py \
  --template "附件2：南京农业大学研究生开题报告（参考样式）.docx" \
  --metadata-json '{"title":"论文题目","name":"姓名","student_id":"（待填写）","advisor":"导师","first_discipline":"一级学科","second_discipline":"二级学科","opening_date":"2026 年      月      日"}' \
  --content-json /path/to/content.json \
  --out "output/doc/南京农业大学研究生开题报告_姓名_格式修订版.docx"

content.json must contain these keys. Values may be strings or arrays of strings:

{
  "source_basis": [],
  "research_plan": [],
  "research_foundation": [],
  "schedule": [],
  "expected_outcomes": [],
  "budget": [],
  "literature_review": [],
  "references": []
}

Use strings for polished paragraphs and arrays for multiple paragraphs or reference entries. The script copies the school template, fills the cover, removes placeholder paragraphs, fills the main table, preserves the required section order, and creates a complete DOCX.

Output Rules

• Write final artifacts under output/doc/.
• Do not overwrite the user's original draft; create a new _格式修订版 or _格式修订优化版 file.
• If the source template is missing, create a structurally equivalent DOCX only after telling the user the school template was not found.
• If rendering is unavailable, still create the DOCX but state that visual QA could not be completed.