关于 ss-page
ss-page 是面向 StyleSeed 项目的页面搭建技能,用于创建新页面。它根据注册表或旧版配置读取设计方法,并要求生成后运行评分与验证流程。
主要功能
- 01解析注册表或旧版设计配置
- 02使用页面外壳及已有组件组合页面
- 03按配方选择布局与内容结构
- 04使用语义颜色令牌与安全区间距
- 05生成后运行评分和验证
适用场景
- 01为已有 StyleSeed 项目创建新页面
- 02依据指定设计配方搭建页面结构
- 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
说明
-
解析并读取当前启用的设计方法:
- 如果任一注册表文件存在,则必须要求注册表完整且有效,并使用
--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
- 如果任一注册表文件存在,则必须要求注册表完整且有效,并使用
-
页面结构模板:
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>
)
}
-
应用所选适配器和配方:
- 在
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。 - 按配方选择组件:工作台使用对齐的面板/行,公共服务使用扁平步骤,编辑内容使用阅读流,创意工具使用聚焦画布/工具组;只有配方要求时才采用柔和分组。
- 页面可以包含卡片、面板、分隔线、留白、行、表格或画布。绝不要强迫每个内容块都放进卡片。
- 在
-
所有颜色都使用语义化令牌 — 绝不要硬编码十六进制值。
-
尽可能使用现有组件(
ui/和patterns/)组合页面。 -
安全区域:为现代设备添加
env(safe-area-inset-*)内边距。 -
生成后验证(必须执行): 运行
/ss-score,然后运行/ss-verify。确认:- 首屏展示该语法对应的用户任务和一个焦点
- 容纳方式、几何形态、控件、集合、密度和导航符合配方
- 只有一个可识别的主要操作;其他颜色均有规范定义的用途
- 没有硬编码的十六进制值(全部使用语义化令牌)
- 区块类型交替出现(不得连续出现两个相同类型)
- 间距遵循一种可重复且符合配方的节奏
- 触控界面的触控目标 ≥ 44px;优先指针操作的桌面控件遵循已批准的适配器/组件规范,该规范可能允许 36–40px 遵循有界构建门禁循环。报告实际结果和剩余失败项,即使门禁未通过也不例外;绝不要替换已批准的决策,也不要声称已通过验收来结束循环。
评论
支持 Markdown