用途:为智能体提供一套可重复的 MathWorks 文档查阅方法,把文档查找变成可预测、高效的操作,用于回答 MathWorks 产品与工作流的“如何做”问题、验证函数语法与参数、确认弃用状态、查找某产品可用函数,以及核对官方推荐做法。
主要能力:提供四遍策略(本地函数目录 → help → 用户指南页 → 参考页),通过 MCP 的 webread 抓取页面,并用辅助脚本处理 URL 发现、HTML 解析与内容提取。脚本包括 get_local_function_list、fetch_product_index、extract_page_slugs、fetch_doc_page、find_replacement,以及内部使用的 DocUtilities。
使用方式:脚本是函数文件,需通过 evaluate_matlab_code 调用,并把 project_path 设为该技能的 scripts 目录,不能用 run_matlab_file。例如 evaluate_matlab_code 执行 [t, hrefs] = fetch_product_index('simulink', 'Modeling')。若已有函数名,先用 help functionName;若不知函数名,用 get_local_function_list('product','keyword') 发现;需要工作流上下文时抓取含 programmatically 的 ug/ 页;help 不足时抓取 ref/ 页。发布说明可直接抓取 https://www.mathworks.com/help/{product}/release-notes.md。
适用场景:不确定训练数据是否过时、需要发布版本特定 API、需要权威语法或弃用信息、需要判断某工作流该调用哪些函数时。
限制:本地 help 足够时应优先使用,不必抓网页;URL 不应猜测,需从索引页发现,404 时回退到上一级;所有文档 URL 带版本号,默认匹配已安装版本;若网页描述的功能在 help 中不存在,可能用户版本较旧,应指出差异而非假定 API 存在。部分产品目录结构不同(如 Simulink 用 slref/、gui/),需通过索引发现实际 slug。GUI 文档页可能很长但不含编程内容,可用 slug 中的 programmatically 等信号判断。