Magnet

任务与阶段

• 先确认产物、目标 Figma 文件、修改范围、目标设备与需要覆盖的状态。只读评审不修改设计；仅线框任务在线框交付后结束。
• 新建页面或实质布局变更默认分为三个阶段：
  1. 布局方案：用低保真预览表达页面结构、内容层级、尺寸基准和关键状态。
  2. 组件方案：依据已选设计系统验证组件、变量和样式能力，并标明复用、组合与缺口。
  3. 正式绘制与验收：写入 Figma，检查实际实例、绑定、尺寸、溢出和截图。
• 每个阶段的确认只覆盖当时展示的范围。用户明确要求直接生成或明确豁免某个阶段时可按其授权执行，但不得把工具成功、沉默或内部判断当作用户确认。
• 普通单页任务由当前 Agent 完成即可。大型组件库、多页面或用户明确要求并行时，才按 组件目录协议、草图协作 或 并行绘制 分配写入所有权。

设计系统来源

• 来源必须来自用户在本次任务中提供、用户明确指定，或目标文件 libraries_added_to_file 中经上下文确认的设计系统。Skill 不内置产品名称、文件链接、fileKey、pageId、组件 key、变量 key 或视觉资产。
• 多个库都可能适用时，先按用户描述和目标文件上下文缩小范围；仍会实质改变结果时再请用户选择。不得凭名称、历史缓存、最近文件或搜索结果猜测来源。
• 将本次选择保存为任务级 library-context.json：schema: magnet.target-library.v1、target_file_key、library_name、library_key、discovery: libraries_added_to_file 和 resolved_at。来源变化或证据失效时重新发现。
• 读取设计系统使用 Figma MCP，不索取 Token、不调用非授权 REST 接口。源文件 URL 只保存在当前任务证据中，不回写到 Skill。

复用与组合

• 使用前读取候选组件、变量和 Styles 的名称、description、属性、Variant、来源和限制；不能只按外观或关键词选择。
• 优先复用适用的远程组合组件。保持 Library 关联，允许使用公开属性、Variant、文案覆盖和既有 Slot；禁止 detach、修改远程主组件或改变实例内部结构。
• 缺少完整业务组件时，可用普通 Auto Layout Frame 组合获准基础组件、变量和 Styles。说明组合范围，不创建伪装成设计系统资产的本地主组件。
• 只使用本次获准来源及用户明确提供的素材。目标文件本地资源、其他库、图片源或 Effect Style 只有在用户或任务合同明确授权时才能使用。

布局与视觉规则

• 页面层级、导航方式、Header、Sidebar、内容宽度、断点和 Frame 尺寸均从用户需求、目标稿或设计系统中推导，不预设固定壳层或固定桌面宽度。详见 布局与结构。
• 颜色、排版、间距、圆角和阴影遵循所选设计系统的实际变量、Styles 与组件定义；Skill 不强制具体 Token 名称、数值网格或阴影层级。按需读取 颜色、排版、间距与圆角 和 阴影。
• 含图片或视频时读取 图片资产 与 媒体展示。状态和交互按 交互状态 处理。

验收

1. 核对交付范围和状态是否完整，实际节点是否与已确认方案一致。
2. 核对复用实例仍保持远程关联，组合内容的变量、Text/Paint/Effect Styles 可追溯到本次获准来源。
3. 查看最终节点截图，检查层级、对齐、裁切、溢出、响应式行为和必要交互状态。详见 截图验收。
4. 批量页面、迁移或用户要求可追溯审计时，按需使用 严格设计证据 与 结构化组件审计；普通单页不强制完整审计合同。
5. 返回可定位的 Figma 链接、已验证结果和未完成项。脚本通过不等于设计完成，旧截图也不能证明新修改。

过程数据

• 任务文件放在 .tmp/<YYYY-MM-DD>-<taskName>/；跨任务缓存可放在 .tmp/_magnet-cache/<libraryKey>/。缓存只按实际 libraryKey 隔离，不包含内置产品身份。
• 不把任务中的设计链接、资产清单、变量 key、样式参数或业务数据写回 Skill。没有来源或输入变化时，不重复相同失败调用。