matlab-code-reviewer 是一个面向 MATLAB 与北太天元建模代码的审查技能,主要用于对已批准的建模代码进行审查、运行、调试和验证。
用途 该技能针对 MATLAB 或北太天元(Beita Tianyuan)建模代码,依据其代码计划、数据契约、方法决策、兼容性约束等既定材料,对代码进行系统化检查与验证,帮助确认代码是否符合预期方案。
主要能力
- 解析已批准的主/基线范围以及已激活的回退方案。
- 在兼容运行时可用时,检查并运行代码。
- 评估语法、输入契约、方法一致性、可复现性和输出契约。
- 针对工具箱使用、jsonencode、文件 I/O、绘图/导出以及北太天元约束提供兼容性证据。
- 按需添加相关的数值、可行性、泄漏或规模检查。
- 在运行时不可用时,使用 NOT_RUN 标记,而非声称执行成功。
- 若被要求修复发现的问题,进行最小化修补并重新运行受影响的检查。
- 将审查结果保存为 code/matlab/Qx/reviews/qx_matlab_review.json。
使用方式 使用前需满足以下前提:MATLAB 代码和 code/matlab/Qx/qx_code_plan.md 存在;已批准的决策、方法卡、数据画像和运行摘要可用;MATLAB 或北太天元运行时的可用性已知。工作流程为:先确定已批准的主/基线范围及已激活的回退方案;在兼容运行时可用时检查并运行代码;随后按语法、输入契约、方法一致性、可复现性、输出契约等维度进行评估,并补充兼容性证据与相关检查;最后保存审查 JSON 文件。审查模式与 python-code-reviewer 相同,但 language 字段为 "matlab",并包含 runtime、compatibility_target 以及可选的兼容性检查。
适用场景 适用于需要对 MATLAB 或北太天元建模代码进行结构化审查与验证的场合,尤其是已有明确代码计划、数据契约和方法决策的建模项目。
限制
- 不得填充通过项。
- 不得伪造 MATLAB/北太天元执行结果。
- 未经明确的目标例外,不得批准不可用的工具箱依赖。
- 不得静默更改数学模型。
- 不得要求重复的 Markdown 审查。
- 运行时依赖的检查在无法执行时使用 NOT_RUN,并会阻塞 G3 直至执行完成。
- 必需命名检查使用 PASS、FAIL 或经说明的 NOT_APPLICABLE。
验证要点 确认已批准的主/基线范围得到执行;检查兼容性约束;确认运行摘要与输出一致;判定结论遵循必需的检查状态和运行时证据。