SuperAPI AI 工具集

matlab-project

通用与其它

查看项目

更新于 10-16 09:32

技能介绍

用途:该技能面向所有涉及 MATLAB Project(.prj 文件)的工作,包括新建项目、跟踪文件、管理项目路径、配置 Simulink 相关目录,并为需求、架构、分析等下游工作流提供可预测的项目结构。

主要能力:提供 setupProject 与 registerWithProject 等辅助函数及约定,包括幂等构建脚本、删除前先 removeFile、在 buildAll 末尾运行 runChecks。领域技能可复用这些辅助函数,并可用领域专用模板覆盖活文档模板。

创建项目:使用 code/setupProject.m 内联创建(此时 scripts/ 文件夹尚不存在),签名为 setupProject(projectName, projectFolder, subfolders, derivedSubfolders)。subfolders 为被创建、注册为跟踪文件并加入 MATLAB 路径的文件夹;derivedSubfolders 为构建输出目录,创建但不跟踪,前两项在提供时分别接入 SimulinkCacheFolder 与 SimulinkCodeGenFolder。

路径管理:每个应加入路径的跟踪文件夹必须同时用 addFolderIncludingChildFiles 和 addPath 注册,否则 runChecks 会报 Project:Checks:ProjectPath。

文件生命周期:构建脚本末尾调用 registerWithProject 跟踪新建文件;用 addShortcut(proj, filePath) 添加快捷方式;删除跟踪文件时先 removeFile 再 delete,避免项目中出现失效引用。

构建脚本约定:顶部清理状态、重建前删除目标产物、从头重建、末尾注册产物,使 buildAll() 可任意顺序重跑。buildAll.m 依次调用各阶段脚本、注册脚本文件并运行 runChecks(含 8 项内置检查)。

活文档:项目根目录维护 plan.md 与 decisions.md,模板位于 templates/,需复制、填写占位符并用 addFile 注册。

限制:资料未提供安装命令、收费、平台或效果信息;不提供 startup.m,因其会引入隐藏状态。