a5237

Mathematical Modeling Workspace — Development skill for Claude Code

Development community

该项目用于全国大学生数学建模大赛(CUMCM).

How to install Mathematical Modeling Workspace

This entry records only its repository, not the path inside it, so there is no exact command to give. Open a5237/mathematical-modeling-workspace and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mathematical Modeling Workspace does

该项目用于全国大学生数学建模大赛(CUMCM)。可用于codex,claude code,deepseek harness等agent分析题目,编写代码并生成论文

Alternatives in Development

  • IPolloWork — Enterprise-grade, local-first Agent Workbench for people and agent teams 4.9k ★
  • Petdex — A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and 4k ★
  • AutoSwarm — AutoSwarm: All Your Agents, Working as One (Codex · Claude Code · DeepSeek Harness · Muse · Grok · WorkBuddy· 1.9k ★

README

全国大学生数学建模工作区

这是一个面向长期复用的数学建模工作区。仓库按“文档、配置、工具、资源、工作数据、运行时产物”分层,正式赛题仍在各自项目内使用 `00-admin` 至 `08-delivery` 的可复现生产结构。

目录

快速上手工作区

如何开启你的第一次建模?请跟着以下步骤快速进行。

第1步:搭建 Python 环境

在项目根目录双击`setup.bat`(或在 PowerShell 中执行 `.\setup.bat`)。

这个脚本会自动:

  • 检测你电脑上的 Python 版本(3.10 ~ 3.13)
  • 创建虚拟环境 .venv-modeling/
  • 安装 config/python/requirements-modeling.txt 中列出的所有依赖
  • 检查 LaTeX 环境(xelatex)是否可用

如果提示“找不到 Python”,请先安装 Python 3.10 ~ 3.13 中的任一版本,并确保 `py` 启动器可用。

第2步:了解项目结构


config/          → 依赖清单(一般不用动)
docs/            → 所有规范和指南(遇到问题先翻这里)
resources/       → 算法资料、优秀论文、模板(写作前可以翻翻)
tools/           → 辅助工具脚本(需要时可以调用)
workspace/       → 你的工作区
  ├── inbox/     → 新赛题暂存(放题目、附件的临时位置)
  ├── projects/  → 正式赛题项目(每一道题一个独立目录)
  └── archive/   → 历史归档(不再使用的旧项目)
  

第3步:开始你的第一道赛题

  1. 将原始赛题 PDF 和附件放入 workspace/inbox/
  2. 在 Codex / Claude Code / DeepSeek Harness 中启动 Agent,提示词指向该inbox目录
  3. Agent 会先读取轻量的 AGENTS.md,再按当前阶段只加载数据、建模、证据、写作、排版、图片或审校所需规范
  4. 人类在 Day 3-4 介入审校和交付检查

仓库分层

.
├── config/                 # 依赖锁定与工作区级配置
├── docs/                   # 架构、规范与操作指南
├── resources/              # 算法资料、模板和优秀论文参考库
├── tools/                  # 跨项目通用工具
├── workspace/              # inbox、正式项目和历史归档
├── var/                    # 可删除的运行时与临时产物
├── .codex/                 # Codex 本地 Skills
├── .venv-modeling/         # 本机 Python 建模环境,不纳入 Git
├── ENV_SETUP.md 		   # 虚拟环境重建说明,由独立贡献者维护
├── AGENTS.md               # Agent 轻量任务路由入口
├── README.md               # 仓库入口
└── setup.bat               # Windows 环境引导脚本,由独立贡献者维护

完整职责和项目目录树见[工作区架构](docs/architecture/workspace-layout.md),文档总索引见[文档中心](docs/README.md)。

关键文件说明

文件 用途 什么时候用
setup.bat 一键搭建 Python 虚拟环境 + 安装依赖 首次使用,或环境损坏时
`tools/updat