commit 4b1558dacea4ef1923f283697ef842a6fa8096cf Author: wehub-skill-sync Date: Mon Jul 13 21:36:13 2026 +0800 chore: import zh skill kami-landing diff --git a/README.md b/README.md new file mode 100644 index 0000000..604235f --- /dev/null +++ b/README.md @@ -0,0 +1,59 @@ +# kami-landing + +一个即插即用的技能组件,能将需求简报转化为一份适合印刷的 kami 风格一页纸—— +暖色 parchment 画布、墨蓝色强调色、统一字重的衬线体,无斜体,无冷灰色调。 +输出效果类似白皮书或工作室一页纸,而非应用界面。 + +> **请先阅读** — 代理合约、Schema 以及自检清单均位于 +> [`SKILL.md`](./SKILL.md) 中。本 README 是针对人类的快速入门。 + +## 你会得到什么 + +一份独立的单文件 HTML,包含: + +- **暖色 Parchment 画布**(`#f5f4ed`),绝不使用 `#ffffff`。 +- **单一色相强调色** — 墨蓝色(`#1B365D`),限制在可见面积的 5% 以内。 +- **字重为 500 的衬线体**用于层次结构。全篇无斜体。 +- **紧凑的印刷节奏** — 行高 1.10–1.55,按语言感知的字符间距。 +- **每个数字堆栈使用表格数字(tabular-nums)**。 +- **纯十六进制标签填充**(不使用 `rgba()`,因为打印渲染器会双重绘制)。 +- **1px 描边环 + 隐约阴影**用于深度感 — 不使用硬投影。 +- **天然多语言**(可通过 `language` 参数选择 EN / zh-CN / ja 堆栈)。 + +## 30 秒速览 + +该技能是"由代理驱动、无脚本"模式:没有 `compose.ts`。代理读取 `SKILL.md`,收集需求简报,然后直接使用 [`design-systems/kami/DESIGN.md`](../../design-systems/kami/DESIGN.md) 中目录化的 token 和组件编写 `out/index.html`。 + +预览规范版的 Open Design 实例: + +```bash +open example.html +``` + +开始一个新项目: + +1. 在您的代理(Claude · Cursor · Codex · …)中打开该技能。 +2. 回答两轮简报问题(品牌标识 + 内容)。 +3. 编写文件。完成。 + +## 文件结构 + +```text +skills/kami-landing/ +├── SKILL.md # ← 代理合约(请先阅读此文件) +├── README.md # ← 你在这里 +└── example.html # 规范版 Open Design 渲染效果 +``` + +## 边界约束 + +- 无外部 JavaScript。页面是纸张,而非应用。 +- 无硬投影、无拟态设计、无 `backdrop-filter`。 +- 无第二强调色。无斜体。无冷蓝色调。 +- 每页最多使用一个 `.tag.brush`(它是唯一被允许的渐变效果)。 + +## 另请参阅 + +- [`design-systems/kami/DESIGN.md`](../../design-systems/kami/DESIGN.md) — 完整的 token 规范。 +- [`skills/kami-deck/`](../kami-deck/) — 同系列技能,用于生成同一 kami 设计语言的幻灯片。 +- 上游来源:[`tw93/kami`](https://github.com/tw93/kami) — 原始 Claude 技能(MIT 许可证),本设计系统改编自该项目。 diff --git a/README.wehub.md b/README.wehub.md new file mode 100644 index 0000000..b6e2916 --- /dev/null +++ b/README.wehub.md @@ -0,0 +1,9 @@ +# WeHub 来源说明 + +- Skill 名称:`kami-landing` +- 中文类目:kami 纸张风品牌白皮书/落地页 +- 上游仓库:`nexu-io__open-design` +- 上游路径:`design-templates/kami-landing/SKILL.md` +- 上游链接:https://github.com/nexu-io/open-design/blob/HEAD/design-templates/kami-landing/SKILL.md +- 本仓库为 WeHub 中文 Skill 汉化包,基于 skill 市场筛选 Top200 清单整理 +- 原作者、版权和许可证信息以上游仓库为准 diff --git a/SKILL.md b/SKILL.md new file mode 100644 index 0000000..354b335 --- /dev/null +++ b/SKILL.md @@ -0,0 +1,190 @@ +--- +name: kami-landing +description: > + 生成一份可印刷品质的单页 kami(紙 / 纸)文档——暖色羊皮纸画布、墨蓝强调色、 + 单一字重衬线体、无斜体、无冷灰。输出读起来像专业白皮书或工作室一页纸, + 而非应用 UI。天然支持多语言(EN · zh-CN · ja)。一个自包含的 HTML 文件, + 零依赖。 +triggers: + - kami + - 紙 + - 纸 + - paper one-pager + - 白皮书 + - white paper + - parchment landing + - editorial document + - print-grade page + - kami landing +od: + category: brand-page + surface: web + mode: prototype + platform: desktop + scenario: marketing + audience: founders, design studios, OSS maintainers, researchers + tone: editorial, restrained, print-first + scale: viewport-anchored long-form single page + preview: + type: html + entry: index.html + reload: debounce-100 + design_system: + requires: false + craft: + requires: + - typographic-rhythm + - pixel-discipline +inputs: + - id: brand + label: Brand identity + description: 名称、标语、地点、版本/修订号、主 URL。 + - id: hero + label: Hero / cover block + description: 眉标 + 大标题(一行,显示尺寸下 ≤ 6 词)+ 副标题 + 3 个 hero 元信息标记。 + - id: manifesto + label: Manifesto paragraph + signature + - id: metrics + label: 3-6 metric tiles (value · label · sub) + - id: chapters + label: 3-5 个带编号的章节(标题 + 导语 + 正文) + - id: footer + label: License · year · contact + 3-column site index +parameters: + output_format: + type: enum + values: [standalone-html] + default: standalone-html + language: + type: enum + values: [en, zh-CN, ja] + default: en + description: > + 在 `:root` 上设置主要衬线字体栈。英文使用 Charter, + 中文使用 TsangerJinKai02 / Source Han Serif,日文使用 + YuMincho。允许内联混排内容;浏览器按字形自动进行降级回退。 +outputs: + - path: /index.html + description: 自包含 HTML,kami CSS 内联,零 JS,除 Google Fonts 外零外部依赖。 +capabilities_required: + - file-write +example_prompt: | + 为我打造一份 kami 风格的一页纸,品牌为"Lumen Field", + 一家发布专注用声景应用的小众工作室。大标题 "Soundscapes for + focused work.",宣言段落 + 签名 "by Lumen Field, + Berlin",3 个指标卡片(12 soundscapes / 4 presets / 1 daily ritual), + 三个带编号的章节,分别介绍工作室、应用和路线图。 + 英文语言栈。 +--- + +# kami-landing + +生成一份 **kami(紙 / 纸)** 设计系统的单页文档。 +其美学借鉴了编辑印刷物、技术白皮书和旧式打字机信件——目标是*好内容印在好纸上*, +而非*现代应用 UI*。 + +> **设计系统权威来源:** [`design-systems/kami/DESIGN.md`](../../design-systems/kami/DESIGN.md)。 +> 交付前请先阅读。标记(tokens)、排版规则、"十大不变原则"以及禁用色都在那里。 + +## 你将获得 + +一个自包含的 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 断点。 + +## 页面结构 + +```text +1. 眉标行 —— 语言切换器 · 版本 · 修订号(12px 无衬线大写) +2. Hero —— 展示级大标题(96–106px 衬线 500 字重)、副标题(21px)、 + 三个 hero 标记芯片(纸张色调) +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`(或等效方法)分批次收集品牌简介。不要一次性将所有输入项抛给用户;分两轮询问: + +1. 身份轮——名称、标语、地点、版本/修订号、主 URL、主要语言。 +2. 内容轮——宣言段落 + 签名、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`](./example.html) 的结构,且仅使用 `design-systems/kami/DESIGN.md` 中的标记。**不要**发明新的颜色、字重或字体族。 + +agent 可直接插入的组件基元(均在示例的 ` + + + +
+ + +
+
+ EN + 中文 + 日本語 +
+
+ Vol. 01 · 期号 Nº 26 + v0.2.0 + Apache-2.0 + MMXXVI +
+
+ + +
+
+

在温暖纸张上设计智能。

+

面向编辑文档、白皮书和单页的开源工作室——由你自己的编程代理排版。

+
+
+ 31 项技能 + 72 套设计系统 + 12 款代理 · BYOK +
+
+ + +
+ 宣言 · Nº 01 +
+

+ 我们将你现有的编程代理视为一位创意协作者,而非一个黑箱。Open Design 赋予它 31 项可组合的技能和 72 套品牌级设计系统,然后让路。输出的是一个真正的文件——而非一段提示词——你明天就可以交给客户。 +

+
+ — Open Design Studio + 柏林 · 开放 · 地球 · 52.5200° N · 13.4050° E +
+
+
+ + +
+
+
31
+
项技能
+
基于文件,今天即可交付,与 Claude Code 即插即用。
+
+
+
72
+
套设计系统
+
可移植的 DESIGN.md 设计令牌——Linear、Vercel、Stripe、Apple、kami……
+
+
+
12
+
款代理 CLI
+
在 $PATH 中自动检测;一键切换后端。
+
+
+
3
+
条命令
+
git clone 到第一个成品,本地离线完成。
+
+
+ + +
+ +
+
+

01

+

它是什么

+

一个面向你已信任的代理的本地优先设计工作室。

+
+
+

+ Open Design 是 Anthropic 的 Claude Design 的开源替代品。它在你的笔记本电脑上运行。你的代理读取一个 SKILL.md 文件文件夹和一个 DESIGN.md 系统文件夹,然后生成真实文件——落地页、幻灯片、白皮书、单页、移动端原型、仪表盘。 +

+

+ 技能提供行为。系统提供品味。适配器桥接代理。BYOK 尊重你的钱包。每个输出都是可移植的 HTML 或 Markdown——没有专有文件格式,没有供应商锁定。 +

+
    +
  • 文件,而非不透明的提示词——每项技能都是一个 Markdown 文件夹。
  • +
  • 确定性的视觉方向,而非随机生成。
  • +
  • 沙箱化 iframe 预览,真实的 cwd,可导出的成品。
  • +
+
+
三条命令 · 30 秒
+
# 克隆、安装、启动本地守护进程。
+git clone https://github.com/nexu-io/open-design
+pnpm install
+pnpm tools-dev
+
+
+
+ +
+
+

02

+

它的感受

+

编辑纪律,而非聊天窗口的即兴发挥。

+
+
+

+ 一个新项目始于一个 30 秒的问题表单:品牌、受众、规模、语言。代理在 OKLch 色空间中选择五种视觉方向之一,锁定字体堆栈,将成品写入磁盘。你可以阅读它触碰过的每一个文件。 +

+

+ 每次迭代都在沙箱化的 iframe 预览中审阅,每个可编辑元素都带有注释模式锚点,这样你可以给出有针对性的反馈,而无需重述整份简报。重新运行是确定性的——相同的简报,相同的输出。 +

+

+ 结果就是 看起来像 AI看起来像已发布 之间的区别。按惯例每页一个笔刷标签;其余部分保持纯色十六进制。 +

+
+
+ +
+
+

03

+

下一步发布什么

+

2026 年第二季度——打包、多租户令牌、守护进程加固。

+
+
+

+ 路线图是公开的。我们现在正在推进的三条线索: +

+
    +
  • 打包桌面构建——签名版 Mac、Windows NSIS、Linux AppImage,全部源自 tools-pack
  • +
  • 多租户品牌令牌——一个运行的守护进程,多个租户;OD_DATA_DIROD_MEDIA_CONFIG_DIR 已打下基础。
  • +
  • 守护进程端成品持久化——每次渲染都是磁盘上的一个文件,位于 .od/artifacts/ 下,带有稳定的 SHA,因此设计历史在每次代理重启后都能保留。
  • +
+

+ 此列表中的任何内容都不需要付费计划。Open Design 将永远保持 Apache-2.0 许可;工作室通过销售品牌级设计系统来盈利,而非限制运行时功能。 +

+
+
+ +
+ + + + + + +
+ +