SuperAPI AI 工具集

python-model-code-generator

编程与开发

查看项目

更新于 10-16 02:33

技能介绍

用途:在数学建模流程中,依据已记录的人工方法选择,为唯一获批的主方法和一个可用基线生成可运行的 Python 代码并实际执行,产出可复现的实验产物。

前置条件:methods/Qx/qx_decisions.jsonl 中已记录 G2.5 人工方法选择;code/Qx/qx_code_plan.md 存在;所需清洗数据与数据画像存在;计划目标为 Python。迁移期间可读取旧方法池与 code/model-code-analyzer.md,但不得覆盖人工选择。

主要能力:读取代码计划、决策台账、方法卡、探测条件与数据画像;确认范围(一个获批主方法、一个可用基线,仅在存在激活决策或有证据触发时使用回退);在 code/Qx/ 下生成清晰可运行的 .py 文件,使用项目根目录安全路径、固定随机种子、显式输入与最小必要依赖;将表格保存到 results/Qx/experiments/roundN/tables/,指标保存到 .../metrics/,诊断与对比图保存到 .../figures/,并生成规范的 run_summary.json;评估并记录计划要求的输出退化与回退触发指标;仅在失败或需复现警告时保留完整日志;实际运行代码,不以仅生成代码宣称成功;最后交接给 code-reviewer。

脚本布局:优先最小清晰结构,如 code/Qx/ 下含 qx_code_plan.md、qx_baseline.py、qx_main.py,必要时加 run_all.py。不为未获批候选各建脚本,不创建重复代码计划的 README。

运行摘要:遵循 model-code-analyzer 的 schema,包含获批决策 ID、方法 ID 与角色、输入输出、种子与环境、执行状态与耗时、紧凑指标摘要、输出退化证据、警告/错误、回退触发状态。

规则与限制:不得更改获批模型或基线;不得读取或覆盖原始数据;不得在代码中隐藏假设;不得输出占位指标、图或成功状态;优先可移植 .py 脚本而非仅 notebook 流程;仅在解释、审查、稳健性或调试需要时保留中间文件;Type 1 诊断图仅供内部使用,不作为论文图。

验证:主方法与基线均已运行且可直接比较;未激活时不存在回退代码;正式输出与运行摘要存在;种子、输入、版本、警告与错误均已记录;所需的集中度/退化检查已保存;下一步交接给 code-reviewer。