Academic Paper Composer

Academic Paper Composer

Overview

This is the writing and finalization skill for Codex-based undergraduate software engineering theses. It consumes the strategist's evidence-backed plan and turns it into a clean, submission-ready manuscript grounded in the real project.

Companion flow:

1. academic-paper-strategist - determine structure, evidence map, keep/rewrite/delete scope
2. academic-paper-composer - rewrite sections and assemble the final thesis text
3. drawio - rebuild engineering-style figures when needed
4. playwright - capture real runtime screenshots when the thesis needs running-system evidence
5. doc - apply Word formatting and visually verify the final DOCX

This skill is responsible for the thesis content and final assembly logic. It must not claim completion until the copied or user-designated working DOCX has been formatted and checked.

Required Inputs

• the strategist's outline or rewrite brief
• the existing thesis draft
• the school format sample
• the real project evidence files
• detection reports when available (similarity / plagiarism / AIGC PDFs, screenshots, or extracted text)
• the exact destination path for the copied final DOCX or the exact working draft path the user wants to continue editing
• the exact destination path for the rework report, if provided

Non-Negotiable Rules

• Operate on a copied draft only unless the user explicitly says the current hand-edited draft is now the working file.
• Never overwrite the user's untouched original source draft.
• Load and obey:
  • references/zjkj-undergrad-thesis-format.md
  • references/project-grounding-rules.md
  • references/finalization-task-rules.md
• Load references/detection-report-rewrite-playbook.md whenever the user asks to lower similarity or AIGC risk and provides reports.
• Load references/docx-draft-salvage-and-runtime-screenshot-playbook.md whenever the task involves continuing from a hand-edited draft, partial section replacement, restoring original tables/figures, or adding real running-system screenshots.
• Load references/thesis-revision-operation-checklist.md whenever the task involves editing a live working draft, because the edit order matters.
• Rewrite unsupported text instead of polishing false content.
• When lowering similarity or AIGC risk, rewrite the wording while preserving project truth; never game the score by inventing facts or deleting essential substance.
• Keep all visible manuscript text black.
• Remove hyperlink styling, process notes, instructional text, and template hints.
• Use only project-supported figures and screenshots.
• Prefer restoring a supported original figure/table over redrawing it.
• Keep the testing chapter conservative and evidence-based.

Workflow

Step 1: Safety Copy

If the user provides a source draft and a destination path:

• copy the source draft first
• verify the destination copy exists
• preserve the source draft untouched

If the user says the already hand-edited draft is the working file:

• treat that file as the working manuscript
• create a timestamped backup before any structural edit
• keep all later edits on that working file only

Do not start direct editing on the wrong file under any circumstance.

Step 2: Format Baseline Extraction

Read references/zjkj-undergrad-thesis-format.md and the provided school sample.

Extract and enforce:

• cover structure
• originality statement
• copyright authorization
• Chinese abstract page
• English abstract page
• automatic table of contents
• heading hierarchy
• body typography
• figure/table caption style
• references
• acknowledgement
• appendices

Step 3: Draft Audit

Scan the current draft and mark:

• content to keep
• content to rewrite
• content to delete
• figures to replace
• figures/tables to preserve from the original draft
• formatting pollution to remove

Specifically remove:

• colored titles
• hyperlink-style headings
• template prompts
• revision notes
• unsupported data claims
• decorative figures

Step 3A: Detection-Report Triage

If the user provided similarity or AIGC reports, read references/detection-report-rewrite-playbook.md.

At this stage:

• extract the latest score and hotspot pages
• map each hotspot back to the copied draft
• decide whether each hotspot needs heavy structural rewriting or light cleanup

Step 3B: Existing-Draft Continuation / Salvage Mode

Use this mode when the user has already hand-edited part of the draft or asks to keep specific old content.

In this mode:

• identify the true working DOCX first
• identify the protected backup/original DOCX second
• detect replacement boundaries by body heading style, not by table-of-contents text
• never use TOC paragraphs as anchors for section replacement
• when the user asks to replace only content before or after a section such as 2.3, edit only that body span
• preserve untouched manual edits outside the requested span
• if the user asks to keep an original E-R figure, per-table database description, or other supported legacy asset, restore it from backup instead of regenerating it

Step 4: Rewrite The Thesis Body

Rewrite chapter by chapter using only project-supported evidence.

Typical chapter responsibilities:

• Introduction: background, significance, scope, chapter arrangement
• Requirements analysis: roles, workflows, functional and non-functional requirements
• Overall design: architecture, modules, data design, security/control strategy
• Detailed implementation: real mechanisms from code and config
• Testing: real functional verification and conservative summary
• Conclusion: summarize actual completed work and future improvements

For every section:

• prefer precise engineering wording
• avoid exaggerated novelty language
• avoid unsupported metrics
• remove any instruction text before final assembly

When the task includes lowering similarity or AIGC risk, apply these rewrite rules:

• follow the rewrite principles and transformations in references/detection-report-rewrite-playbook.md
• keep technical facts, chapter structure, figure/table numbering, and citations stable unless they are unsupported
• preserve meaning first; score reduction is secondary to factual accuracy

Step 4A: Anti-AIGC / Anti-Similarity Rewrite Loop

When the user gives a target such as "降到 10% 以下":

1. attack the highest-yield hotspots first
2. rebuild the copied manuscript
3. if the user brings back a newer report, repeat the triage -> rewrite -> rebuild loop
4. in later rounds, focus only on the remaining hotspot pages instead of rewriting the whole paper again

Do not promise a score in advance. The composer's responsibility is to maximize safe, evidence-preserving reductions.

Step 5: Figures, Legacy Assets, And Database Tables

If the thesis already contains a supported original figure or table block that the user wants to keep:

• preserve or restore it from the backup/original draft
• keep the caption style consistent with the school sample
• renumber later figures/tables only when necessary

Common salvage cases include:

• original E-R figure blocks
• per-table database field-description blocks
• screenshots already extracted from a valid older manuscript
• original engineering diagrams that still match the project

Only redraw through drawio when the figure is missing, unsupported, or visually unsuitable.