mcpField
S
ss-page

ss-page

github.com/bitjaru设计与 UI993835 次安装1 天前更新
代码仓库

关于 ss-page

ss-page 是面向 StyleSeed 项目的页面搭建技能,用于创建新页面。它根据注册表或旧版配置读取设计方法,并要求生成后运行评分与验证流程。

主要功能

  1. 01解析注册表或旧版设计配置
  2. 02使用页面外壳及已有组件组合页面
  3. 03按配方选择布局与内容结构
  4. 04使用语义颜色令牌与安全区间距
  5. 05生成后运行评分和验证

适用场景

  1. 01为已有 StyleSeed 项目创建新页面
  2. 02依据指定设计配方搭建页面结构
  3. 03检查页面布局、触控目标与令牌使用

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bitjaru/styleseed --skill ss-page

安装后在 Claude Code 中输入/ss-page确认已加载。

详细介绍

在运行此工作流前,请先执行一次本会话的更新预检。

产品页面脚手架

以注册表为准的制品边界

当 .styleseed/project.json 和 .styleseed/artifacts/index.json 存在时,先解析请求的制品 ID,然后只读取 .styleseed/bundles/<artifact-id>.md 和 .styleseed/manifests/<artifact-id>.json。对于注册表项目,绝不要回退到全局旧版 bundle。只有在不存在注册表时,旧版项目才可以使用 .styleseed/effective-rules.md。

不要用于以下情况

  • 在现有页面中组合单个模式 → 使用 /ss-pattern
  • 构建多页面导航结构 → 先使用 /ss-flow
  • 调整现有页面 — 直接编辑文件

创建新页面:$0 说明:$ARGUMENTS

说明

  1. 解析并读取当前启用的设计方法:

    • 如果任一注册表文件存在,则必须要求注册表完整且有效,并使用 --artifact <id> 解析所选制品。读取 .styleseed/bundles/<id>.md 和 .styleseed/manifests/<id>.json;出错时绝不要重新开始设置或使用旧版回退方案。
    • 仅当两个注册表文件都不存在时,才解析 STYLESEED.md 并读取 .styleseed/effective-rules.md 和 .styleseed/manifest.json。
    • 在此授权构建中,如果输出缺失或已过期,则从相应的项目自有配置中解析,并在不更改已批准决策的前提下重新检查。
    • 页面布局使用 components/patterns/page-shell.tsx
    • 页眉模式使用 components/patterns/top-bar.tsx
    • 导航使用 components/patterns/bottom-nav.tsx
  2. 页面结构模板:

import { PageShell, PageContent } from "@/components/patterns/page-shell"
import { TopBar, TopBarAction } from "@/components/patterns/top-bar"
import { BottomNav } from "@/components/patterns/bottom-nav"

export default function PageName() {
  return (
    <PageShell recipe="enterprise-workbench">
      <TopBar
        logo={/* logo or page title */}
        subtitle={/* optional subtitle */}
        actions={/* optional action buttons */}
      />
      <PageContent>
        {/* Compose the grammar's focal point and recipe-fit sections */}
      </PageContent>
      <BottomNav items={[/* nav items */]} activeIndex={0} />
    </PageShell>
  )
}
  1. 应用所选适配器和配方:

    • 在 PageShell 上设置 recipe="<manifest selection.recipe>",或在自定义制品根节点上设置 data-styleseed-recipe="<id>"。
    • 使用锁定配置中的视口和适配器的响应式规范。不要假定移动端宽度为 430px。
    • 在符合已打包模式的情况下,使用 ss-page-padding、ss-page-gutter、ss-pattern-stack、ss-pattern-surface、 ss-pattern-inset、ss-pattern-control 和 ss-pattern-icon。
    • 按配方选择组件:工作台使用对齐的面板/行,公共服务使用扁平步骤,编辑内容使用阅读流,创意工具使用聚焦画布/工具组;只有配方要求时才采用柔和分组。
    • 页面可以包含卡片、面板、分隔线、留白、行、表格或画布。绝不要强迫每个内容块都放进卡片。
  2. 所有颜色都使用语义化令牌 — 绝不要硬编码十六进制值。

  3. 尽可能使用现有组件(ui/ 和 patterns/)组合页面。

  4. 安全区域:为现代设备添加 env(safe-area-inset-*) 内边距。

  5. 生成后验证(必须执行): 运行 /ss-score,然后运行 /ss-verify。确认:

    • 首屏展示该语法对应的用户任务和一个焦点
    • 容纳方式、几何形态、控件、集合、密度和导航符合配方
    • 只有一个可识别的主要操作;其他颜色均有规范定义的用途
    • 没有硬编码的十六进制值(全部使用语义化令牌)
    • 区块类型交替出现(不得连续出现两个相同类型)
    • 间距遵循一种可重复且符合配方的节奏
    • 触控界面的触控目标 ≥ 44px;优先指针操作的桌面控件遵循已批准的适配器/组件规范,该规范可能允许 36–40px 遵循有界构建门禁循环。报告实际结果和剩余失败项,即使门禁未通过也不例外;绝不要替换已批准的决策,也不要声称已通过验收来结束循环。

评论

支持 Markdown