paper-spine-audit

name	paper-spine-audit
description	Audits PaperSpine outputs for missing artifacts, shallow revisions, logic transfer, unsupported claims, and translation coverage. (internal /paperspine step)

PaperSpine Audit

Use this skill before calling a PaperSpine rewrite or build complete.

Required Checks

1. Artifact completeness.
2. Reference material workspace exists and has a source index.
3. Motivation was confirmed by the user after research, not invented before research.
4. writing_rationale_matrix.md exists, is ordered, and covers the whole-work framework plus the task-specific writing units for the selected scene. It should split the paper/report into paragraph-sized, claim-sized, evidence, model, synthesis, heading, caption, or competition-solution units as needed; it must not be a fixed IMRaD checklist when the task is not an IMRaD paper. The first row must deeply justify the whole-work framework, and each row must include concrete motivation, reference/SOTA, target-scene, evidence, and planned text-move anchors rather than short labels.
5. No append-only or shallow revision for substantive rewrite tasks.
6. Logic transfer from original draft or materials to final manuscript.
7. Claim support from user evidence.
8. LaTeX citation, label, and figure safety when a LaTeX project exists.
9. citation_support_bank.md count, recency, and per-paper support-sentence quality before citations are selected for Introduction/Discussion.
10. Final LaTeX source exists; compiled PDF exists when a TeX engine is available.
11. Word output is structurally valid when a .docx is requested or generated.
12. Translation coverage is complete when translation_package is zh, including full_paper_translation.zh.md for the complete final paper text and row-by-row translation of large intermediate artifacts such as writing_rationale_matrix.md.

Scripts

Run when available:

python scripts/integrity_audit.py paper_rewriting_output --markdown --write
python scripts/artifact_check.py paper_rewriting_output --markdown --write
python scripts/revision_audit.py <original> <revised> --markdown
python scripts/structured_review.py paper_rewriting_output --dispatch
# Then: launch three parallel sub-agents per review_prompts/dispatch.md
# After sub-agents complete: python scripts/structured_review.py paper_rewriting_output --validate review_prompts
python scripts/citation_quality_audit.py paper_rewriting_output --write
python scripts/latex_guard.py <main.tex> --bib <references.bib> --markdown
python scripts/word_guard.py paper_rewriting_output/final_paper/paper.docx --markdown --output paper_rewriting_output/word_report.md

Multi-Agent Review Flow

The structured review uses independent sub-agents for genuine reviewer independence:

1. Run structured_review.py --dispatch to generate three isolated reviewer prompts under review_prompts/.
2. Read review_prompts/dispatch.md and launch three Agent calls in parallel. Each agent reads ONLY its own prompt file and the manuscript.
3. After all three agents write their output files, run structured_review.py --validate review_prompts to check independence (cross-contamination detection via text similarity).
4. Produce Editor Synthesis merging the three independent reviews.

Required Outputs

• paper_rewriting_output/integrity_audit.md
• paper_rewriting_output/artifact_check.md
• paper_rewriting_output/revision_audit.md for rewrite tasks
• paper_rewriting_output/structured_review.md
• paper_rewriting_output/citation_quality_audit.md
• paper_rewriting_output/logic_transfer_audit.md
• unresolved risks and user decisions

Do not mark the task complete if required artifacts are missing, if the final manuscript contains unsupported claims, if translation is partial, or if the rationale matrix is generic.