portfolio-detail — Estúdio Chinês / Portfólio de Caligrafia (com Página de Detalhe Secundária)
Característica em Uma Frase
Linhas de texto horizontal + hover revela imagem grande à direita + fonte artística "Alimama DaoLiTi" em caracteres grandes + preto e branco puro + tema claro/escuro + página de detalhe com roteamento hash + visualização em lista/álbum dupla.
Diferenças de Outras Skills de Portfólio
| skill | Modo Principal | Ideal para |
|---|---|---|
portfolio-gen | Tela infinita de arrastar + tiles lado a lado | Fotógrafos / Designers gráficos mostrarem amostras |
portfolio-museum-gen | Hero carrossel + cards grandes + waterfall flow + página de detalhe (sensação curatorial de imagem/vídeo) | Artistas de vídeo/imagem/instalação |
industrial-archive-gen | Capa de virada com moldura preta + barra lateral de arquivo + industrial nórdico | Produtos físicos / utensílios / hardware |
lishu-portfolio-gen | Linhas de texto horizontal + hover mostra miniatura à direita + caracteres grandes em lishu + contido chinês | Encadernação / Tipografia / Exposição / Natureza-morta / Ervas chinesas / Chá / Cerâmica / Madeira / Papel / Incenso |
Se o projeto do usuário for sobre "livro / tipografia / exposição / natureza-morta / ervas chinesas / chá / cerâmica / madeira / papel / incenso" e precisar de uma atmosfera contida e elegante — use esta skill.
Quando Ativar
Quando o usuário disser:
- "Crie um portfólio de estilo chinês / oriental / clássico"
- "Faça um site de estilo lishu / página inicial de estúdio"
- "Crie um portfólio estilo casa branca" / "Faça um site de lista horizontal como o Gurgel D'Alfonso"
- "lishu-portfolio-gen ..."
E fornecer:
- 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 → deve perguntar pelo menos quais obras serão exibidas. Se o usuário der apenas títulos, sem detalhes → escreva você mesmo: para cada obra, gere 1 lead + 3 parágrafos de prosa + 6-8 linhas de specs + 3-6 imagens do picsum + alguns créditos. O tom deve combinar com o tipo de obra (livro → encadernação / letra → tipografia / objeto → natureza-morta / exposição → visual de exposição).
Dois Modos de Operação
Modo A · Claude Code / Local (com sistema de arquivos)
- Use
Bashpara listar pastas,sipspara obter largura/altura de cada imagem - Saída em:
~/Desktop/{slug}-portfolio.html(arquivo único, todas as imagens por URL) - Se o usuário forneceu imagens locais: copie para
~/Desktop/{slug}-portfolio-images/e altere src para caminho relativo
Modo B · GLM / Chat Online (sem sistema de arquivos)
- Após descompactar o zip enviado pelo usuário, você verá 4 arquivos
- Retorne apenas uma string HTML completa, dentro de um bloco de código
```html - Se o usuário enviar imagens mas sem URL → use
https://picsum.photos/id/{id}/{w}/{h}como placeholder (com IDs existentes) - Não tente acessar arquivos locais, não sugira comandos de terminal
Regra: se você não conseguir Ler imagens locais → assume Modo B.
Divisão de Arquivos
| Arquivo | Função | Como Usar |
|---|---|---|
reference.html | Exemplo completo finalizado — BAIWU com 6 obras | Veja: redação dos itens da lista, tom da prosa, vocabulário das specs, densidade dos campos JSON |
template.html | Estrutura vazia — Mesmo sistema CSS/JS/routing, 2 exemplos + 20 marcas SWAP | Modifique-o para gerar 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 do reference.html (tom, número de palavras, uso de tags), mas não copie o conteúdo específico.
Etapas de Trabalho
1. Leia os Dois HTMLs
- Primeiro, leia
reference.htmlpara entender "como fica depois de pronto" (especialmente a densidade dos campos JSON emworks-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 da página 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 (2-4 caracteres ideal, e.g. "白屋", "素园", "墨记", "青庐", "拙轩")
- PINYIN — Romanização (5-6 letras maiúsculas: BAIWU / SUYUAN / MOJI)
- CHAR — Caractere único para o logotipo (geralmente o primeiro caractere do nome: 白 / 素 / 墨 / 青 / 拙)
- CITY — Cidade
- DIRECTOR_ZH / DIRECTOR_EN — Nome do diretor + romanização
- DISCIPLINE — 3 palavras de disciplina ("Encadernação · Tipografia · Natureza-morta")
- TAGLINE — Frase de posicionamento em uma linha (20-40 caracteres, tom de letra cursiva)
- YEAR_FOUNDED — Ano de fundação (pode usar ciclo sexagenário: 乙未冬 / 甲辰春)
Para cada obra, extraia:
- slug — ID da URL, em minúsculas com hífen (
kong-shan-ji/wu-ming-shu) - title_zh — Título em chinês (2-5 caracteres ideal, 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 do ciclo ("甲辰 / 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 em 4 colunas na página de detalhe)
- lead — Texto grande de abertura com 30-70 caracteres, pode usar
<em>palavra-chave</em>para enfatizar um ponto - prose — 3-4 parágrafos de prosa, cada um com 80-150 caracteres
- specs — 6-10 linhas de tabela de especificações (formato/papel/encadernação/tipografia/tiragem/impressão/técnica/preço etc.)
- gallery — 3-6 imagens, layout com três opções:
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: com base no título e tipo da obra, escreva lead e prosa que combinem com o tom da obra. Consulte o tom do reference.html — sem linguagem de marketing, com sensação de "texto de parede de museu + caderno de ateliê" (contido, concreto, lento, com marcas de artesanato).
3. Liste as Obras e Obtenha Dimensões (Apenas Modo A)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
Obtenha (filename, w, h, aspect) de cada imagem. Priorize imagens verticais como miniaturas da lista (container 4:3, verticais ficam melhores).
4. Substitua os 20 SWAPs
| SWAP | Local | Conteúdo |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — Portfólio de {DIRECTOR} / Studio |
| 2 | meta description | Uma frase de descrição do site |
| 3 | Caractere único da cortina | Primeiro caractere do nome do estúdio (ex.: "白") |
| 4 | Caractere único dentro do logotipo SVG | Mesmo que SWAP-3 |
| 5 | Romanização dentro do logotipo SVG | {PINYIN} maiúsculo |
| 6 | li do menu principal | Geralmente 3 itens: Obras / Sobre / Contato |
| 7 | Nome chinês do bloco de marca | {ATELIER_NAME} com espaços entre caracteres (ex.: 白 屋) |
| 8 | Inglês do bloco de marca | {PINYIN} Studio · {CITY} |
| 9 | tagline | Frase de posicionamento em letra cursiva, 20-40 caracteres, pode usar <br> para quebrar 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 | As mesmas N obras, 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 letra cursiva (história de fundação / diretor / filosofia de design), cada um com 60-120 caracteres |
| 14 | Tabela de fatos "Sobre" | 4-6 itens li (Fundado/Local/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 + promessa de prazo de resposta |
| 17 | Tabela de fatos "Contato" | 4-6 itens (E-mail/Telefone/Endereço/Instagram/WeChat Official Account) |
| 18 | crédito rotativo | Site by {WHO} (geralmente o nome do estúdio) |
| 19 | Três blocos do rodapé | © / ICP / Links sociais |
| 20 | JSON works-data | Dados completos de detalhes das N obras (crucial!) |
5. Escreva o JSON works-data (Passo Mais Crucial)
Cada obra deve ter uma entrada no array JSON, o slug deve ser exatamente igual ao href #work/SLUG nos 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": "Type / 类型", "value": "诗集装帧"},
{"label": "Year / 年份", "value": "2024"},
{"label": "Edition / 印量", "value": "首印 320 本"},
{"label": "Format / 开本", "value": "130 × 195 毫米"}
],
"lead": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见<em>风声</em>,再读见字的书。",
"prose": [
"Parágrafo 1: Origem dos poemas / contexto do design. 80—150 caracteres.",
"Parágrafo 2: Decisões-chave durante a produção — tipografia, papel, escolha de encadernação.",
"Parágrafo 3: Resultado final / sensação deixada ao leitor."
],
"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 em JSON ⚠️:
- Na prosa em chinês, use aspas → deve usar
「...」ou\"...\"(U+201C / U+201D) não use ASCII"(quebra o JSON) - Não coloque quebras de linha literais dentro das strings JSON; para mudar de parágrafo, adicione mais um item no array prose
<em>palavra</em>no lead é HTML literal — será renderizado como innerHTML- O
layoutda galeria deve ser um dos três:g-wide(ocupar toda a largura) /g-half(metade) /g-third(1/3)
6. Escolha da Fonte de Imagens
- Placeholder picsum: use o formato
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 - Para cover/galeria da mesma obra, use IDs próximos — isso cria um tom de cor 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 com estilo antigo:
- Nomes de objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Nomes de letras/linhas: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Evite palavras funcionais como "工作室 / design / Studio", deixe o próprio nome ser um poema
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> em vez de <img>. O modelo só precisa fornecer o caminho do vídeo na URL do cover.
9. Relatório
Modo A: relatório de uma frase.
Gerado ~/Desktop/baiwu-portfolio.html — 6 obras, passe o mouse nas 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 conteúdo acima como
index.htmle clique duas vezes para abrir. Passe o mouse sobre qualquer nome de obra para ver a miniatura que aparece à direita, clique para ir à página de detalhe. Para trocar as imagens, substitua as URLs do picsum pelos endereços das suas imagens.
Itens Obrigatórios (Não Alterar)
- Importação da fonte:
@font-facecarregando a URL woff2 do "Alimama DaoLiTi" (não mude a fonte) - Sistema de variáveis CSS: tema claro/escuro
- Todo o JS: alternador de tema, alternador de modo de visualização, interação hover-row, crédito rotativo, roteamento hash da página de detalhe
applyRoute(),renderDetail() - O nó
<script id="works-data">deve permanecer - O nó
<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 posicionamento fixo:
#logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Verificação Rápida de Erros Comuns
- Slug incompatível: 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: aspas no conteúdo chinês devem ser
「」ou"...", não ASCII" - Galeria excessiva: no máximo 6 imagens por obra, mais que isso quebra o layout
- Prosa muito longa: cada parágrafo com 80-150 caracteres, acima de 200 reduz a experiência de leitura
- Lista/galeria dessincronizadas: devem conter o mesmo conjunto de obras (correspondência um a um)
- Seed do picsum: use
id/Xnãoseed/X, para evitar que IDs aleatórios caiam em imagens removidas - Menos de 3 obras: pode, mínimo de 2 funciona
- Mais de 8 obras: sugira dividir em dois lotes, muitas linhas na lista deixam a página longa
- Primeira letra capitular: o
.detail__prose p:first-of-type::first-letterna página de detalhe usa a fonte lishu — o primeiro parágrafo deve começar com chinês (não com<em>ou inglês) - Removeu cor do picsum: as imagens devem permanecer coloridas; não adicione
filter: grayscale()no CSS