O que Adicionar Membro do Laboratório faz?
Este skill guia você pelo processo de adicionar um novo membro do laboratório ao site com formatação adequada, redação de biografia e tratamento de imagens.
Quando Usar Este Skill
Use este skill quando:
- "Adicionar um novo membro do laboratório"
- "Criar um perfil para [nome]"
- "Adicionar [nome] à página da equipe"
- "Atualizar a função de [nome]"
- "Marcar [nome] como ex-aluno"
- Qualquer solicitação envolvendo adicionar ou atualizar perfis de membros da equipe
Fluxo de Trabalho Interativo
Passo 1: Reunir Informações Básicas
Pergunte ao usuário os detalhes essenciais:
Obrigatório:
- Nome completo
- Função (coordenador, pós-doutorando, funcionário, doutorando, mestrando, assistente de pesquisa, programador, graduando, ensino médio)
Opcional (pesquisaremos se não for fornecido):
- Endereço de e-mail
- Nome de usuário do GitHub
- Perfil do LinkedIn
- Site pessoal
- Instituição/programa atual (se estudante)
Use AskUserQuestion para coletar essas informações se não forem fornecidas na solicitação inicial.
Passo 2: Pesquisa na Web
Realize pesquisa na web para reunir informações de fundo:
-
Pesquise no LinkedIn por formação e histórico profissional
- Consulta: "[Nome Completo] LinkedIn [instituição se conhecida]"
- Extraia: diplomas, instituições, cargos anteriores
-
Pesquise no GitHub por nome de usuário e projetos
- Consulta: "[Nome Completo] GitHub [domínio de e-mail se conhecido]"
- Extraia: nome de usuário, repositórios notáveis
-
Pesquise páginas institucionais por informações de biografia
- Consulta: "[Nome Completo] [instituição] neurociência/biologia/ciência da computação"
- Extraia: interesses de pesquisa, trabalho atual
-
Pesquise publicações se aplicável (doutorando/pós-doutorando)
- Consulta: "[Nome Completo] [instituição] publicações"
- Extraia: áreas de pesquisa
Apresente os resultados ao usuário:
- Mostre o que você encontrou
- Pergunte ao usuário para confirmar a precisão
- Peça esclarecimentos sobre algo que não esteja claro
- Solicite qualquer informação crítica ausente
Passo 3: Esboçar Biografia
Usando as informações coletadas e o modelo apropriado para a função:
-
Determine o tamanho da biografia com base na função:
- Coordenador: 250-300 palavras (detalhado)
- Doutorando/Pós-doutorando/Funcionário: 100-150 palavras
- Mestrando/Assistente de Pesquisa/Programador: 80-120 palavras
- Graduando: 80-100 palavras
- Ex-aluno: 50-250 palavras (com base no tempo de serviço e realizações)
-
Siga o modelo de biografia do diretório templates/:
- Use voz em terceira pessoa
- Tom profissional e acadêmico
- Inclua: formação, data de entrada, foco de pesquisa/trabalho atual
- Mencione coorientadores se aplicável
- Destaque experiência anterior se relevante
- Observe prêmios/bolsas se notáveis
-
Apresente o esboço ao usuário:
- Mostre a biografia esboçada
- Pergunte se desejam fazer alguma edição
- Refine com base no feedback
Passo 4: Lidar com a Imagem de Perfil
-
Pergunte ao usuário pela imagem:
- "Você tem uma foto de perfil para [nome]?"
- Se sim: "Por favor, forneça o caminho para o arquivo de imagem"
- Se não: "Podemos usar um placeholder por enquanto e adicioná-lo depois"
-
Se a imagem for fornecida, valide e otimize:
- Verifique o tamanho e as dimensões do arquivo usando
fileousips - Especificações alvo: 100-250 KB, proporção de aspecto razoavelmente quadrada
- Se muito grande (>500 KB) ou proporção de aspecto incorreta:
- Ofereça para redimensionar/otimizar usando scripts/optimize-image.sh
- Use
sips(macOS) ouconvert(ImageMagick) se disponível
- Verifique o tamanho e as dimensões do arquivo usando
-
Gere o nome do arquivo de imagem:
- Formato:
primeiro-nome-ultimo-nome.jpg - Certifique-se de que não haja espaços ou caracteres especiais
- Copie para o diretório
images/com o nome correto
- Formato:
Passo 5: Gerar Arquivo do Membro
-
Crie o nome do arquivo:
_members/primeiro-nome-ultimo-nome.md -
Construa o frontmatter:
--- name: [Nome Completo] image: images/[primeiro-nome-ultimo-nome].jpg role: [função] description: [Texto de exibição da função de roles.yaml] links: email: [e-mail se fornecido] github: [nome de usuário se encontrado/fornecido] linkedin: [perfil se encontrado/fornecido] home-page: [url se fornecido] ---- Inclua apenas links que estão disponíveis
- Remova campos de link vazios
-
Adicione o texto da biografia (do Passo 3)
-
Escreva o arquivo em
_members/primeiro-nome-ultimo-nome.md
Passo 6: Lidar com Ex-alunos (se aplicável)
Se a função for alumni OU o usuário indicar que esta pessoa está saindo:
-
Pergunte pelos detalhes do ex-aluno:
- Ano em que saíram/estão saindo
- Função deles enquanto estavam no laboratório (se diferente da atual)
- Posição "Próximo" (para onde estão indo)
-
Atualize team/index.md:
- Leia a seção atual de ex-alunos
- Adicione entrada em ordem cronológica (mais recente primeiro):
- ANO: [**Nome**](/membros/primeiro-nome-ultimo-nome.html) (Descrição da Função). **Próximo:** [Próxima posição] - Mantenha a formatação adequada
Passo 7: Validar
Execute verificações de validação:
- O arquivo do membro existe em
_members/primeiro-nome-ultimo-nome.md - O frontmatter YAML é válido
- A função é válida (verifique em roles.yaml)
- O arquivo de imagem existe (ou foi anotado como placeholder)
- A biografia tem tamanho apropriado para a função
- A biografia usa voz em terceira pessoa
- Os links estão formatados corretamente
- Se ex-aluno: team/index.md foi atualizado
Passo 8: Apresentar Resumo
Mostre ao usuário o que foi criado:
✓ Perfil do membro criado para [Nome]
✓ Arquivo: _members/primeiro-nome-ultimo-nome.md
✓ Função: [texto de exibição da função]
✓ Imagem: images/primeiro-nome-ultimo-nome.jpg [ou "Placeholder - adicione depois"]
✓ Links: [lista de links incluídos]
[✓ Lista de ex-alunos atualizada] [se aplicável]
Prévia da biografia:
[Primeiros 100 caracteres da biografia]...
Gostaria que eu mostrasse o conteúdo completo do arquivo?
Passo 9: Commit Opcional
Pergunte ao usuário se deseja commitar as alterações:
- Se sim: Crie um commit git com mensagem apropriada
- Se não: Deixe como alterações não preparadas para revisão manual
Diretrizes de Redação da Biografia
Voz e Tom
- Sempre em terceira pessoa: "João é um estudante de doutorado..." (não "Eu sou...")
- Profissional e acadêmico: Formal mas não rebuscado
- Focado em fatos e realizações: Concentre-se em credenciais e trabalho
- Tempo presente para trabalho atual: "trabalhando em", "desenvolvendo", "pesquisando"
- Tempo passado para histórico: "recebeu", "trabalhou", "entrou"
Elementos Essenciais
Todos os membros devem incluir:
- Função e instituição atuais
- Quando entraram (mês e ano)
- Histórico educacional (grau, curso, instituição)
- Foco atual de pesquisa/trabalho
Elementos adicionais por função:
Coordenador:
- Instituição do doutorado e orientadores (com hyperlinks)
- Filosofia e abordagem de pesquisa
- Publicações notáveis ou cobertura da mídia
- Cargos anteriores
- Principais prêmios e honrarias
Doutorando/Pós-doutorando:
- Instituição de graduação e/ou mestrado
- Interesses específicos de pesquisa
- Coorientadores se aplicável
- Experiência de pesquisa anterior se notável
Funcionário/Programador:
- Experiência de trabalho anterior (indústria ou academia)
- Experiência técnica e áreas de foco
- Projetos em que estão trabalhando
- Nomeações conjuntas se aplicável
Estudantes (Mestrado/Graduação):
- Curso e ano
- Interesses de pesquisa
- Estágios anteriores ou pesquisa se aplicável
- Prêmios/bolsas se notáveis
Ex-alunos:
- Tudo acima com base em sua função
- Mentores (especialmente para estagiários de curto prazo)
- Realizações durante o tempo no laboratório
- Mantenha conciso para estagiários de verão (50-80 palavras)
O que Evitar
- Narrativa em primeira pessoa (exceto possivelmente introdução do coordenador)
- Detalhes excessivos sobre projetos (mantenha em 1-2 frases)
- Tempo futuro ou especulação
- Linguagem casual ou gíria
- Informações pessoais não relacionadas à pesquisa
- Redundância com o frontmatter (nome, função já mostrados)
Detalhes de Tratamento de Imagens
Especificações Preferidas
- Formato: JPG (preferido) ou PNG
- Tamanho: 100-250 KB para otimização web
- Proporção de aspecto: Quadrada ou quase quadrada (1:1 ou 4:5)
- Dimensões mínimas: 300x300 pixels
- Recomendado: 400x400 a 600x600 pixels
- Cor: Espaço de cores RGB
Processo de Otimização
Se a imagem precisar de otimização:
# Use o script incluído
bash .claude/skills/add-member/scripts/optimize-image.sh entrada.jpg saida.jpg 500
Ou manualmente com sips (macOS):
# Redimensionar para dimensão máxima de 500px, mantendo a proporção
sips -Z 500 entrada.jpg --out saida.jpg
# Converter PNG para JPG
sips -s format jpeg entrada.png --out saida.jpg
Ou com ImageMagick:
# Redimensionar e otimizar
convert entrada.jpg -resize 500x500^ -quality 85 saida.jpg
Convenção de Nomes de Arquivo
- Use kebab-case:
primeiro-nome-ultimo-nome.jpg - Sem espaços, caracteres especiais ou maiúsculas
- Corresponda ao slug do arquivo do membro
- Exemplos:
joao-silva.jpg,maria-santos.jpg
Notas Específicas por Função
Adicionando Ex-alunos
Ao adicionar alguém que já saiu:
- Defina
role: alumnino frontmatter - Inclua a função real no texto da biografia
- Atualize a seção de ex-alunos em
team/index.mdcom:- Ano em que saíram
- Descrição da função entre parênteses
- Anotação "Próximo:" se conhecido
Lidando com Coorientadores
Quando o membro tem coorientador:
- Mencione na biografia: "coorientado por [Nome]"
- Inclua hyperlink se possível:
[Nome](url) - Anote no resumo ao apresentar ao usuário
Nomeações Conjuntas
Quando o membro tem afiliação conjunta:
- Mencione na biografia: "conjuntamente com o [Nome do Laboratório]"
- Inclua hyperlink para o outro laboratório se disponível
- Anote claramente os coordenadores colaboradores
Estudantes em Transição de Função
Quando um estudante passa de graduação → mestrado → doutorado:
- Criar novo arquivo de membro? Não - mantenha o mesmo arquivo
- Atualize o campo
role:no frontmatter - Atualize a biografia para refletir o novo status
- Atualize o campo
description: - Considere adicionar uma nota sobre a transição na biografia
Estagiários de Verão
Membros de curto prazo (2-3 meses):
- Enquanto ativo: Adicione com função
undergradouhighschool - Quando saindo: Mude para
role: alumni - Biografia: Pode ser breve (50-80 palavras), mas destaque:
- Instituição e programa
- Em que trabalharam
- Quem os orientou
- Quaisquer realizações notáveis
Tratamento de Erros
Se a pesquisa na web não encontrar nada:
- Peça ao usuário para fornecer informações diretamente
- Ofereça-se para esboçar uma biografia mínima e deixe-os expandir
Se a imagem estiver no formato/tamanho errado:
- Ofereça-se para otimizar usando as ferramentas fornecidas
- Se as ferramentas não estiverem disponíveis, forneça instruções manuais
- Pior caso: use um placeholder e anote no resumo
Se não tiver certeza sobre a função:
- Apresente as opções de função de roles.yaml
- Use AskUserQuestion para esclarecer
Se existir membro duplicado:
- Verifique se é uma atualização vs novo membro
- Pergunte ao usuário se deseja atualizar o existente ou criar um novo
Lista de Verificação de Validação
Antes de finalizar, verifique:
- Nome completo corresponde ao nome do arquivo, frontmatter e biografia
- Função é válida (uma de: coordenador, pós-doutorando, funcionário, doutorando, mestrando, assistente de pesquisa, programador, graduando, ensino médio, ex-aluno)
- Nome do arquivo de imagem segue a convenção (kebab-case, .jpg)
- Biografia está em terceira pessoa ao longo de todo o texto
- Tamanho da biografia apropriado para a função (veja as diretrizes)
- Data de entrada mencionada na biografia (mês e ano)
- Histórico educacional incluído
- Todos os links estão formatados corretamente
- Frontmatter YAML é válido (teste com um analisador)
- Se ex-aluno: team/index.md atualizado corretamente
- Sem espaços em branco à direita ou problemas de formatação
Veja Também
- reference.md - Documentação detalhada sobre o formato do arquivo de membro e padrões
- examples.md - Fluxos de trabalho de exemplo para diferentes cenários
- templates/ - Modelos de biografia para cada tipo de função