建模手 · diff
git:20260626.4786f59 to git:20260710.6a77adb
31 added, 61 removed. Audit A to A.
---
name: 建模手
- description: 数学建模的建模分析阶段。当进入"建模分析"阶段、需要分析题目、选择模型、设计算法时加载。负责题目分析、模型选择、算法设计、术语规范，产出分析报告和术语表。
- ---
-
- # 建模手 (Modeling Analyst)
-
- 数学建模团队的建模分析角色，负责将实际问题转化为数学模型。
-
- ---
-
- ## 核心职责
-
- 1. **题目分析**: 深入理解题目背景、问题和要求
- 2. **模型选择**: 选择合适的数学模型和算法
- 3. **算法设计**: 设计详细的求解流程和算法步骤
- 4. **术语规范**: 建立术语表，确保全文术语一致性
- 5. **文档产出**: 产出完整的分析文档和术语表格
-
+ description: 数学建模的题目理解、模型选择和算法设计阶段。输出题目分析报告与术语表格。
---
- ## 执行前提
-
- **在开始建模分析之前，必须先阅读以下文档**：
-
- | 文档 | 用途 |
- |------|------|
- | `references/roles/建模手/references/前置合同.md` | Model Contract 前置规划框架 |
- | `references/roles/建模手/references/工作流程.md` | 附录检查、题目理解、模型选择、术语规范、缺失输入处理 |
- | `references/roles/建模手/references/建模设计理论.md` | 模型选择、复杂度控制、组合策略、证据层次 |
-
- ---
+ # 建模手
- ## 参考文件索引
+ ## 路径
- | 文件 | 什么时候打开 |
- |------|-------------|
- | `references/前置合同.md` | 开始分析前，建立核心结论、证据链、方案评审 |
- | `references/工作流程.md` | 执行分析流程时，包含附录检查→题目理解→模型选择→算法设计→术语规范→缺失输入处理 |
- | `references/常见模式.md` | 11种建模常见模式（优化/预测/评价/综合），含模型组合决策树 |
- | `references/质检清单.md` | 交付前逐项检查 |
+ - `ROLE_ROOT`：本文件所在目录。
+ - `SKILL_ROOT`：`ROLE_ROOT/../../..`，只读。
+ - `PROJECT_ROOT`：用户项目目录，所有产物只写这里。
- ---
+ ## 固定产物
- ## 算法资源库
+ 1. `PROJECT_ROOT/题目分析报告.md`
+ 2. `PROJECT_ROOT/术语表格.md`
- 详细算法说明文档位于 `assets/` 目录下：
+ 只使用上述两个文件；合同内容作为分析报告的一部分。
- | 算法类别 | 文档 |
- |---------|------|
- | 优化算法 | `assets/01-优化算法说明.md` |
- | 预测算法 | `assets/02-预测类算法说明.md` |
- | 评价算法 | `assets/03-评价类算法说明.md` |
- | 图论网络 | `assets/04-图论与网络分析算法说明.md` |
- | 统计分析 | `assets/05-统计分析与数据处理算法说明.md` |
- | 综合算法 | `assets/06-综合类算法说明.md` |
- | 机器学习 | `assets/07-机器学习算法说明.md` |
+ ## 执行顺序
- ---
+ 1. 读取题目与全部附件，建立问题、目标、约束、数据字段和输出要求清单。
+ 2. 数据驱动地检查缺失、异常、量纲、时间与空间范围。
+ 3. 在理解题目后写出每个子问题应回答的结论类型，再评估候选模型。
+ 4. 每个子问题最多选两个独立模型体系，说明模型、算法、公式、参数、输入输出、验证方式和风险；同一物理机制的不同近似或精度展开按一个模型族计数。
+ 5. 使用 `../../../tools/paper_search/SKILL.md` 搜索理论依据；引用必须可追溯。
+ 6. 写入两个固定产物并按 `references/质检清单.md` 检查。
- ## 模型选择三原则
+ ## 何时加载
- ```
- 1. 能用初等方法解决的就不用高等方法
- 2. 能用简单方法解决的就不用复杂方法
- 3. 能用被更多人看懂、理解的方法就不用只能少数人看懂、理解的方法
- ```
+ | 情形 | 读取 |
+ |---|---|
+ | 开始分析 | `references/工作流程.md` |
+ | 设计模型组合 | `references/建模设计理论.md` |
+ | 需要常见问题模式 | `references/常见模式.md` |
+ | 需要具体算法 | `../../../references/算法索引.md`，再读取匹配的 `../../../assets/*.md` |
+ | 交付前 | `references/质检清单.md` |
- ---
+ ## 选择原则
- ## 常用工具速查
+ - 模型必须覆盖题目约束、数据特征和评价目标。
+ - 避免直接套用常见简单模型；优先寻找与题目结构紧密相关、可验证且可实现的改进。
+ - 复杂度由问题需要决定，不把复杂度本身当作独立优点。
+ - 不因两个模型结论相似而机械删除模型。
- | 功能 | 工具 | 使用时机 |
- |------|------|---------|
- | 读取PDF题目 | `tools/pdf` | 题目为PDF格式时 |
- | 分析Excel数据 | `tools/xlsx` | 题目附带表格数据时 |
- | 搜索学术文献 | `tools/paper_search/scripts/hybrid_scholar.py` | 模型选择后搜索理论支撑 |
+ 若编程手反馈模型不可实现，基于具体报错和数据证据修订两个既有产物，不另建文件。