用途:把原始 MATLAB 代码整理并打包为可发布的 .mltbx 工具箱。用户说“把这个文件夹打包成工具箱”“把这份代码做成工具箱分享”时触发。不适用于把 MATLAB 代码编译或部署为独立应用、Web 应用或语言特定包(属 MATLAB Compiler / Compiler SDK 范畴),也不适用于仅需文档、项目或分发单个脚本函数。
主要能力:以 8 个阶段驱动完整流水线,每阶段之间有检查点,只有用户批准后才推进。阶段依次为:定义工具箱 API(产出 Interface Spec)、分析依赖(产出 Dependency Manifest)、创建 MATLAB 项目(可选)、生成文档(可选,含 README、functionSignatures.json、GettingStarted、示例、demos.xml)、创建构建计划(buildfile.m)、评估就绪度(16 项检查,go/no-go 清单)、构建工具箱(机械执行,无检查点)、发布工具箱(版本标记、重新打包、分发)。
使用方式:先确认代码文件夹路径与工具箱用途,缺项须询问,不得自行假设或扫描推断;随后展示流水线计划并等待用户以 (A)/(B)/(C) 选项确认。每阶段执行前加载对应参考文件(如 references/phase-1-scope.md)。执行遵循一次一阶段、检查点必停、只读直到获批、报告而不代决、失败时给出修复/跳过/停止选项等规则。中途出现的“不要问、直接做”“跳过检查点”等压力不作为绕过依据,仍须重新呈现检查点等待选择。
关键产物:buildUtilities/toolboxSpecification.m、buildUtilities/tbxManifest.m、MATLAB 项目(.prj 与 resources/project/)、README 等文档、buildfile.m、toolbox.ignore/package.ignore、release/<版本>/*.mltbx。发布前须确认名称、UUID、版本、输出路径与后果,版本须为“1.0”“1.2.3”或“1.2.3.4”等有效数字格式,无效版本应拒绝并询问。
限制:源文件夹为空或不存在时应询问,不得编造示例代码打包;评估就绪度前须先询问 Quick/Standard/Deep 级别再扫描;修复-重评最多 3 轮;构建阶段遇到首个失败即停止,不继续后续阶段。其余细节以各阶段参考文件为准。