Skip to content
cccskills
FreePublished on GitHub

paper-workflow-orchestrator

Run or resume the complete Standard mathematical-modeling workflow from contest files through reproducible evidence, adaptive formal writing, native-equation Word output, and final render QA. Use as the entry point for complete-paper requests.

The English summary is being prepared. Showing the original description.

See how to install

Files included (9)

  • SKILL.md6.5 KB
  • agents/openai.yaml353 B
  • MATHMODEL_EDITION.json4.0 KB
  • scripts/installation.py21.2 KB
  • scripts/preflight_check.py23.0 KB
  • scripts/prepare_output_layout.py6.6 KB
  • scripts/quickstart_run.py5.8 KB
  • scripts/run_all.py1.5 KB
  • scripts/workflow_guard.py32.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

MathModel Standard Orchestrator

Resolve <SKILL_ROOT> to the parent directory of this loaded skill folder, using its actual absolute path. Run commands from the contest project root, never from the installed skill directory. The placeholder is not a shell environment variable.

Use this skill as the only entry router for a complete competition-paper task. Standard targets strong models that can maintain a long evidence chain and execute tools reliably while keeping cost controlled. It does not use Pro multi-agent tournaments or approval checkpoints.

Start Or Resume

From the contest project root, run:

python "<SKILL_ROOT>/paper-workflow-orchestrator/scripts/preflight_check.py"
python "<SKILL_ROOT>/paper-workflow-orchestrator/scripts/workflow_guard.py" --status

Read paper_output/qa/workflow_guard_report.json and follow recommended_skill plus next_action. The current files and hashes override conversational memory.

Do not run downstream skills before their guard requirement passes. After a child skill finishes, return here and evaluate status again.

S0-S8

S0 Input Admission

preflight_check.py inventories problem_files/, hashes every input, checks runtime dependencies, prepares paper_output/, and rejects mixed MathModel editions. Required outputs:

  • paper_output/preflight_report.json
  • paper_output/input_manifest.json
  • paper_output/OUTPUT_LAYOUT.md

S1 Problem Analysis

Use problem-doc-model-selector to create paper_output/step1/problem_analysis.json. Every question, attachment, field, objective, constraint, ambiguity, and required output must be traceable.

S2 Model And Rubric Route

Use modeling-paper-rubric-and-model-selector. Produce:

  • paper_output/plan/model_route.json
  • paper_output/plan/rubric_alignment.json
  • paper_output/plan/scoring_strategy.md

Use authoritative-data-harvester only when public external data is necessary. Keep source identity and retrieval notes.

S3 Data And Visualization Plan

Use data-cleaning-and-visualization. Read only files classified in the input manifest and produce a fresh load report, data plan, visualization plan, figure index, and cleaned data. Contest-specific code belongs under paper_output/code/, never inside installed skills.

S4 Reproducible Model Code

Use model-code-and-result-generator to write question-specific code under paper_output/code/modeling/, including run_modeling.py and per-question modules. Code must emit machine-readable result contracts.

S5 Real Execution

Run the modeling code. Preserve script, input, output, exit-code, size, and SHA-256 records in paper_output/results/run_manifest.json. Required evidence includes model results, finite metrics, conclusions, tables, and usable figures. Draft placeholders do not count.

S6 Evidence Gate

Use quality-assurance-auditor and run official evidence validation:

python "<SKILL_ROOT>/quality-assurance-auditor/scripts/evidence_gate.py" --mode official

Do not enter formal writing until paper_output/qa/evidence_gate_report.json is PASS and all recorded inputs are still fresh.

S7 Adaptive Formal Writing

Use paper-formal-writer as the sole formal author:

python "<SKILL_ROOT>/paper-formal-writer/scripts/build_paper_outline.py"
python "<SKILL_ROOT>/paper-formal-writer/scripts/prepare_authoring.py" --mode auto

Normal competition papers use complete-section drafting, possibly over several turns. Preserve the formal writer's declared competition scope; a short report needs an explicit user-requested scope and reason. Audit every draft with validate_authoring.py --section; global repeated failure falls back to section mode. A section’s second repeated category creates a micro-repair route; only then may paper-micro-unit-generator repair the queued location. The third repeated category blocks S7 and suggests Lite without switching automatically.

After every active unit passes:

python "<SKILL_ROOT>/paper-formal-writer/scripts/assemble_sections.py"
python "<SKILL_ROOT>/paper-formal-writer/scripts/validate_authoring.py" --assembled

The Agent must then globally revise the full assembly into paper_output/final_paper_source.md; a copy-only promotion is rejected. Finish with:

python "<SKILL_ROOT>/paper-formal-writer/scripts/validate_authoring.py" --final
python "<SKILL_ROOT>/paper-formal-writer/scripts/format_formal_docx.py"

S8 Format And Render Gate

Run:

python "<SKILL_ROOT>/paper-formal-writer/scripts/check_paper_format.py" --render required

Delivery requires a fresh PASS in paper_output/format_check_report.json. Fix the reported source, formula, citation, figure/table, DOCX, pagination, or PDF issue and rerun; never edit the report to force PASS.

Formal Outputs

paper_output/plan/writing_plan.json
paper_output/context/authoring_state.json
paper_output/qa/draft_audit.json
paper_output/qa/repair_queue.json
paper_output/drafts/sections/*.md
paper_output/drafts/assembled_draft.md
paper_output/final_paper_source.md
paper_output/final_paper.docx
paper_output/format_check_report.json

Legacy micro-unit and quickstart outputs remain under paper_output/drafts/legacy/ and paper_output/quickstart/. They can never satisfy S7.

Non-Negotiable Invariants

  • Never invent model results, data sources, successful runs, citations, or validation.
  • Every critical numeric claim must trace to current machine-readable evidence.
  • Any upstream hash change invalidates dependent S6-S8 reports.
  • Each included figure/table must exist, be indexed, cited, and interpreted.
  • Formal formulas must become editable Word OMML; no screenshot or plain-text substitution.
  • Do not expose skill names, guard commands, or workflow prose in the paper body.
  • Do not write contest-specific code into installed skill directories.
  • Install one MathModel edition per contest project.

Recovery

For an interrupted or long task:

python "<SKILL_ROOT>/paper-workflow-orchestrator/scripts/workflow_guard.py" --status
python "<SKILL_ROOT>/context-memory-keeper/scripts/update_workflow_memory.py"

Read the guard report, current stage contracts, and paper_output/context/workflow_memory.json; continue from the first failing stage instead of replaying completed work.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

自动定位并获取权威公开数据(优先API/官方批量下载),输出可复现抓取与清洗方案。Invoke when用户需要权威数据、官方统计、API下载或数据源爬取。

The English summary is being prepared. Showing the original description.

yushui2022/MathModel-Skill456Updated Oct 19, 2026

Manages persistent memory. Invoke to read active context or archive old tasks. Structure: Long-term Principles (Rules) + Short-term Workbench (Tasks).

The English summary is being prepared. Showing the original description.

yushui2022/MathModel-Skill456Updated Oct 19, 2026

自动清洗赛题或爬取的数据(处理缺失/异常/格式),并生成可视化图表。Invoke when 用户需要处理原始数据、清洗数据或生成数据分析图表。

The English summary is being prepared. Showing the original description.

yushui2022/MathModel-Skill456Updated Oct 19, 2026

根据 model_route.json、数据计划和清洗数据,为数学建模论文生成结果证据契约和 q1/q2/q3 建模代码脚手架。Invoke when 需要把模型输出、评价指标、结构化结论、论文表格和当前赛题专用建模代码沉淀到 paper_output/results/、paper_output/tables/ 和 paper_output/code/modeling/,供 QA 与正文生成读取。

The English summary is being prepared. Showing the original description.

yushui2022/MathModel-Skill456Updated Oct 19, 2026

按常见评分点生成建模论文结构与写作清单,并根据题目类型与数据条件给出模型选择与对照实验路线。Invoke when需要“论文格式/评分对齐/模型选型/路线不确定”。

The English summary is being prepared. Showing the original description.

yushui2022/MathModel-Skill456Updated Oct 19, 2026

Plan, draft, audit, globally revise, format, and verify a formal mathematical-modeling paper after the Standard evidence gate passes. Use for the sole S7/S8 formal manuscript path, not for legacy micro-unit scaffolds.

The English summary is being prepared. Showing the original description.

yushui2022/MathModel-Skill456Updated Oct 19, 2026

See all skills by yushui2022

Report a problem with this skill