通用人物个人网站生成器
把「一堆人物资料 + 一叠照片」变成「一个可以打开就看的单文件个人网站」。
产出是一个自包含的 HTML 文件加一个 images/ 目录：黑底、单强调色、六段式结构
（Hero / 关于 / 里程碑 / 作品 / 动态 / 荣誉），带加载动画、固定视差、右侧滑入菜单、
打字机、滚动进场、卡片悬停等一整套动效，响应式适配手机。
何时使用
- 用户提供某人的资料（简历、简介、百科条目、新闻稿、口述）与照片，要求做成网页。
- 用户要求"照着某个模板的样子"给某人做个人主页。
- 用户已有个人网站文件，要求重做版式 / 换风格 / 加区块。
不适用：企业官网（多页面、产品线、导航层级多）、电商、后台系统。
这些场景此模板的六段式结构承载不了，应向用户说明并改用通用前端方案。
工作流
第 1 步：盘点输入
确认三样东西是否齐备，缺什么就问什么，不要凭猜测编造事实：
| 输入 | 必要度 | 说明 |
|---|---|---|
| 人物资料 | 必需 | md / docx / txt / 网页 / 用户口述均可 |
| 照片 | 必需 | 至少 1 张横幅大图（Hero）；有头像和作品图则效果完整 |
| 参考模板 | 可选 | 用户给了就提取其配色与动效特征；没给就用内置默认风格 |
资料不足时先用 WebSearch 补齐公开信息（作品年表、获奖、票房、最新动态都属公开可查），
再向用户确认。严禁编造未在资料中出现的事实、数字或引语。
第 2 步：读设计规范，确定主题
Read references/design-system.md，按主体气质从 6 个主题预设里选一个
（演员→black-red、企业家→black-gold、工程师/学者→black-cyan、
设计师→black-purple、教师/公益→black-green、电竞/创作者→black-orange）。
不确定时按 black-red 起步，生成后让用户看效果再调 —— 换主题只需要一个命令行参数。
第 3 步：把资料转成配置
这是决定成品质量的一步。Read references/content-mapping.md，严格按其中的
字段改写公式和字数要求填写 site.json：
- 以
assets/example-config-wu-jing.json为模板复制改写（它是一份填满的完整示例）。 - 字段含义查
assets/site.schema.json。 - 硬性要求：
about80–160 字且含 2–3 处<strong>；milestones和works各 3 或 6 条；
stats4 条；roles4 条。条数不是 3 的倍数时网格会留空位。 - 每条
milestones[].text里至少要有一个数字。
第 4 步：生成
python scripts/build_site.py --config site.json --out <输出目录>
python scripts/build_site.py --config site.json --out <输出目录> --theme black-gold
python scripts/build_site.py --list-themes # 查看全部主题
脚本会：把引用的图片复制进 <输出目录>/images/ 并按用途重命名为 ASCII 文件名
（hero.jpg / about.jpg / work-N.jpg / news-N.jpg，同源图片自动去重）、
渲染全部区块、去除资料未覆盖的空区块，最后打印体检报告与缺失字段告警。
必须读脚本输出的告警：它会指出条数不足（网格会留空位）和关键字段缺失
（stats 缺失会让 About 区视觉分量明显变轻，roles 缺失会让打字机效果形同虚设）。
第 5 步：自检
Read references/interaction-recipes.md 的「踩坑清单」与「快速自检脚本」两节，逐条核对。
其中最高频的三个故障是：进场元素漏写 .loaded 显示规则导致整段空白、
REVEAL_SELECTOR 漏掉新加区块、导航锚点与区块 id 不匹配。
脚本生成的产物已内置正确的规则，只有在手改 HTML 或往脚本里加新区块时才需要特别核对。
第 6 步：交付
用 present_files 打开生成的 HTML 预览。同时说明：主题色是否可换、照片是否需要替换
（脚本不裁剪图片，构图不合适需要先处理原图）、哪些事实有待用户确认。
与参考模板的关系
用户常提供从模板网站下载的离线模板（如模板王系列）作为风格参考。
此时只提取其风格特征（强调色、缓动曲线、卡片悬停方式、字号字距关系），
用 references/interaction-recipes.md 的配方在本模板里实现，不要直接拷贝模板的
HTML/CSS 资源 —— 那些多为商业授权模板，且其冗余依赖（jQuery、Bootstrap、
Owl Carousel、WOW.js 等）会破坏本模板"零外部依赖"的核心优势。
硬性约束
- 产出必须自包含：HTML/CSS/JS 全内联，除 Google Fonts 外不引用任何外部资源。
断网时仅字体回退，布局与动效不受影响。 - 图片一律用相对路径
images/xxx.jpg，文件名保持 ASCII。 - 不编造事实。资料里没有的数字、奖项、引语一律不写。
- 页脚保留「内容基于公开资料整理」类声明。
- 交付前必须用 present_files 打开预览，不能只贴文件路径。
文件索引
SKILL.md 本文件：工作流与约束
scripts/build_site.py 生成器：site.json + 照片 → 单文件网站
assets/site.schema.json 配置字段的完整定义
assets/example-config-wu-jing.json 填满的示例配置，改它最快
references/content-mapping.md 资料 → 配置 的提取与改写规则（质量关键）
references/design-system.md 色彩 / 排版 / 栅格 / 区块节奏 / 禁忌
references/interaction-recipes.md 14 项动效清单 + 改造方法 + 踩坑清单 + 自检脚本
常见变体
- 换主题：
--theme换气质；--accent "#RRGGBB"精确指定。 - 少区块：配置里删掉对应字段即可，脚本会自动从导航里移除，不留空壳。
- 多主体批量：同一份
site.json结构换name/ 资料 / 照片即可复用，
建议每个主体一个输出目录。 - 发布上线：先本地预览确认，再用
sitesskill 部署成可分享链接。
