SuperAPI AI 工具集

paper-ds-pages

设计与创作

查看项目

更新于 10-16 10:25

技能介绍

用途

paper-ds-pages 用于把 Paper 文件整理成设计系统所需的、可预测的页面结构,也可以审计一个已有文件,找出更合理的组织方式。该技能的说明指出:页面既是人查找文件中任何内容的入口,也是智能体找到正确绘制位置的方式。

使用前需先加载 paper-ds-canvas。

页面顺序与内容

技能定义了一套页面结构,每一页存放指定内容并配有对应图标:

  • TEMPLATE:存放供方案克隆的 Sheet 框架,图标为 blueprint。
  • 分隔线。
  • Foundations:颜色、字体、间距、标识、字体,图标为 swatches。
  • Components:组件页面的紧凑索引,图标为 table。
  • 每个组件一页:该组件的规范基线、变体、状态与用法,图标为 table。
  • Blocks:区块与复合组件,图标为 presentation。
  • 分隔线。
  • 每个探索一页:方案表,以其探索的内容命名,图标为 design。
  • 分隔线。
  • Archive:落选方案与旧轮次,图标为 paper。

命名规则

正式页面使用精确的组件名(Button、Alert)。探索使用单独的名称,例如 Alert exploration;评审使用 Alert review,这样基线不会被草稿淹没。不要使用 Page 1 或 Options v2。箭头图标标记团队当前正在处理的那一页,同一时间只有一页。

重命名或归档之前,需阅读 references/naming.md 和 ../paper-ds-manage/references/versioning.md。

具体命名约定:

  • 正式画板:组件名称。探索:Notice r2 Round 1 或 Review Notice r2。保持主题名称稳定,附加简短的修订后缀,并在 manifest 中记录谱系,而不是放在大型画布面板里。Foundations 使用 NN Title。
  • 方案框架:Option 01 <name>。阶段框架:Stage light (Render) 与 Stage dark (Render)。
  • 槽位:Optional <name>。注释:面向智能体的指令注释。
  • 永远不要在智能体必须找到的图层上留下 Frame 或 Rectangle。

使用方式(Apply)

  1. 调用 get_basic_info,列出页面与分隔线。
  2. 用 create_page 创建缺失的页面,并立即用刚刚重新读取的完整顺序把每一页放入正确的分组。创建操作会插入到活动页面旁边,而不是预期的分组。保留无关页面与用户的分组方式。用 update_pages 设置名称与图标。
  3. 用 arrange_pages 放置分隔线并排序。
  4. 只归档用户同意淘汰的轮次。先捕获它们的产品与 token 快照,用 move_nodes 移动,并更新其修订状态,同时不移除审批或实现证据。永远不要删除历史,也不要根据页面位置推断审批状态。
  5. 更新 paper-ds.json 中的页面 ID、探索映射以及任何正式节点引用。移动作品会保留其主题修订号。

审计方式(Audit)

当用户询问“有没有更好的组织方式”时运行此流程。

  1. 读取每个页面:画板数量、名称、若已知则记录最后修改顺序。
  2. 把发现归类为:没有明确主题的页面、命名为 Frame 或 Untitled 的画板、同时存放 Foundations 和探索的页面、同一探索的多个轮次分散在多个页面、远离其余部分的孤立画板。
  3. 提出重组方案,以迁移列表形式给出:从哪、到哪、为什么。移动任何内容之前先询问。
  4. 只应用用户批准的部分,然后对页面列表截图。

限制与注意事项

说明中强调:用户手动重新排列过的页面是有意为之。要在其有效处复制用户的做法,永远不要撤销它。此外,不要删除历史,不要根据页面位置推断审批状态,也不要在智能体必须查找的图层上保留默认的 Frame 或 Rectangle 名称。官方文本未提供收费、价格、平台支持范围等信息。