名片工坊 · Business Card Studio

把任意用户的身份信息，渲染成一张 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	如 SKILL.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. 运行

python3 scripts/render_card.py \
  --name "品牌方" --latin "Mark Shawn" \
  --brand "SKILL.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，但脚本本身不读取任何固定个人路径。

Runtime context (shared)

运行前读取本 Skill 包的 skill.yaml，由宿主提供 skill-runtime/v1 上下文。字段解析顺序为：当前请求、项目上下文、个人 Preferences、品牌 Profile、通用默认值。

• 只使用 Manifest 声明的字段；Profile 保存公开品牌事实，Preferences 保存个人工作偏好。
• required: true 字段缺失时，按 Manifest 的问题配置向用户提出一个聚焦问题；用户明确同意后再保存回答。
• 报错提供可复制的 context_id、字段路径与来源，诊断内容避开秘密、完整私人路径和原始配置。

通用反馈闭环

用户在 Skill 驱动任务中提出修改意见时，继续当前产物前必须执行：

1. 先判断意见是 task-specific（仅本次）还是 reusable（可跨任务复用）。
2. task-specific 只修改当前任务，不改 Skill。
3. reusable 先确定作用域：领域规则先更新对应 canonical Skill；适用于所有 Skill 的规则先更新共享规范。
4. 完成规则更新、版本、lint 与分发核验后，再把修改应用到当前任务。
5. reusable 修改会使此前的“确认”“继续”“发吧”失效；完成当前产物修改和回读后必须停下，等待用户下一步指示，不自动进入发布、提交或其他外部写入。