用途
该技能面向数学建模工作流中的代码生成环节，目标是为已经由人工确认的主方法（main method）以及可用的基线（baseline）生成并运行最小可复现的 MATLAB 或北太天元（Beita Tianyuan）兼容代码。它不负责选择数学方法，而是在方法决策已记录之后，把方案转化为可执行、可复现、可审查的脚本。
前置条件
- G2.5 人工方法选择已记录。
- 存在 code/matlab/Qx/qx_code_plan.md。
- 所需的清洗后数据与数据画像（profile）已存在。
- 计划目标为 MATLAB 或北太天元。
- 迁移期间可以读取遗留产物，但遗留产物不得覆盖人工决策。
主要能力
- 读取代码计划、决策台账、方法卡、探测条件与数据画像。
- 确认范围：已批准的主方法加可用基线；仅在激活后才实现回退（fallback）。
- 在 code/matlab/Qx/ 下生成保守的 .m 文件。
- 优先使用基础矩阵/表格操作，除非计划批准，否则避免可选工具箱。
- 将表格、指标、有用图表与 run_summary.json 保存到 results/Qx/experiments/roundN/。
- 评估计划要求的输出退化（output-degeneracy）与回退触发指标。
- 仅在出现失败或可复现性警告时使用 diary 或其他完整日志。
- 在可用的兼容运行时中运行；若不可用，明确报告未执行状态。
- 交接给 code-reviewer。
使用方式
脚本布局如下：
code/matlab/Qx/
├── qx_code_plan.md
├── qx_baseline.m
├── qx_main.m
└── run_all.m % only when useful
不要为未批准的候选方法创建脚本，也不要创建重复的 README。
兼容性规则：
- 优先使用 readtable、readmatrix、writetable、writematrix、save、load 和 fullfile。
- 使用 rng(2026) 或已记录的种子。
- 在支持时使用 jsonencode；否则确定性地写出所需 JSON 字段。
- 除非明确批准，避免 Live Scripts、App Designer、GUI 代码、Simulink 以及仅限工具箱的函数。
- 在运行摘要中注明任何北太天元兼容性风险。
运行摘要需遵循 model-code-analyzer 契约，包括已批准的决策 ID、角色、路径、指标、输出退化证据、回退状态、计时、种子、环境、警告与错误。
适用场景
适用于数学建模流程中方法已由人工确认、需要生成可复现实验代码并保留证据链的环节，尤其是需要同时产出主方法与基线、并需要评估输出退化与回退触发的实验。
限制与规则
- 不得更改已选定的数学方法。
- 不得访问或覆盖原始数据。
- 当 MATLAB/北太天元 不可用时，不得伪造成功执行。
- 只保留承载证据的中间输出。
- 将 Type 1 诊断与论文图表分开。
验证要求：
- 主方法与基线可直接比较，且在运行时可用时两者都已执行。
- 回退代码仅在激活时存在。
- 正式输出与运行摘要存在。
- 兼容性、种子、输入、警告与错误均已记录。
- 所需的集中度/退化检查已保存。
- 下一步交接对象为 code-reviewer。