kami-landing
生成一份单页文档,采用 kami(纸张) 设计系统。其美学借鉴了编辑印刷品、技术白皮书和古老打字机信函——目标是纸张上的优质内容,而非现代应用 UI。
设计系统权威来源:
design-systems/kami/DESIGN.md。 发布前务必阅读。其中定义了令牌、排版规则、“十条不变量”以及禁止使用的颜色。
你将获得
一个自包含的 HTML 文件,包含:
- 温暖羊皮纸画布(
#f5f4ed)—— 绝对不使用#ffffff。 - 单一强调色 —— 墨蓝色(
#1B365D),用于章节编号、标题强调词、宣言左侧竖线和指标数值。在其他地方,墨蓝色的覆盖面积不得超过文档表面积的 5%。 - 用于层级编排的衬线体(单一粗细 500) —— 英文使用 Charter,中文使用 TsangerJinKai02 / Source Han Serif,日文使用 YuMincho,由
language参数决定。任何地方都不使用斜体。 - 紧凑的印刷节奏 —— 行高范围为 1.10–1.55,字间距依语言而定(英文为 0,中文为 0.35px,日文为 0.02em)。
- 数字堆叠使用
font-variant-numeric: tabular-nums—— 确保指标列和页码数字整齐对齐。 - 使用 1px 描边和微阴影来营造层次感(
0 4px 24px rgba(0,0,0,0.05))。不使用硬投影、新拟物风格或backdrop-filter模糊效果。 - 标签填充使用纯色十六进制值(例如
#E4ECF5),绝不使用rgba()—— 打印渲染器会双重绘制带有 alpha 通道的标签。 - 响应式设计 —— 适配 1280 / 980 / 768 / 560 像素宽度。
页面结构
1. 眉行 —— 语言切换器 · 版本 · 版本号(12px 无衬线体大写)
2. 首屏 —— 展示标题(96–106px 衬线体 500)、副标题(21px)、
三个首屏信息块(羊皮纸色调)
3. 宣言 —— 拉取段落(衬线体 400、20px、1.65 行高),
带有墨蓝色左侧竖线和签名脚注
4. 指标行 —— 3-6 个单元格:数值(24px 衬线体 500 墨蓝色,tabular-nums)、
标签(12px 衬线体 500 橄榄色)
5. 章节 —— 编号(`01`、`02`、……)墨蓝色衬线体 500 14px,
章节标题 28-32px,正文 14-15px
6. 页脚 —— 醒目词(超大衬线体 500)、许可证 · 年份 · 联系方式,
三栏站点索引(12px 衬线体 500)
工作流程约定
1. 收集品牌简介
使用 AskQuestion(或等效方法)分块收集品牌简介。不要一次性向用户展示整个输入列表;分两轮询问:
- 标识轮 —— 名称、标语、地点、版本 / 修订号、主 URL、主导语言。
- 内容轮 —— 宣言段落 + 签名、3-6 个指标卡片、3-5 个章节条目(标题 + 导语 + 正文)。
2. 选择语言堆栈
language 参数控制 :root 上设置的 --serif 堆栈。根据宣言和章节正文的主导语言来选择:
language | --serif | 备注 |
|---|---|---|
en | Charter, Georgia, Palatino, Times New Roman, serif | 默认 |
zh-CN | TsangerJinKai02, Source Han Serif SC, Songti SC, Georgia | 正文字间距 0.35px |
ja | YuMincho, Hiragino Mincho ProN, Source Han Serif JP | 同时将 --olive 覆盖为 #4d4c48(YuMincho 笔画更细) |
内联混合脚本内容没问题 —— 浏览器会根据字形的后备链自行处理。不要将三种字体家族全部串联到一个 font-family 声明中;那样会削弱字符特性。
3. 编写 index.html
输出一个包含所有内联 CSS 的单一文件。参考 example.html 的结构,并且只使用 design-systems/kami/DESIGN.md 中的令牌。不要发明新的颜色、粗细或字体家族。
智能体可以直接使用的基础组件(全部定义在示例的 <style> 块中):
.eyebrow、.label—— 无衬线体上划线.metric—— 数值 + 标签的垂直组合.section-num+.section-title+.section-lede.tag.standard、.tag.brush—— 纯十六进制颜色标签(每页最多一个 brush 标签).quote—— 带有左侧竖线的衬线体 500 引用ul.dash—— 墨蓝色短破折号项目符号.code—— 象牙白背景、1px 边框的代码块.footer-kicker—— 超大衬线体 500 醒目词
为每个可编辑元素添加 data-od-id="<唯一标识符>" 属性,以便宿主应用的评论模式能够定位到它。
4. 交付前自检
- 页面背景为羊皮纸色(
#f5f4ed),绝不是#ffffff。 - 墨蓝色(
#1B365D)覆盖面积 ≤ 可见表面的 5% —— 统计章节编号、宣言竖线、指标数值、标题强调词。总计 ≤ 5%。 - 所有灰色均为暖色(R ≈ G > B)。没有
slate-*,没有#f3f4f6。 - 衬线体粗细保持在 500 —— 衬线文本上没有任何
font-weight: 700或900。 - 任何地方都没有
font-style: italic。强调改为使用墨蓝色字体颜色或.tag标签。 - 所有数字堆叠(指标数值、页码、日期、财务数据)都必须带有
font-variant-numeric: tabular-nums。 - 所有标签填充均为纯十六进制颜色(例如
#E4ECF5),绝不使用rgba()。 - 阴影:最多一个
1px描边或0 4px 24px rgba(0,0,0,0.05)微阴影。没有硬投影。 - 展示尺寸的标题 ≤ 6 个单词;中日韩文字 ≤ 8 个字符。
- 在 768px 和 560px 宽度下,布局折叠为单列,无水平滚动。
本技能包含的文件
skills/kami-landing/
├── SKILL.md # 本约定文件
├── README.md # 人类快速入门
└── example.html # Galyarder Design 的规范渲染示例
边界约束
- 不要发明新的颜色或字体。kami 调色板是固定的;如果简介要求品牌色,请拒绝,或者将品牌色以一个
.tag.brush标签的形式呈现。 - 不要引入第二种强调色。选择墨蓝色或者什么都不选。
- 不要在一个声明中混用所有三种字体堆栈;选择主导语言,在
:root上覆盖--serif,然后让浏览器的逐字形后备机制处理内联混合脚本内容。 - 不要对标签填充使用
rgba()—— 打印渲染器会双重绘制带有 alpha 通道的标签。请使用design-systems/kami/DESIGN.md§2 表格中预混合的纯十六进制颜色。 - 不要为动画添加 JavaScript。页面是纸张,不是应用 —— 动感应属于读者滚动时产生的。
参见
design-systems/kami/DESIGN.md—— 完整的令牌规范。skills/kami-deck/—— 姊妹技能,可使用相同的 kami 语言生成幻灯片演示文稿。- 上游:
tw93/kami—— 本设计系统所借鉴的原始 Claude 技能(MIT 协议)。