Back to search
enhanced-mathmodel-codex-skills
SkillWorks with CodexGitHub
增强版的数学建模skills,专门用于codex智能体使用,全流程自动生成一篇数学建模论文
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/xzwwwwww--enhanced-mathmodel-codex-skills)HTML
<a href="/listings/xzwwwwww--enhanced-mathmodel-codex-skills"><img src="/api/listings/xzwwwwww--enhanced-mathmodel-codex-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
将本仓库的 `skills/` 下所有目录复制到全局 Codex skills 目录:
cp -R skills/* ~/.codex/skills/
然后重启 Codex,使新 skills 生效。
安装后目录应类似:
~/.codex/skills/ ├── authoritative-data-harvester/ ├── context-memory-keeper/ ├── data-cleaning-and-visualization/ ├── modeling-paper-rubric-and-model-selector/ ├── paper-micro-unit-generator/ ├── paper-workflow-orchestrator/ ├── problem-doc-model-selector/ └── quality-assurance-auditor/
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 335 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Enhanced MathModel Codex Skills
- 增强版数学建模 Codex skills 套件,用于把数学建模赛题从“题面与附件”推进到“模型路线、实验模板、论文草稿、Word 文档和最终 QA 报告”。
- 本仓库基于 Codex 全局 skills 机制组织,**只使用全局路径 `~/.codex/skills`**。
- ## 能做什么
- 这套 skills 主要覆盖数学建模论文生产的完整流程:
- 1. 读取赛题文件,拆解问题一/二/三。
- 2. 判断任务类型,例如预测、评价、优化、聚类、仿真、图论等。
- 3. 生成模型推荐路线,包括基线模型、改进模型、评价指标、验证方式和风险点。
- 4. 根据模型路线生成可运行实验模板。
- 5. 清洗附件数据并生成探索性图表。
- 6. 生成论文微单元任务清单。
- 7. 批量生成论文微单元并合并为 `final_paper.md`。
- 8. 生成 `final_paper.docx`。
- 9. 执行最终 QA,检查占位符、章节缺失、图表断链、基线/验证缺失、Word 是否存在等问题。
- ## Skills 组成
- | Skill | 作用 |
- |---|---|
- | `paper-workflow-orchestrator` | 一键总流程入口,负责串联所有步骤。 |
- | `problem-doc-model-selector` | 解析赛题 PDF/DOCX/TXT,生成问题映射和外部数据需求。 |
- | `modeling-paper-rubric-and-model-selector` | 模型方法库、结构化模型推荐、实验模板生成。 |
- | `data-cleaning-and-visualization` | 清洗附件/外部数据并生成 EDA 图表。 |
- | `quality-assurance-auditor` | 生成任务清单,并做最终论文质量审计。 |
- | `paper-micro-unit-generator` | 按任务清单生成微单元并合并论文。 |
- | `authoritative-data-harvester` | 根据 `data_requirements.json` 获取或提示补充外部数据。 |
- | `context-memory-keeper` | 记录阶段状态、文献/数据来源和上下文记忆。 |
- ## 安装
- 将本仓库的 `skills/` 下所有目录复制到全局 Codex skills 目录:
- ```bash
- cp -R skills/* ~/.codex/skills/
- ```
- 然后重启 Codex,使新 skills 生效。
- 安装后目录应类似:
- ```text
- ~/.codex/skills/
- ├── authoritative-data-harvester/
- ├── context-memory-keeper/
- ├── data-cleaning-and-visualization/
- ├── modeling-paper-rubric-and-model-selector/
- ├── paper-micro-unit-generator/
- ├── paper-workflow-orchestrator/
- ├── problem-doc-model-selector/
- └── quality-assurance-auditor/
- ```
- ## 项目目录结构
- 每个数学建模项目建议使用独立目录。进入项目目录后运行总流程。
- ```text
- your-mathmodel-project/
- ├── problem_files/ # 放赛题 PDF/DOCX/TXT 和附件数据
- ├── crawled_data/ # 可选,放外部补充数据
- └── paper_output/ # 自动生成,存放所有输出
- ```
- 初始化项目目录:
- ```bash
- python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py --init-only
- ```
- 然后把赛题和附件放入:
- ```text
- problem_files/
- ```
- 支持常见文件:
- - `.txt`
- - `.md`
- - `.csv`
- - `.xlsx`
- - `.xls`
- - `.docx`
- - `.pdf`
- PDF/DOCX 解析依赖本机是否安装了对应 Python 包;如果缺少依赖,脚本会降级提示。
- ## 一键运行
- 在项目根目录运行:
- ```bash
- python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py
- ```
- 总流程会依次执行:
- ```text
- 赛题解析
- -> 外部数据需求检查
- -> 模型推荐
- -> 实验模板生成
- -> 数据清洗与可视化
- -> QA 任务清单
- -> 微单元生成
- -> 合并 Markdown
- -> 生成 Word
- -> 最终 QA 审计
- ```
- 如果 `problem_files/` 为空,流程会阻塞并提示你先放入赛题和附件。
- ## 输出产物
- 运行后主要产物在 `paper_output/`:
- ```text
- paper_output/
- ├── step1/
- │ ├── problem_analysis.md # 赛题解析报告
- │ └── question_map.json # 子问题、任务类型、约束、指标映射
- ├── plan/
- │ ├── model_recommendations.md # 模型推荐报告
- │ └── model_recommendations.json
- ├── experiments/
- │ ├── experiment_templates.md
- │ ├── experiment_templates_manifest.json
- │ └── *.py # 可运行实验模板
- ├── data_cleaned/ # 清洗后的数据
- ├── figures/ # 自动生成的图表
- ├── tasks.json # 微单元任务清单
- ├── micro_units/ # 微单元文本
- ├── generate_log.json # 生成日志
- ├── final_paper.md # 合并后的论文草稿
- ├── final_paper.docx # Word 版本
- ├── ref_check.md # 图表/公式引用检查
- ├── qa_report.md # 最终 QA 报告
- └── qa_report.json
- ```
- ## 两种启动模式
- ### 1. 一键总流程模式
- 适合想直接从赛题跑到论文草稿:
- ```bash
- python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py
- ```
- ### 2. 分步模式
- 适合调试、补跑或单独使用某个能力。
- 只初始化目录:
- ```bash
- python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py --init-only
- ```
- 只做最终 QA:
- ```bash
- python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py --audit-only
- ```
- 只解析赛题:
- ```bash
- python ~/.codex/skills/problem-doc-model-selector/scripts/parse_problem.py --project . --write-data-requirements
- ```
- 只生成模型推荐:
- ```bash
- python ~/.codex/skills/modeling-paper-rubric-and-model-selector/scripts/recommend_models.py \
- --file problem_files/problem.txt
- ```
- 只生成实验模板:
- ```bash
- python ~/.codex/skills/modeling-paper-rubric-and-model-selector/scripts/generate_experiment_templates.py --project .
- ```
- 只做数据清洗与可视化:
- ```bash
- python ~/.codex/skills/data-cleaning-and-visualization/scripts/run_pipeline.py
- ```
- 只生成任务清单:
- ```bash
- python ~/.codex/skills/quality-assurance-auditor/scripts/pipeline.py
- ```
- 只生成微单元:
- ```bash
- python ~/.codex/skills/paper-micro-unit-generator/scripts/generate_all_offline.py
- ```
- 只合并论文:
- ```bash
- python ~/.codex/skills/paper-micro-unit-generator/scripts/merge.py
- ```
- ## 实验模板
- 模型推荐完成后,会根据推荐类型生成实验模板到:
- ```text
- paper_output/experiments/
- ```
- 当前模板包括:
- - `forecasting_regression.py`:预测/回归基线。
- - `evaluation_ranking.py`:熵权 TOPSIS 综合评价。
- - `optimization_scheduling.py`:资源分配/0-1 优化基线。
- - `clustering_profile.py`:K-means 聚类画像。
- - `sensitivity_analysis.py`:参数扰动敏感性分析。
- - `monte_carlo_simulation.py`:Monte Carlo 不确定性仿真。
- 这些模板是可运行起点,不是最终答案。你需要根据赛题字段、目标函数和约束进一步修改。
- ## 依赖说明
- 核心流程尽量做了降级处理,但以下包会增强能力:
- ```bash
- pip install pandas numpy matplotlib seaborn python-docx requests
- ```
- 可选 PDF 解析:
- ```bash
- pip install pymupdf pdfplumber
- ```
- 如果缺少 `pandas` 或 `seaborn`,数据清洗/可视化会跳过,但总流程仍会继续生成论文骨架和 QA 报告。
- ## 路径策略
- 本套件已经去掉 `.trae/skills` 和项目内 `.codex/skills` 兼容逻辑。
- 技能代码只从:
- ```text
- ~/.codex/skills
- ```
- 读取。
- 项目目录只用于:
- - 读取 `problem_files/`
- - 读取 `crawled_data/`
- - 写入 `paper_output/`
- - 写入可选的 `data_requirements.json`
- ## 常见问题
- ### 1. 提示 `problem_files/ 为空`
- 把赛题 PDF/DOCX/TXT 和附件数据放入:
- ```text
- problem_files/
- ```
- 再运行一键流程。
- ### 2. 数据清洗被跳过
- 通常是缺少依赖:
- ```bash
- pip install pandas numpy matplotlib seaborn
- ```
- ### 3. 没有生成图表
- 可能原因:
- - 附件数据不是 CSV/Excel/TXT。
- - 缺少 `pandas`、`matplotlib` 或 `seaborn`。
- - 数据中没有足够的数值列。
- ### 4. Word 里的公式是 LaTeX 源码
- 当前 `final_paper.docx` 由 `python-docx` 直接生成,公式会以 LaTeX 源码形式保留。需要正式排版时,可在 Word 中用 MathType 或公式工具进一步处理。
- ### 5. QA 报告通过但论文还不够正式
- QA 只检查结构性问题,例如缺章节、占位符、断链、基线/验证描述等。正式参赛前仍需要人工补充真实实验结果、图表解释、参考文献和排版。
- ## 推荐工作方式
- 1. 新建项目目录。
- 2. 运行 `--init-only`。
- 3. 放入赛题和附件。
- 4. 运行一键总流程。
- 5. 查看 `paper_output/step1/problem_analysis.md` 和 `paper_output/plan/model_recommendations.md`。
- 6. 修改 `paper_output/experiments/` 中的实验模板,跑出真实结果。
- 7. 重新运行合并和 QA。
- 8. 人工润色 `final_paper.docx`。
- ## 仓库内容
- ```text
- .
- ├── README.md
- ├── .gitignore
- └── skills/
- ├── authoritative-data-harvester/
- ├── context-memory-keeper/
- ├── data-cleaning-and-visualization/
- ├── modeling-paper-rubric-and-model-selector/
- ├── paper-micro-unit-generator/
- ├── paper-workflow-orchestrator/
- ├── problem-doc-model-selector/
- └── quality-assurance-auditor/
- ```
- ## 安全提醒
- 不要把 GitHub token、私有数据、未公开赛题答案或个人隐私数据提交到仓库。`problem_files/`、`paper_output/`、`crawled_data/` 已在 `.gitignore` 中忽略。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.