SuperAPI AI 工具集

pencil-mcp-batch-design

设计与创作

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能用于调用 Pencil MCP 工具 batch_design,在画布上批量执行设计变更,是智能体执行设计计划的“手”,核心能力为插入、更新、替换、删除和移动节点。若客户端对 MCP 工具做命名空间处理,工具可能显示为 mcp__pencil__batch_design。

使用前提:仅当用户明确提到“Pencil”,或当前对话上下文明确属于 Pencil 设计任务时才使用;否则不应调用。触发场景包括用 Pencil 绘制、插入、修改、删除元素,或执行设计计划,例如“用 Pencil 画一个矩形”“Pencil 更新文本内容”“使用 Pencil 插入组件”“Pencil 移动节点”“用 Pencil 删除选区”。

输入参数:batch_design 接受定义操作列表的 JSON 结构。operations(数组,必填)为操作对象列表,包含 Insert(I):{ "type": "insert", "targetId": "...", "node": { ... } };Update(U):{ "type": "update", "targetId": "...", "props": { ... } };Replace(R):{ "type": "replace", "targetId": "...", "node": { ... } };Delete(D):{ "type": "delete", "targetId": "..." };Move(M):{ "type": "move", "targetId": "...", "parentId": "..." }。

使用方式:先规划具体变更,再按 .pen schema 构造合法 JSON,然后调用 batch_design;若某操作失败,整批会回滚,需检查错误信息并修正后重试。

限制与注意:每次调用最多 25 个操作,更大任务需拆分;每个操作列表要创建新的绑定名称,不要复用。插入组件实例时使用 type: "ref" 与 ref: "ComponentID",并用 U() 配合实例路径覆盖属性。示例文件包括 1-insert-text.json、2-create-layout.json、3-component-instance.json。