SuperAPI AI 工具集

stitch-ui-contract-uviewpro

设计与创作

查看项目

更新于 10-16 16:58

技能介绍

uView Pro Design Spec(uView Pro / Vue 3)是面向 Stitch 的设计规范技能,用于生成设计前的约束输入。

用途: 本技能维护目标框架的组件、token 和状态契约,用于生成设计前的约束输入,不生成业务页面代码。产品规格和最终提示词模式由 stitch-design-spec 统一维护。约束条件:仅当用户明确提及“Stitch”时才使用本技能。

主要能力(两种模式):

  1. 前缀模式(Prefix mode):输出一个可直接粘贴的“硬约束前缀”,用于 Stitch 的 [Context]。
  2. 选择器模式(Selector mode):先输出 CONTRACT_SELECTION_JSON_V1,再输出组装好的 Stitch 提示词,仅注入所需的组件与状态片段。 模式判定:若用户要求美化/润色/优化现有界面,或要求 selector / JSON / contracts.include / states.include,则使用选择器模式;否则使用前缀模式。

前缀模式输出内容(硬约束前缀):

  • 框架:uView Pro(uni-app / Vue 3)。
  • 设计令牌:
    • 颜色:Primary=#3c9cff,Success=#5ac725,Warning=#f9ae3d,Danger=#f56c6c,Info=#909399。
    • 字体:单位 rpx。主标题 32rpx,正文 28rpx。
    • 圆角:基础 8rpx,卡片 16rpx,圆形 9999px。
  • 组件契约(前缀 u-;uView Pro 使用与 uView 2 相同的标签前缀,包名为 uview-pro):
    • 按钮:<u-button type="primary" shape="circle">。
    • 布局:<u-row>、<u-col span="...">、<u-gap>。
    • 表单:<u-form :model="form">、<u-form-item>、<u-input border="none">、<u-code>。
    • 导航栏:<u-navbar title="..." :autoBack="true">。
    • 列表:<u-swipe-action>、<u-index-list>、<u-waterfall>、<u-list>、<u-grid>。
    • 图标:<u-icon name="photo">。
  • JS 工具:
    • 使用 uni.$u.toast()、uni.$u.route()、uni.$u.http.post()。
    • 使用 <script setup lang="ts">。

选择器模式输出内容(严格两个代码块,按顺序,无额外文字):

  1. 契约选择 JSON:包含 version(CONTRACT_SELECTION_JSON_V1)、designSystem(uview-pro)、mode(selector)、contracts.include、states.include 字段。
  2. 最终 Stitch 提示词:包含 [Context](粘贴硬约束前缀,若为美化则加入 contract.md 的 Layout Invariants)、[Layout](描述宏观布局结构)、[Components](注入与 JSON 选择匹配的组件片段)。

触发关键词:uview-pro、uviewpro、uview pro;中文触发关键词(仅用于触发):uview pro、uview 3.0。

真实来源(Source of Truth):references/contract.md、references/examples.md、references/official.md。

使用方式与相关说明:

  • 按名称使用 stitch-design-spec;安装说明:npx skills add full-stack-skills/stitch-skills --skill stitch-design-spec,不自动安装。
  • 真实代码转换使用对应 components 技能,不能以框架风格设计图代替代码验证。
  • 渐进式披露:需要确定输入/输出、状态和授权点时,读取 references/workflow-contract.md;需要交付前自检时,读取 references/validation-checklist.md;遇到超时、部分成功或恢复场景时,读取 references/error-recovery.md;首次运行、拒绝越权和失败恢复分别参考 examples/happy-path.md、examples/boundary-refusal.md、examples/failure-recovery.md。

工作流(概要):

  1. 澄清意图:确认技能是否匹配目标,若只是相邻需求则交给更精确的技能。
  2. 执行预检:确认目标、输入、约束、可用工具、成功标准和失败边界;关键条件未知时停止在只读阶段。
  3. 形成计划:列出将调用的工具、会改变的对象、成功标准及失败后的安全退出方式。
  4. 执行动作:按最小充分步骤执行,在关键状态变化处记录证据。
  5. 验证交付:输出结果、验证证据、未完成项、风险和明确的下一步,区分事实、推断和未验证项。

规则(概要):先读后写;权限最小化;证据优先(缺失时标记 NOT_VERIFIED);幂等优先;隐私安全(日志、示例、回执和错误信息不得包含 token、cookie、密钥或个人敏感数据)。

适用场景:当用户需要为当前请求选择并执行可验证、可恢复的专业工作流时加载本技能;仅在用户明确提及 Stitch 且涉及 uView Pro 设计规范时适用。

限制与边界:不超出用户给定范围;写入、付费、发布和不可逆动作需要明确授权。若请求需要别的技能,不复制其正文,按技能名称进行交接并保留当前任务上下文。产品规格和最终提示词模式由 stitch-design-spec 统一维护,本技能不生成业务页面代码,也不直接覆盖已应用系统或局部修改范围。