用途:在 Subframe 中完成整套设计操作,覆盖页面、组件、片段、设计文档与项目主题,并可与后续开发衔接。每个工具会返回一个用户可打开的 URL 查看结果。
主要能力:查询项目现状(list_components、list_pages、list_snippets、list_canvases、get_project_info);新建页面 design_page 或定向修改 edit_page;仅改样式 update_node_styles;新建或修改可复用组件 design_component / edit_component;片段 design_snippet / edit_snippet;编写设计文档 write_design_document;修改全局主题 edit_theme;删除 delete_page / delete_canvas / delete_component / delete_snippet;重命名 rename、移动 move、复制 duplicate;读取页面评论 list_comments;导出图片或 PDF export_image;图标与字体相关 search_icons、create_asset_upload、add_icons / add_fonts、list_icons / list_fonts、delete_icons / delete_fonts。
使用方式:先确认 Subframe MCP 工具可用,否则按 MCP 设置指南安装、启用或认证;在 Claude Code 或 Codex 中可用 /mcp 查看连接与认证状态。projectId 可从本地 .subframe/sync.json 获取,或调用 list_projects;存在多个项目时必须让用户选择。开始设计前建议先执行项目审计:list_components、get_theme、get_project_info。首次对某项目调用设计类工具前需比对代码库主题与 Subframe 主题的角色映射,不一致或主题为空时应先询问用户是否用 edit_theme 建立主题。设计调用可通过 references 传入 { source, usage },source 支持 Subframe 实体、代码内容或 Subframe 托管的图片 URL;尽量粘贴真实代码而非转述。design_page、design_component、edit_component 会返回 jobId,需用 wait_for_jobs 等待完成后再读取结果或进行下游设计;多次任务可批量等待,直到状态为 done 或 error。页面设计前需盘点所依赖组件,列出依赖关系并分波次执行。
适用场景:需要 Subframe 设计产物或重要视觉探索时优先在 Subframe 设计,再按需用 /subframe:develop 实现;仅需实现时直接改代码。
限制:只读账号(Viewer)仅能用读取类工具,设计与编辑需要 editor 席位;引用图片必须是 Subframe 托管的上传 URL,本地文件或任意链接会被拒绝,每次调用最多使用 5 张;edit_page 与 edit_snippet 为节点定向编辑,不接受 grounding;edit_component 无需重复回传当前 Subframe 代码,可先用 get_component_info 读取。技能文本未完整结束,部分细节暂未提供。