SYSTEM REQUIREMENTS
环境要求
| 组件 | 要求 | 说明 |
|---|---|---|
| Claude Code | 最新版本 | 通过 CLI 或 VS Code 扩展使用 |
| Node.js | ≥ 18.0 | Claude Code 运行依赖 |
| Git | 任意版本 | 用于安装技能文件 |
| Python（可选） | ≥ 3.9 | 运行 Python 算法代码时需要 |
| MATLAB（可选） | R2020b+ | 运行 MATLAB 代码时需要 |
提示：如果不使用 Python/MATLAB 代码运行功能，数学建模 skill 的提示词与流程功能仍可正常使用。
STEP BY STEP
安装步骤
安装 AI Agent（任选其一）
选择你日常使用的 AI 编程 Agent 安装即可。首推 Claude Code（完整支持渐进式 Skill 加载和子 Skill 调用），也可选择 Codex、Cursor、Trae、Qoder、Hermes Agent、OpenClaw 等兼容 Agent。
npm install -g @anthropic-ai/claude-code
# 或安装 Codex / Cursor / Trae / Qoder 等兼容 Agent
克隆技能仓库
将数学建模技能克隆到本地开发目录。
cd math-modeling-skill
配置技能到 Agent
将克隆后的项目目录放入对应 Agent 的 skills 目录（各 Agent 路径见下方说明）。配置后 Agent 启动时自动加载三角色规则、7 类算法资源库与 4 个子工具。
SKILL.md # 技能主入口（三角色调度 + 算法索引）
CLAUDE.md # Claude Code 项目配置
references/roles/ # 三角色规则与参考文档
建模手/ # 题目分析、模型选择、术语规范
编程手/ # 代码实现、SCI/Nature 可视化规范
论文手/ # 学术写作、去 AI 味润色、docx 输出
assets/ # 7 类 60+ 算法详细说明文档
tools/docx/ tools/pdf/ # 子工具：论文排版、文献处理
tools/xlsx/ tools/paper_search/ # 子工具：数据分析、学术搜索
启动 Agent 并验证
在项目目录中启动你所选的 Agent，技能将自动加载。输入斜杠指令确认技能是否可用。
# 输入 / 查看可用技能列表，出现 math-modeling 即安装成功
INSTALL PATHS
各 Agent 安装路径
克隆仓库后，将项目文件夹放入对应 Agent 的 skills 目录即可。
| Agent | 安装路径 | 说明 |
|---|---|---|
| Claude Code | ~/.claude/skills/math-modeling-skill | macOS / Linux；Windows 路径为 %USERPROFILE%\.claude\skills\math-modeling-skill |
| Codex | --skill-dir 参数指定 | 通过 CLI 启动参数指定 skills 目录路径 |
| Cursor | .cursor/skills/ | 在项目根目录创建 .cursor/skills/ 放入 |
| Trae | 通过插件市场配置 | 内置插件市场安装或配置 Skills 目录 |
| Qoder | 通过知识库配置 | 通过知识库或工作台配置导入 |
| Hermes Agent | skills import 命令 | 执行 skills import 命令导入 |
| OpenClaw | ~/.openclaw/skills/math-modeling-skill | 开源 Agent 网关，支持 3000+ Skill 和 23+ 消息平台 |
COMPATIBILITY
Agent 兼容性
| 推荐 | Agent | 兼容性 | 说明 |
|---|---|---|---|
| 首推 | Claude Code | 完全支持 | 完整支持渐进式 Skill 加载、子 Skill 调用和工具链集成 |
| 兼容 | Codex | 完全支持 | OpenAI 开源命令行编码 Agent，支持 MCP 协议与 Skill 加载 |
| 兼容 | Cursor | 完全支持 | AI-native IDE，支持 Agent 模式和第三方 Skill 集成 |
| 兼容 | Trae | 完全支持 | 字节跳动出品 AI-native IDE，支持 Skill 插件系统与 MCP 协议 |
| 兼容 | Qoder | 完全支持 | 阿里云出品 AI 编程 Agent 平台，支持自主开发工作台 |
| 兼容 | Hermes Agent | 完全支持 | 开源自进化 Agent 框架，支持 12+ 竞品配置一键迁移 |
| 兼容 | OpenClaw | 完全支持 | 开源 Agent 网关，支持 3000+ Skill 和 23+ 消息平台接入 |
npx 安装：如果不想克隆仓库，可直接使用
npx math-modeling-skill 快速安装（需 Node.js ≥ 18）。
也可从 GitHub Releases 下载 ZIP 包解压使用。
QUICK START
快速上手
从建模手开始
进入项目目录后，直接输入"我是建模手"开始角色切换。系统会自动加载建模手上下文和工具链。
运行示例题目
使用 "run_example" 工具加载内置示例题目，快速体验完整建模流程。
生成论文
建模完成后，使用 "write_paper" 工具一键生成竞赛规范论文文档。