idea-foliolisted
Install: claude install-skill ZhiYin-yi/idea-folio
# idea-folio
**from imagination to a portfolio** —— 把「几张图」变成「一个两页的编辑设计风个人站」。
风格参照:高对比黑白、大字号紧凑排版、全屏图首屏 + 模糊过渡、可滑动作品卡、可翻转数据卡、仪表盘式数据区。两页:`/`(欢迎)+ `/about.html`(介绍,6 个区块)。
## 先看样例
`assets/example/` 是**零输入**(不给图、不给文案)跑出来的完整成品,含 5 张截图与验收记录。想知道能产出什么,先看那五张图;想照着改,看 `assets/example/NOTES.md` 的待替换清单。
## 为什么用模板而不是重新写
风格稳定来自 **模板 + 单一内容入口**。每次让模型重新写页面,字号、间距、阴影都会漂移。所以:
- 版式、组件、CSS **一律不动**
- 只改 `src/content.js` 和 `public/img/*.jpg`
- 组件保持原样(SplitText / Carousel / AnimatedList / FlipCard / BellToggle / PulseHeart / CardNav / TargetCursor)
模板里 6700 行代码是**字节级复制**过去的,不是重新生成的 —— 这是「一模一样」能成立的原因。
## 输入
| 项 | 必需 | 说明 |
|---|---|---|
| 图片 | 否 | **0–5 张**。0 张走自带默认图;1 张自动裁 6 个槽位;多张按顺序分配 |
| 名字 | 否 | 默认 `ZhiYin`,写进 `content.js` 的 `NAME` |
| 邮箱 | 否 | 默认 `hello@example.com` |
| 作品类别 | 否 | 默认三类:Product surfaces / Front-end builds / Motion studies |
| 主色 | 否 | 默认黑白;用户要彩色才改 `content.js` 里的强调色 |
缺什么就用默认值,并在交付时列出「待替换清单」,不要反复追问。
## 图片槽位
固定比例,**只裁切不拉伸**:
| 槽位 | 比例 | 用途 |
|---|---|---|
| `welcome` | 3:2 | 首页 `/` 背景 |
| `hero` | 3:2 | 介绍页首屏 |
| `detail` | 4:5 | 01 区块右侧图卡 |
| `work-1..3` | 4:3 | 三张作品卡 |
## 流程
```powershell
# 1. 复制模板(不要就地改模板)
Copy-Item "<skill>\assets\template" "<目标目录>" -Recurse
# 2. 装依赖
cd <目标目录>; npm install --registry=https://registry.npmmirror.com
# 3. 图片(会同时写 src/image-tone.json)
python <skill>\scripts\images.py --project . --defaults <skill>\assets\defaults
# 带用户图:python <skill>\scripts\images.py --project . --in a.jpg b.jpg
# 4. 改文案:只改 src/content.js(占位符 {name} {email}