portfolio-detail — Estúdio Chinês / Portfólio com Tipografia Lishu (com Páginas de Detalhe Secundárias)
Resumo em uma Frase
Linhas de texto horizontais + imagem grande que aparece ao passar o mouse (hover) + letras grandes decorativas da fonte Alimama DaoLiTi + cores preto e branco + tema claro/escuro + páginas de detalhe com rota hash + modo lista/álbum.
Diferenças de Outras Skills de Portfólio
| Skill | Modo Principal | Ideal para |
|---|---|---|
portfolio-gen | Tela infinita com arrastar e soltar + blocos lado a lado | Fotógrafos / Designers gráficos que mostram amostras |
portfolio-museum-gen | Carrossel hero + cartões grandes + fluxo em cascata + páginas de detalhe (curadoria de vídeo) | Artistas de vídeo / imagem / instalação |
industrial-archive-gen | Capa de virar página com moldura preta + arquivo lateral + design industrial nórdico | Produtos físicos / objetos / hardware |
lishu-portfolio-gen | Linhas de texto horizontais + miniatura lateral ao passar o mouse + letras grandes lishu + estilo chinês contido | Encadernação / Tipografia / Artesanato / Estúdio Chinês |
Se o projeto do usuário é sobre "livro / tipografia / exposição / naturezas-mortas / ervas chinesas / chá / cerâmica / madeira / papel / incenso" — algo que requer um estilo contido e elegante — use esta skill.
Quando Usar
O usuário diz:
- "Crie um portfólio no estilo chinês / oriental / clássico"
- "Crie um site / página inicial de estúdio com estilo de caligrafia lishu"
- "Crie um portfólio no estilo da Casa Branca" / "Crie um site de lista horizontal como o Gurgel D'Alfonso"
- "lishu-portfolio-gen ..."
E fornece:
- Descrição do estúdio (obrigatório): nome, diretor, cidade, disciplinas, títulos e histórias de algumas obras.
- Imagens das obras (opcional): URL / upload / caminho. Funciona mesmo sem imagens (usa placeholders do picsum).
Se o usuário não fornecer títulos das obras → pergunte pelo menos quais obras serão exibidas. Se o usuário deu apenas os títulos, sem detalhes → você mesmo cria: para cada obra, gere uma frase de abertura (lead) + 3 parágrafos em prosa + 6-8 linhas de especificações + 3-6 imagens do picsum + alguns créditos. O tom deve combinar com o tipo de obra (livro → encadernação / letra → tipografia / objeto → naturezas-mortas / exposição → visual de exposição).
Dois Modos de Execução
Modo A · Claude Code / Local (com sistema de arquivos)
- Use
Bashpara listar pastas,sipspara verificar largura e altura de cada imagem. - Saída:
~/Desktop/{slug}-portfolio.html(arquivo único, todas as imagens via URL). - Se o usuário forneceu imagens locais: copie para
~/Desktop/{slug}-portfolio-images/e altere os src para caminhos relativos.
Modo B · GLM / Chat Online (sem sistema de arquivos)
- O usuário arrasta um zip e, após extração, consegue ver 4 arquivos.
- Gere apenas uma string HTML completa dentro de um bloco de código
```html. - Se o usuário enviar imagens sem URL → use
https://picsum.photos/id/{id}/{w}/{h}como placeholder (com IDs conhecidos que existem). - Não tente acessar arquivos locais, não sugira comandos de terminal.
Critério: se você não consegue ler imagens locais → assuma o Modo B.
Divisão de Arquivos
| Arquivo | Função | Como usar |
|---|---|---|
reference.html | Exemplo completo de produto final — Casa Branca BAIWU com 6 obras | Veja: tom das frases na lista, tom da prosa, vocabulário das especificações, densidade dos campos JSON |
template.html | Estrutura vazia — mesmos sistemas CSS/JS/rota, 2 exemplos + 20 marcadores SWAP | Modifique a partir dele, gere o HTML final |
README.md | Instruções de uso para o usuário | O modelo não precisa ler |
SKILL.md | Fluxo de trabalho para o modelo (este arquivo) | Leitura obrigatória |
Regra central: todas as alterações baseiam-se no template.html; aprenda como escrever (tom, tamanho do texto, palavras-chave das tags) a partir do reference.html, mas não copie o conteúdo literal.
Passos de Trabalho
1. Leia os Dois Arquivos HTML
- Primeiro, leia o
reference.htmlpara entender "como fica o produto final" (especialmente a densidade dos campos no JSONworks-datae o tom da prosa). - Depois, leia o
template.htmlpara encontrar os 20 marcadores SWAP.
Não altere JS / Não altere CSS / Não altere o sistema de rota das páginas de detalhe / Não altere a importação da fonte. Os SWAPs estão todos no texto HTML e nos dados JSON.
2. Analise a Entrada do Usuário e Extraia Informações
Extraia:
- ATELIER_NAME_ZH — Nome do estúdio em chinês (idealmente 2-4 caracteres, por exemplo, 「白屋」「素园」「墨记」「青庐」「拙轩」)
- PINYIN — Pinyin (5-6 letras inglesas, maiúsculas: BAIWU / SUYUAN / MOJI)
- CHAR — Caractere único para o logotipo (geralmente o primeiro caractere do nome do estúdio: 白 / 素 / 墨 / 青 / 拙)
- CITY — Cidade
- DIRECTOR_ZH / DIRECTOR_EN — Nome do diretor + pinyin
- DISCIPLINE — 3 termos da especialidade ("Encadernação · Tipografia · Natureza-morta")
- TAGLINE — Uma frase de posicionamento (20-40 caracteres, tom de tipo caligráfico kaishu)
- YEAR_FOUNDED — Ano de fundação (pode usar o ciclo sexagenário: 乙未冬 / 甲辰春)
Para cada obra, extraia:
- slug — ID da URL, letras minúsculas com hífen (ex:
kong-shan-ji/wu-ming-shu) - title_zh — Título em chinês (idealmente 2-5 caracteres, quanto mais conciso, maior o estilo)
- title_en — Subtítulo em inglês (estilo de título de livro:
An Anthology of Empty Mountains) - year — Ano ou ano do ciclo sexagenário (ex:
甲辰 / 2024/2025/乙巳 / 2025) - tag — Categoria no topo, entre colchetes, ex:
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL da imagem grande da página de detalhe
- Localização da linha na lista —
Cidade, Ano · Técnica/Especificação(aparece ao passar o mouse) - meta — 4 pares chave-valor (resumo de 4 colunas na página de detalhe)
- lead — 30-70 caracteres de abertura em letras grandes, pode usar
<em>palavra-chave</em>para dar ênfase - prose — 3-4 parágrafos em prosa, cada um com 80-150 caracteres
- specs — 6-10 linhas de tabela de especificações (Formato/Papel/Encadernação/Tipografia/Impressão/Tiragem/Pedido/Preço etc.)
- gallery — 3-6 imagens, layout escolha entre três:
g-wide/g-half/g-third - credits — 4-7 pares de cargo/nome
Se o usuário der apenas uma frase / nenhuma história → invente você mesmo: baseado no título e tipo da obra, escreva um lead e uma prosa que combinem com o tom da obra. O tom deve seguir o reference.html — nada de linguagem de marketing, deve ter uma sensação de "texto de parede de museu + caderno de estúdio" (contido, específico, lento, com marcas artesanais).
3. Liste as Obras e Meça Dimensões (Apenas Modo A)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
Obtenha para cada imagem: (nome do arquivo, largura, altura, proporção). Priorize imagens em pé para as miniaturas da lista (contêiner 4:3, imagens em pé ficam melhores).
4. Substitua os 20 SWAPs
| SWAP | Localização | Conteúdo |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — {DIRECTOR} Portfólio / Studio |
| 2 | meta description | Uma breve descrição do site |
| 3 | Caractere único da cortina | Primeiro caractere do nome do estúdio (ex: 「白」) |
| 4 | Caractere único do logotipo SVG | Mesmo que SWAP-3 |
| 5 | Pinyin do logotipo SVG | {PINYIN} em maiúsculas |
| 6 | li da navegação principal | Normalmente 3 itens: 作品 / 关于 / 联系 |
| 7 | Nome chinês do bloco da marca | {ATELIER_NAME} com espaços entre caracteres (ex: 白 屋) |
| 8 | Inglês do bloco da marca | {PINYIN} Studio · {CITY} |
| 9 | Tagline | Frase de posicionamento em tom kaishu, 20-40 caracteres, pode usar <br> para quebras de linha |
| 10 | N itens da lista | Cada <a class="item" href="#work/{slug}"> contendo num/project-name/en-name/location/photo-thumb |
| 11 | N itens da galeria | Os mesmos N itens da lista, grade mais compacta — slug deve ser idêntico ao da lista |
| 12 | Título "Sobre" | 关 于 {name}<span class="en">About</span> |
| 13 | Parágrafos "Sobre" | 1-3 parágrafos em tom kaishu (contexto de fundação / diretor / filosofia de design), cada um com 60-120 caracteres |
| 14 | Tabela de fatos "Sobre" | 4-6 itens li (Founded/Location/Discipline/Director/Hours) |
| 15 | Título "Contato" | 来 信<span class="en">Get in Touch</span> |
| 16 | Parágrafo "Contato" | 1-2 parágrafos convidando a escrever + promessa de tempo de resposta |
| 17 | Tabela de fatos "Contato" | 4-6 itens (E-mail/Phone/Address/Instagram/WeChat Official Account) |
| 18 | Crédito rotativo | Site by {QUEM} (geralmente o nome do estúdio) |
| 19 | Três blocos do rodapé | © / ICP / Links sociais |
| 20 | JSON works-data | Dados completos de detalhes de N obras (Crítico!) |
5. Escreva o JSON works-data (Passo Mais Importante)
Cada obra deve ter uma entrada no array JSON, o slug deve corresponder exatamente ao href dos cards de lista/galeria #work/SLUG.
Campos JSON:
{
"slug": "kong-shan-ji",
"title_zh": "空山集",
"title_en": "An Anthology of Empty Mountains",
"year": "甲辰 / 2024",
"tag": "[ 诗集 · 装帧设计 ]",
"cover": "https://picsum.photos/id/143/1800/1100",
"meta": [
{"label": "Type / 类型", "value": "诗集装帧"},
{"label": "Year / 年份", "value": "2024"},
{"label": "Edition / 印量", "value": "首印 320 本"},
{"label": "Format / 开本", "value": "130 × 195 毫米"}
],
"lead": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见<em>风声</em>,再读见字的书。",
"prose": [
"段落一:诗稿来源 / 设计语境。80—150 字。",
"段落二:制作中的关键决定 — 字体、纸张、装订选择。",
"段落三:最后呈现 / 留给读者的感受。"
],
"specs": [
["开本 / Format", "130 × 195 毫米"],
["页数 / Pages", "144 页"],
["纸张 / Paper", "本色棉纸 90gsm"],
["装订 / Binding", "线装四目"],
["字体 / Typeface", "老宋(标题)· 楷体(正文)"],
["印刷 / Printing", "单色凸印"],
["印量 / Edition", "首印 320 本"],
["定价 / Price", "¥ 388"]
],
"gallery": [
{"src": "...", "layout": "g-wide", "caption": "封面"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"}
],
"credits": [
["设计 / Design", "周墨白"],
["手工装订 / Binding", "陈漱石(杭州·订书坊)"]
]
}
Erros comuns no JSON ⚠️:
- Em prosa em chinês, use aspas → deve usar
「...」(aspas chinesas) ou"..."(U+201C / U+201D), proibido usar"ASCII (quebra o JSON). - Não use quebras de linha reais em strings JSON; para parágrafos, adicione mais um item no array prose.
- Em
<em>palavra</em>no lead, escreva diretamente a tag HTML — a renderização usa innerHTML. - O
layoutda gallery deve ser escolhido entre três:g-wide(ocupa todo o espaço) /g-half(ocupa metade) /g-third(ocupa 1/3).
6. Escolha da Fonte das Imagens
- Placeholder do picsum: use o formato
id/Xem vez deseed/X(mais estável). IDs conhecidos bons: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200. - Para cover/gallery da mesma obra, use IDs próximos (cria uma paleta de cores consistente).
- Não use o parâmetro
?grayscale(o usuário espera imagens coloridas).
7. Inspiração para Nomes de Estúdio Chinês (Se o Usuário Não Der)
Se o usuário disser "invente um" → escolha 2 caracteres + tom clássico:
- Categoria de objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Categoria de letras/caligrafia: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Evite palavras funcionais como "工作室 / 设计 / Studio", o nome deve ser poético por si só.
8. Suporte a Vídeo
Se a cover da obra for .mp4 / .webm / .mov, a página de detalhe usará automaticamente <video autoplay muted loop> em vez de <img>. Basta o modelo fornecer o caminho do vídeo na URL da cover.
9. Relatório
Modo A: Relatório de uma frase.
Gerado ~/Desktop/baiwu-portfolio.html — 6 obras, linha com hover para ver miniatura, clique para entrar na página de detalhe. Light/Dark no canto inferior esquerdo, lista/álbum no centro superior.
Modo B: Bloco de código HTML completo + uma linha de instrução.
Salve o bloco acima como
index.htmle abra com duplo clique. Passe o mouse sobre o nome de qualquer obra para ver a miniatura que aparece à direita, clique para ir para a página de detalhe. Para trocar as imagens, substitua as URLs do picsum pelos seus endereços de imagem.
Itens Obrigatórios (Não Podem Ser Alterados)
- Importação da fonte: carregamento via
@font-facedo woff2 da Alimama DaoLiTi (não troque a fonte). - Sistema de variáveis CSS: temas claro/escuro.
- Todo o JS: alternância de tema, alternância de modo de visualização, interação hover da linha, crédito rotativo, rota hash da página de detalhe
applyRoute(),renderDetail(). - O nó
<script id="works-data">deve ser mantido. - O elemento
<main id="detail-root">deve ser mantido (ponto de montagem da página de detalhe). - Sistema de estado
body[data-view="home/detail"]ebody[data-mode="list/gallery"]. - Cinco elementos fixos:
#logo / #main-menu / .theme-toggle / #project-view / #svp-credit.
Verificação Rápida de Erros Comuns
- Slug inconsistente: item da lista
#work/kong-shan-ji↔ item da galeria#work/kong-shan-ji↔ JSON"slug": "kong-shan-ji"— os três devem ser exatamente iguais. - Aspas no JSON: as aspas no conteúdo em chinês devem ser as aspas chinesas
「」ou"...", não"ASCII. - Muitas imagens na galeria: no máximo 6 imagens por obra; mais que isso, o layout fica bagunçado.
- Prosa muito longa: cada parágrafo deve ter 80-150 caracteres; acima de 200, a experiência de leitura diminui.
- Lista / Galeria fora de sincronia: devem conter o mesmo conjunto de obras (correspondência um a um).
- Seed do picsum: use
id/X, nãoseed/X, para evitar que IDs aleatórios caiam em imagens removidas. - Menos de 3 obras: funciona com no mínimo 2 obras.
- Mais de 8 obras: sugira dividir em dois lotes; muitas linhas na lista deixam a página comprida.
- Primeira letra grande: o seletor
.detail__prose p:first-of-type::first-letterusa a fonte DaoLiTi — o primeiro parágrafo deve começar com caracteres chineses (não comece com<em>ou letras inglesas). - Removeu o colorido do picsum: as imagens devem permanecer coloridas; não adicione
filter: grayscale()no CSS.