portfolio-detail — Estúdio Chinês / Portfólio em Lishu (com Páginas de Detalhe Secundárias)
Característica em uma frase
Linhas de texto horizontais + imagem grande que aparece ao passar o mouse no lado direito + letras artísticas grandes em Alimama DaoLiTi + preto e branco puro + light/dark + páginas de detalhe com roteamento hash + vista dupla de lista/álbum.
Diferenças entre os skills de portfólio
| skill | Modo principal | Para quem é |
|---|---|---|
portfolio-gen | Tela infinita de arrastar + blocos lado a lado | Fotógrafos / Designers gráficos pendurando amostras |
portfolio-museum-gen | Carrossel hero + cards grandes + fluxo em cascata + páginas de detalhe (curadoria de vídeo/imagem) | Artistas de vídeo / instalação |
industrial-archive-gen | Capa de virada com moldura preta + barra lateral de arquivo + nórdico industrial | Produtos físicos / objetos / hardware |
lishu-portfolio-gen | Linhas de texto horizontais + hover exibe miniatura à direita + letras grandes em Lishu + contido chinês | Encadernação / Tipografia / Artesanato / Estúdios chineses |
Se o projeto do usuário for 'livro / fonte / exposição / natureza-morta / ervas chinesas / chá / cerâmica / madeira / papel / incenso' — algo que precise de uma elegância contida — use este skill.
Quando acionar
O usuário diz:
- "Faça um portfólio de estilo chinês / oriental / clássico"
- "Faça um site / página inicial de estúdio em estilo Lishu"
- "Faça um portfólio estilo Casa Branca" / "Faça 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, disciplina, títulos e histórias de algumas obras
- Imagens das obras (opcional): URL / upload / caminho. Funciona mesmo sem (usa picsum como placeholder)
Se o usuário não der nenhum título de obra → pergunte pelo menos quais obras serão exibidas. Se o usuário deu apenas títulos sem detalhes → crie você mesmo: para cada obra, gere 1 lead + 3 parágrafos em prosa + 6-8 linhas de especificações + 3-6 imagens picsum + alguns créditos. O tom deve combinar com o tipo da obra (livro → encadernação / fonte → tipografia / objeto → natureza-morta / exposição → visual da exposição).
Dois modos de execução
Modo A · Claude Code / Local (com sistema de arquivos)
- Use
Bashpara listar pastas,sipspara ver largura/altura de cada imagem - Saída:
~/Desktop/{slug}-portfolio.html(arquivo único, todas as imagens via URL) - Se o usuário deu imagens locais: copie para
~/Desktop/{slug}-portfolio-images/e alteresrcpara caminho relativo
Modo B · GLM / Chat online (sem sistema de arquivos)
- Quando o usuário arrasta um zip, ao descompactar você vê 4 arquivos
- Gere apenas uma string HTML completa, dentro de um bloco de código
```html - Se o usuário enviou imagens mas não deu URLs → use todas
https://picsum.photos/id/{id}/{w}/{h}como placeholder (use IDs que existem) - Não tente acessar arquivos locais, não sugira comandos de terminal
Critério: se você não consegue ler imagens locais → siga o Modo B.
Divisão dos arquivos
| Arquivo | Função | Como usar |
|---|---|---|
reference.html | Exemplo completo final — Casa Branca BAIWU com 6 obras | Veja: tom dos itens da lista, tom da prosa, vocabulário das especificações, densidade dos campos JSON |
template.html | Esqueleto vazio — mesmo sistema CSS/JS/rotas, com 2 exemplos + 20 marcadores SWAP | Modifique a partir dele, gere o HTML final |
README.md | Instruções para o usuário | O modelo não precisa ler |
SKILL.md | Fluxo de trabalho para o modelo (este arquivo) | Leitura obrigatória |
Regra principal: todas as alterações baseadas no template.html; aprenda como escrever com o reference.html (tom, número de palavras, vocabulário das tags), mas não copie o conteúdo específico.
Passos do trabalho
1. Leia os dois HTMLs
- Primeiro leia
reference.htmlpara entender 'como fica completo' (especialmente a densidade dos campos do JSONworks-datae o tom da prosa) - Depois leia
template.htmlpara encontrar os 20 pontos SWAP
Não altere JS / não altere CSS / não altere o sistema de roteamento das páginas de detalhe / não altere a importação da fonte. Os SWAP 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 chinês do estúdio (ideal 2-4 caracteres, como '白屋', '素园', '墨记', '青庐', '拙轩')
- PINYIN — Pinyin (5-6 letras maiúsculas: BAIWU / SUYUAN / MOJI)
- CHAR — Caractere único para o logo (geralmente o primeiro caractere do nome do estúdio: 白 / 素 / 墨 / 青 / 拙)
- CITY — Cidade
- DIRECTOR_ZH / DIRECTOR_EN — Nome do diretor + pinyin
- DISCIPLINE — 3 palavras da área ('Encadernação · Tipografia · Natureza-morta')
- TAGLINE — Uma frase de posicionamento (20-40 caracteres, tom de escrita cursiva)
- YEAR_FOUNDED — Ano de fundação (pode usar o ciclo sexagesimal: 乙未冬 / 甲辰春)
Para cada obra:
- slug — ID da URL, letras minúsculas em inglês com hífen (
kong-shan-ji/wu-ming-shu) - title_zh — Título em chinês (ideal 2-5 caracteres, quanto mais conciso, mais elegante)
- title_en — Subtítulo em inglês (estilo de título de livro:
An Anthology of Empty Mountains) - year — Ano ou ano no ciclo sexagesimal (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Categoria no topo, entre colchetes, ex:
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL da imagem grande da página de detalhe
- location da linha da lista —
Cidade, ano · Processo/Especificações(aparece ao passar o mouse) - meta — 4 pares chave-valor (resumo em 4 colunas na página de detalhe)
- lead — 30-70 caracteres de abertura em letras grandes, pode usar
<em>palavra-chave</em>para destacar um ponto - 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/fonte/tiragem/impressão/processo/preço, etc.)
- gallery — 3-6 imagens, layout de três opções:
g-wide/g-half/g-third - credits — 4-7 pares de cargo/nome
Se o usuário deu apenas uma frase / não deu histórias → invente você mesmo: de acordo com o título e tipo da obra, escreva um lead e prosa que combinem com o tom. Consulte o reference.html para o tom — nada de linguagem de marketing, algo como 'texto de parede de museu + caderno de estúdio' (contido, específico, lento, com vestígios de artesanato).
3. Liste as obras e verifique tamanhos (apenas Modo A)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{arquivo}" 2>/dev/null
Obtenha (filename, w, h, aspect) para cada imagem. Priorize imagens verticais como thumbnail da lista (contêiner 4:3, imagens verticais ficam melhores).
4. Substitua os 20 SWAP
| SWAP | Localização | Conteúdo |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — Portfolio {DIRECTOR} / Studio |
| 2 | meta description | Uma frase de descrição do site |
| 3 | caractere da cortina | Primeiro caractere do nome do estúdio (ex: '白') |
| 4 | caractere dentro do SVG do logo | Mesmo SWAP-3 |
| 5 | pinyin dentro do SVG do logo | {PINYIN} maiúsculo |
| 6 | item de navegação principal li | Geralmente 3 itens: Obras / Sobre / Contato |
| 7 | brand-block nome chinês | {ATELIER_NAME} com espaços entre caracteres (ex: 白 屋) |
| 8 | brand-block inglês | {PINYIN} Studio · {CITY} |
| 9 | tagline | Uma frase de posicionamento em estilo cursivo, 20-40 caracteres, pode usar <br> para quebra de linha |
| 10 | Itens da lista N | Cada um <a class="item" href="#work/{slug}"> contendo num/project-name/en-name/location/photo-thumb |
| 11 | Itens da galeria N | Mesmas N obras, grade mais compacta — slug deve ser igual ao da lista |
| 12 | Título Sobre | 关 于 {name}<span class="en">About</span> |
| 13 | Parágrafos Sobre | 1-3 parágrafos em estilo cursivo (contexto de fundação / diretor / visão de design), cada um com 60-120 caracteres |
| 14 | Tabela de fatos Sobre | 4-6 itens li (Fundada/Localização/Disciplina/Diretor/Horário) |
| 15 | Título Contato | 来 信<span class="en">Get in Touch</span> |
| 16 | Parágrafos Contato | 1-2 parágrafos convidando a escrever + compromisso de prazo de resposta |
| 17 | Tabela de fatos Contato | 4-6 itens (E-mail/Telefone/Endereço/Instagram/WeChat) |
| 18 | rotating credit | Site by {QUEM} (geralmente o nome do estúdio) |
| 19 | Rodapé três blocos | © / ICP / Links sociais |
| 20 | JSON works-data | Dados completos de N obras (crucial!) |
5. Escreva o JSON works-data (passo mais importante)
Cada obra deve ter uma entrada no array JSON, o slug deve ser exatamente igual ao href #work/SLUG dos cards da lista/galeria.
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": "Tipo / 类型", "value": "Encadernação de Poesia"},
{"label": "Ano / 年份", "value": "2024"},
{"label": "Tiragem / 印量", "value": "Primeira tiragem 320 exemplares"},
{"label": "Formato / 开本", "value": "130 × 195 mm"}
],
"lead": "Trinta e seis poemas sobre montanhas. Queríamos fazer um livro que, ao ser aberto, o leitor ouvisse primeiro o <em>som do vento</em>, e depois lesse as palavras.",
"prose": [
"Parágrafo um: origem dos poemas / contexto do design. 80—150 caracteres.",
"Parágrafo dois: decisões-chave na produção — escolha da fonte, papel, encadernação.",
"Parágrafo três: apresentação final / sensação deixada para o leitor."
],
"specs": [
["Formato / Format", "130 × 195 mm"],
["Páginas / Pages", "144 páginas"],
["Papel / Paper", "Papel de algodão natural 90gsm"],
["Encadernação / Binding", "Costura quatro furos"],
["Fonte / Typeface", "Song Antiga (título) · Cursiva (corpo)"],
["Impressão / Printing", "Relevo monocromático"],
["Tiragem / Edition", "Primeira tiragem 320 exemplares"],
["Preço / Price", "¥ 388"]
],
"gallery": [
{"src": "...", "layout": "g-wide", "caption": "Capa"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"}
],
"credits": [
["Design / Design", "Zhou Moba"],
["Encadernação Manual / Binding", "Chen Shushi (Hangzhou · Oficina de Livros)"]
]
}
Erros comuns no JSON ⚠️ :
- No texto chinês da prosa, use aspas → use sempre aspas cheias
「...」ou"..."(U+201C / U+201D), não use ASCII"(quebra o JSON) - Não coloque quebras de linha literais em strings JSON; para separar parágrafos, adicione mais um item no array
prose - Tags
<em>palavra</em>no lead escreva diretamente como HTML — na renderização, será interpretado como innerHTML - O
layoutda galeria deve ser um dos três:g-wide(ocupa todo o espaço) /g-half(ocupa metade) /g-third(ocupa 1/3)
6. Escolha da fonte de imagens
- Placeholder picsum: use a forma
id/Xem vez deseed/X(mais estável). IDs bons conhecidos: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200 - Use IDs próximos para cover / galeria da mesma obra, criando um tom de cor consistente
- Não use o parâmetro
?grayscale(o usuário quer imagens coloridas)
7. Inspiração para nomes de estúdios chineses (se o usuário não der)
Se o usuário disser "invente um" → escolha 2 caracteres + com ar antigo:
- Nomes de objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Nomes de caracteres de caligrafia: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Evite palavras funcionais como "工作室 / 设计 / Studio", deixe o nome ser um poema em si
8. Suporte a vídeo
Se o cover da obra for .mp4 / .webm / .mov, a página de detalhe usará automaticamente <video autoplay muted loop> no lugar de <img>. O modelo só precisa colocar o caminho do vídeo na URL do cover.
9. Relatório
Modo A: Uma frase de relatório.
Gerado ~/Desktop/baiwu-portfolio.html — 6 obras, passe o mouse sobre as linhas para ver miniaturas, clique para entrar na página de detalhe. Light/Dark no canto inferior esquerdo, lista/álbum no topo centralizado.
Modo B: Dê diretamente o bloco de código HTML completo + uma linha de instrução.
Salve o código acima como
index.htmle clique duas vezes para abrir. Passe o mouse sobre qualquer nome de obra para ver a miniatura aparecer à direita, clique para ir à página de detalhe. Para trocar imagens, substitua a URL picsum pela URL da sua imagem.
Obrigatório manter (não alterar)
- Importação da fonte:
@font-facecarregando a URL woff2 da Alimama DaoLiTi (não mude a origem da fonte) - Sistema de variáveis CSS: temas light/dark duplos
- Todo o JS: alternância de tema, alternância de modo de visualização, interação de hover nas linhas, rotating credit, roteamento hash da página de detalhe
applyRoute(),renderDetail() - O nó
<script id="works-data">deve permanecer <main id="detail-root">deve permanecer (ponto de montagem da página de detalhe)- Sistema de estado
body[data-view="home/detail"]ebody[data-mode="list/gallery"] - Cinco elementos de posição fixa: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Verificação rápida de erros
- Slug não corresponde: item da lista
#work/kong-shan-ji↔ item da galeria#work/kong-shan-ji↔ JSON"slug": "kong-shan-ji"— três lugares devem ser exatamente iguais - Aspas no JSON: as aspas no texto chinês devem ser sempre cheias 「」 ou
"...", nunca ASCII" - Galeria grande demais: no máximo 6 imagens por obra, acima disso a formatação quebra
- Prosa longa demais: cada parágrafo 80-150 caracteres, acima de 200 caracteres a experiência de leitura piora
- Lista / galeria fora de sincronia: devem conter exatamente as mesmas obras (correspondência um a um)
- Picsum seed: use
id/X, nãoseed/X, para evitar que IDs aleatórios acessem imagens já removidas - Menos de 3 obras: tudo bem, funciona com no mínimo 2
- Mais de 8 obras: sugira dividir em duas levas, muitas linhas de lista deixam a página muito longa
- Primeira letra grande: na página de detalhe,
.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 inglês) - Removeu o colorido das picsum: as imagens devem permanecer coloridas, não adicione
filter: grayscale()no CSS