---
name: lov-business-card
description: >
  Generate a professional, editorial-style business card (2:1) as a
  high-resolution PNG and a self-contained interactive HTML. Collects the user's
  identity (name, roles, tagline, interests, locations, optional avatar), fills a
  parameterized design template with a chosen theme, and renders it via headless
  Chrome. Trigger when the user wants to make a business card, personal card, name
  card, profile card, or "电子名片", or says "生成名片", "做一张名片", "个人名片",
  "make a business card", "design a name card".
license: MIT
compatibility: >
  Portable Agent Skills format. Requires Python 3.8+ and a Chromium-based browser
  (Google Chrome or Chromium) for PNG rendering; without one, the HTML still works
  in any browser via its built-in download button. macOS uses sips for cropping,
  other platforms need Pillow. All identity/brand/output values come from CLI
  flags — no personal paths are hard-coded.
metadata:
  author: lovstudio
  version: "0.1.0"
  tags: business-card, design, branding, png, html
---

# business-card — 专业精美电子名片生成器

把任意用户的身份信息，渲染成一张 2:1 的编辑式（editorial / luxury-minimal）名片：
瑞士排版网格、发丝线分隔、单一强调色、宋体 × Didot 字体配对。输出高分辨率 PNG
（默认 4800×2400）+ 一个自包含、可在浏览器点击下载的 HTML。

## 工作流

### 1. 先用 AskUserQuestion 收集信息（必做）

**不要直接跑脚本。** 先确认主题与必填项。能从对话/记忆里推断的先预填，只问不知道的。

建议问题（一次最多 3 个）：

- **主题**：dark-terracotta（暖深·陶土，默认）/ midnight（冷深·钢蓝）/ ivory（浅·象牙编辑风）
- **是否有头像**：有 → 要文件路径；无 → 用名字首字渲染 monogram
- **强调词**：tagline 里哪个词要高亮（强调色）

身份字段尽量从上下文取；缺的逐项问或让用户一次性给。

### 2. 映射到 CLI 参数

| 用户提供 | flag | 说明 |
|---|---|---|
| 姓名 | --name | 必填，支持中文 |
| 英文名/罗马音 | --latin | 名字旁的斜体小字 |
| 品牌（左上） | --brand | 如 LOVSTUDIO.AI（含 . 会高亮圆点） |
| 编号（右上） | --index | 如 STUDIO — Nº 2026 |
| 角色标签 | --tags | 逗号分隔，菱形分隔渲染 |
| 金句 | --tagline | **词** 高亮，竖线 \| 换行 |
| 爱好/兴趣 | --pursuits | 逗号分隔（底栏左） |
| 据点/城市 | --bases | 逗号分隔，每项带定位针（底栏右） |
| 头像 | --avatar | 图片路径；省略则用 monogram |
| 头像图注 | --caption | 可选，肖像底部小字 |
| 主题 | --theme | dark-terracotta｜midnight｜ivory |
| 输出目录 | --out | 默认 ./output |
| 格式 | --format | png｜html｜both（默认 both） |

### 3. 运行

```bash
python3 scripts/render_card.py \
  --name "手工川" --latin "Mark Shawn" \
  --brand "LOVSTUDIO.AI" --index "STUDIO — Nº 2026" \
  --tags "背包客,超级开发者,AI / OPC 布道师" \
  --tagline "在 **Agent 时代**，|寻找**人**的意义" \
  --pursuits "旅行,羽毛球,计算机科学,心理学,哲学" \
  --bases "上海 陆家嘴数智港,北京 搜狐大厦清智孵化器" \
  --avatar ./me.png --theme dark-terracotta \
  --out ./output --format both
```

### 4. 交付

把 PNG 展示给用户；告诉他们 HTML 可在浏览器打开、右下角「下载为图片 PNG」自出 3× 高清图
（HTML 与同目录的 modern-screenshot.umd.js 需一起保留）。

## 设计说明

- 比例：固定 2:1（1600×800 画布），PNG 按 --scale 倍率导出（默认 3 → 4800×2400）。
- 自适应：HTML 在浏览器里等比缩放铺满视口，绝不放大、不溢出；导出尺寸不受影响。
- 无头像：自动用姓名首字渲染衬线 monogram，仍然专业。
- 主题扩展：在 scripts/render_card.py 的 THEMES 字典加一组 CSS 变量即可。

## User Configuration

本 skill 不假设任何私有工作区。所有身份、品牌、输出路径都由 CLI flag 传入；
--out 默认当前目录下 ./output。如需复用默认身份，调用方可自行从用户 profile
预填这些 flag，但脚本本身不读取任何固定个人路径。