Skip to content
Back to search

enhanced-mathmodel-codex-skills

增强版的数学建模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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xzwwwwww--enhanced-mathmodel-codex-skills/badge.svg)](/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)

  1. # Enhanced MathModel Codex Skills
  2. 增强版数学建模 Codex skills 套件,用于把数学建模赛题从“题面与附件”推进到“模型路线、实验模板、论文草稿、Word 文档和最终 QA 报告”。
  3. 本仓库基于 Codex 全局 skills 机制组织,**只使用全局路径 `~/.codex/skills`**。
  4. ## 能做什么
  5. 这套 skills 主要覆盖数学建模论文生产的完整流程:
  6. 1. 读取赛题文件,拆解问题一/二/三。
  7. 2. 判断任务类型,例如预测、评价、优化、聚类、仿真、图论等。
  8. 3. 生成模型推荐路线,包括基线模型、改进模型、评价指标、验证方式和风险点。
  9. 4. 根据模型路线生成可运行实验模板。
  10. 5. 清洗附件数据并生成探索性图表。
  11. 6. 生成论文微单元任务清单。
  12. 7. 批量生成论文微单元并合并为 `final_paper.md`。
  13. 8. 生成 `final_paper.docx`。
  14. 9. 执行最终 QA,检查占位符、章节缺失、图表断链、基线/验证缺失、Word 是否存在等问题。
  15. ## Skills 组成
  16. | Skill | 作用 |
  17. |---|---|
  18. | `paper-workflow-orchestrator` | 一键总流程入口,负责串联所有步骤。 |
  19. | `problem-doc-model-selector` | 解析赛题 PDF/DOCX/TXT,生成问题映射和外部数据需求。 |
  20. | `modeling-paper-rubric-and-model-selector` | 模型方法库、结构化模型推荐、实验模板生成。 |
  21. | `data-cleaning-and-visualization` | 清洗附件/外部数据并生成 EDA 图表。 |
  22. | `quality-assurance-auditor` | 生成任务清单,并做最终论文质量审计。 |
  23. | `paper-micro-unit-generator` | 按任务清单生成微单元并合并论文。 |
  24. | `authoritative-data-harvester` | 根据 `data_requirements.json` 获取或提示补充外部数据。 |
  25. | `context-memory-keeper` | 记录阶段状态、文献/数据来源和上下文记忆。 |
  26. ## 安装
  27. 将本仓库的 `skills/` 下所有目录复制到全局 Codex skills 目录:
  28. ```bash
  29. cp -R skills/* ~/.codex/skills/
  30. ```
  31. 然后重启 Codex,使新 skills 生效。
  32. 安装后目录应类似:
  33. ```text
  34. ~/.codex/skills/
  35. ├── authoritative-data-harvester/
  36. ├── context-memory-keeper/
  37. ├── data-cleaning-and-visualization/
  38. ├── modeling-paper-rubric-and-model-selector/
  39. ├── paper-micro-unit-generator/
  40. ├── paper-workflow-orchestrator/
  41. ├── problem-doc-model-selector/
  42. └── quality-assurance-auditor/
  43. ```
  44. ## 项目目录结构
  45. 每个数学建模项目建议使用独立目录。进入项目目录后运行总流程。
  46. ```text
  47. your-mathmodel-project/
  48. ├── problem_files/ # 放赛题 PDF/DOCX/TXT 和附件数据
  49. ├── crawled_data/ # 可选,放外部补充数据
  50. └── paper_output/ # 自动生成,存放所有输出
  51. ```
  52. 初始化项目目录:
  53. ```bash
  54. python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py --init-only
  55. ```
  56. 然后把赛题和附件放入:
  57. ```text
  58. problem_files/
  59. ```
  60. 支持常见文件:
  61. - `.txt`
  62. - `.md`
  63. - `.csv`
  64. - `.xlsx`
  65. - `.xls`
  66. - `.docx`
  67. - `.pdf`
  68. PDF/DOCX 解析依赖本机是否安装了对应 Python 包;如果缺少依赖,脚本会降级提示。
  69. ## 一键运行
  70. 在项目根目录运行:
  71. ```bash
  72. python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py
  73. ```
  74. 总流程会依次执行:
  75. ```text
  76. 赛题解析
  77. -> 外部数据需求检查
  78. -> 模型推荐
  79. -> 实验模板生成
  80. -> 数据清洗与可视化
  81. -> QA 任务清单
  82. -> 微单元生成
  83. -> 合并 Markdown
  84. -> 生成 Word
  85. -> 最终 QA 审计
  86. ```
  87. 如果 `problem_files/` 为空,流程会阻塞并提示你先放入赛题和附件。
  88. ## 输出产物
  89. 运行后主要产物在 `paper_output/`:
  90. ```text
  91. paper_output/
  92. ├── step1/
  93. │ ├── problem_analysis.md # 赛题解析报告
  94. │ └── question_map.json # 子问题、任务类型、约束、指标映射
  95. ├── plan/
  96. │ ├── model_recommendations.md # 模型推荐报告
  97. │ └── model_recommendations.json
  98. ├── experiments/
  99. │ ├── experiment_templates.md
  100. │ ├── experiment_templates_manifest.json
  101. │ └── *.py # 可运行实验模板
  102. ├── data_cleaned/ # 清洗后的数据
  103. ├── figures/ # 自动生成的图表
  104. ├── tasks.json # 微单元任务清单
  105. ├── micro_units/ # 微单元文本
  106. ├── generate_log.json # 生成日志
  107. ├── final_paper.md # 合并后的论文草稿
  108. ├── final_paper.docx # Word 版本
  109. ├── ref_check.md # 图表/公式引用检查
  110. ├── qa_report.md # 最终 QA 报告
  111. └── qa_report.json
  112. ```
  113. ## 两种启动模式
  114. ### 1. 一键总流程模式
  115. 适合想直接从赛题跑到论文草稿:
  116. ```bash
  117. python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py
  118. ```
  119. ### 2. 分步模式
  120. 适合调试、补跑或单独使用某个能力。
  121. 只初始化目录:
  122. ```bash
  123. python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py --init-only
  124. ```
  125. 只做最终 QA:
  126. ```bash
  127. python ~/.codex/skills/paper-workflow-orchestrator/scripts/run_mathmodel.py --audit-only
  128. ```
  129. 只解析赛题:
  130. ```bash
  131. python ~/.codex/skills/problem-doc-model-selector/scripts/parse_problem.py --project . --write-data-requirements
  132. ```
  133. 只生成模型推荐:
  134. ```bash
  135. python ~/.codex/skills/modeling-paper-rubric-and-model-selector/scripts/recommend_models.py \
  136. --file problem_files/problem.txt
  137. ```
  138. 只生成实验模板:
  139. ```bash
  140. python ~/.codex/skills/modeling-paper-rubric-and-model-selector/scripts/generate_experiment_templates.py --project .
  141. ```
  142. 只做数据清洗与可视化:
  143. ```bash
  144. python ~/.codex/skills/data-cleaning-and-visualization/scripts/run_pipeline.py
  145. ```
  146. 只生成任务清单:
  147. ```bash
  148. python ~/.codex/skills/quality-assurance-auditor/scripts/pipeline.py
  149. ```
  150. 只生成微单元:
  151. ```bash
  152. python ~/.codex/skills/paper-micro-unit-generator/scripts/generate_all_offline.py
  153. ```
  154. 只合并论文:
  155. ```bash
  156. python ~/.codex/skills/paper-micro-unit-generator/scripts/merge.py
  157. ```
  158. ## 实验模板
  159. 模型推荐完成后,会根据推荐类型生成实验模板到:
  160. ```text
  161. paper_output/experiments/
  162. ```
  163. 当前模板包括:
  164. - `forecasting_regression.py`:预测/回归基线。
  165. - `evaluation_ranking.py`:熵权 TOPSIS 综合评价。
  166. - `optimization_scheduling.py`:资源分配/0-1 优化基线。
  167. - `clustering_profile.py`:K-means 聚类画像。
  168. - `sensitivity_analysis.py`:参数扰动敏感性分析。
  169. - `monte_carlo_simulation.py`:Monte Carlo 不确定性仿真。
  170. 这些模板是可运行起点,不是最终答案。你需要根据赛题字段、目标函数和约束进一步修改。
  171. ## 依赖说明
  172. 核心流程尽量做了降级处理,但以下包会增强能力:
  173. ```bash
  174. pip install pandas numpy matplotlib seaborn python-docx requests
  175. ```
  176. 可选 PDF 解析:
  177. ```bash
  178. pip install pymupdf pdfplumber
  179. ```
  180. 如果缺少 `pandas` 或 `seaborn`,数据清洗/可视化会跳过,但总流程仍会继续生成论文骨架和 QA 报告。
  181. ## 路径策略
  182. 本套件已经去掉 `.trae/skills` 和项目内 `.codex/skills` 兼容逻辑。
  183. 技能代码只从:
  184. ```text
  185. ~/.codex/skills
  186. ```
  187. 读取。
  188. 项目目录只用于:
  189. - 读取 `problem_files/`
  190. - 读取 `crawled_data/`
  191. - 写入 `paper_output/`
  192. - 写入可选的 `data_requirements.json`
  193. ## 常见问题
  194. ### 1. 提示 `problem_files/ 为空`
  195. 把赛题 PDF/DOCX/TXT 和附件数据放入:
  196. ```text
  197. problem_files/
  198. ```
  199. 再运行一键流程。
  200. ### 2. 数据清洗被跳过
  201. 通常是缺少依赖:
  202. ```bash
  203. pip install pandas numpy matplotlib seaborn
  204. ```
  205. ### 3. 没有生成图表
  206. 可能原因:
  207. - 附件数据不是 CSV/Excel/TXT。
  208. - 缺少 `pandas`、`matplotlib` 或 `seaborn`。
  209. - 数据中没有足够的数值列。
  210. ### 4. Word 里的公式是 LaTeX 源码
  211. 当前 `final_paper.docx` 由 `python-docx` 直接生成,公式会以 LaTeX 源码形式保留。需要正式排版时,可在 Word 中用 MathType 或公式工具进一步处理。
  212. ### 5. QA 报告通过但论文还不够正式
  213. QA 只检查结构性问题,例如缺章节、占位符、断链、基线/验证描述等。正式参赛前仍需要人工补充真实实验结果、图表解释、参考文献和排版。
  214. ## 推荐工作方式
  215. 1. 新建项目目录。
  216. 2. 运行 `--init-only`。
  217. 3. 放入赛题和附件。
  218. 4. 运行一键总流程。
  219. 5. 查看 `paper_output/step1/problem_analysis.md` 和 `paper_output/plan/model_recommendations.md`。
  220. 6. 修改 `paper_output/experiments/` 中的实验模板,跑出真实结果。
  221. 7. 重新运行合并和 QA。
  222. 8. 人工润色 `final_paper.docx`。
  223. ## 仓库内容
  224. ```text
  225. .
  226. ├── README.md
  227. ├── .gitignore
  228. └── skills/
  229. ├── authoritative-data-harvester/
  230. ├── context-memory-keeper/
  231. ├── data-cleaning-and-visualization/
  232. ├── modeling-paper-rubric-and-model-selector/
  233. ├── paper-micro-unit-generator/
  234. ├── paper-workflow-orchestrator/
  235. ├── problem-doc-model-selector/
  236. └── quality-assurance-auditor/
  237. ```
  238. ## 安全提醒
  239. 不要把 GitHub token、私有数据、未公开赛题答案或个人隐私数据提交到仓库。`problem_files/`、`paper_output/`、`crawled_data/` 已在 `.gitignore` 中忽略。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.