Aprimorando Perfis de Autores
Esta skill preenche campos ausentes de perfil de autor (bio, avatar, site, redes sociais) por meio de pesquisa web.
Visão Geral do Fluxo de Trabalho
Fase 1: Identificação do Autor
└─ Encontrar e validar o arquivo do autor
Fase 2: Pesquisa Paralela (apenas para campos ausentes)
├─ Agente WebSearch 1: bio/histórico
├─ Agente WebSearch 2: URL do avatar
└─ Agente WebSearch 3: site + redes sociais
Fase 3: Revisão do Usuário (GATE BLOQUEADOR)
└─ Apresentar descobertas, aguardar aprovação
Fase 4: Salvar Autor Aprimorado
└─ Atualizar campos do frontmatter
Fase 5: Verificação de Qualidade
└─ Executar pnpm lint:fix && pnpm typecheck
Fase 1: Identificação do Autor
1.1 Encontrar o Arquivo do Autor
Aceite um slug de autor, nome ou nome parcial como argumento:
- Tente correspondência exata de slug primeiro: Verifique se
content/authors/{slug}.mdexiste (converta espaços em hífens, minúsculas) - Se não houver correspondência exata: Use Grep para pesquisar o nome nos arquivos de autor:
Padrão Grep: "name:.*{termo de pesquisa}" com glob: "content/authors/*.md"
Resultados:
- Uma correspondência → prossiga com esse arquivo
- Múltiplas correspondências → liste opções para o usuário escolher
- Nenhuma correspondência → liste autores disponíveis
1.2 Identificar Campos Ausentes
Leia o arquivo do autor e verifique quais campos estão ausentes ou vazios:
Campos obrigatórios (sempre presentes):
nameslug
Campos opcionais para aprimorar:
bio- Histórico profissional e especializaçãoavatar- URL da foto de perfilwebsite- URL do site pessoalsocials.twitter- Identificador do Twitter/Xsocials.github- Nome de usuário no GitHubsocials.linkedin- Nome de usuário no LinkedInsocials.youtube- Canal do YouTube
Um campo está "ausente" se:
- Não existir no frontmatter
- Existir mas estiver vazio (
""ounull)
Se todos os campos já estiverem preenchidos, informe o usuário e ofereça-se para atualizar campos específicos.
Fase 2: Pesquisa Paralela
Crie até 3 agentes WebSearch em paralelo com base nos campos ausentes:
**Agente 1 - Bio/Histórico:**
Ferramenta Task com subagent_type: "general-purpose"
prompt: "Use WebSearch para encontrar informações de histórico profissional de [Nome do Autor].
Consulta: '[Nome do Autor]' bio histórico especialização
Extraia: Cargo, empresa, áreas de especialização, projetos notáveis.
Retorne: Uma bio profissional de 1 a 2 frases."
**Agente 2 - URL do Avatar:**
Ferramenta Task com subagent_type: "general-purpose"
prompt: "Use WebSearch para encontrar uma URL de foto de perfil para [Nome do Autor].
Consulta: '[Nome do Autor]' site:github.com OR site:twitter.com
Extraia: Nome de usuário do GitHub ou identificador do Twitter para construir a URL do avatar.
Retorne: URL do avatar (prefira formato GitHub: https://github.com/{username}.png)"
**Agente 3 - Site e Redes Sociais:**
Ferramenta Task com subagent_type: "general-purpose"
prompt: "Use WebSearch para encontrar perfis de redes sociais para [Nome do Autor].
Consulta: '[Nome do Autor]' twitter github linkedin youtube
Extraia: Site pessoal, identificador do Twitter, nome de usuário do GitHub, perfil do LinkedIn, canal do YouTube.
Retorne: Lista de perfis encontrados com URLs/identificadores."
Crie apenas agentes para campos ausentes. Se a bio já existir, pule o Agente 1.
Colete todos os resultados via TaskOutput (bloqueante).
Fase 3: Revisão do Usuário (GATE BLOQUEADOR)
Esta é uma etapa de aprovação obrigatória. Apresente as alterações propostas antes de salvar.
3.1 Apresentar Alterações
Exiba as atualizações propostas como uma tabela de comparação:
## Atualizações Propostas para [Nome do Autor]
| Campo | Atual | Proposto |
|-------|-------|----------|
| bio | (vazio) | "Fundador da X, criador da Y..." |
| avatar | (vazio) | "https://github.com/username.png" |
| website | (vazio) | "https://exemplo.com" |
| socials.twitter | (vazio) | "username" |
| socials.github | (vazio) | "username" |
| socials.linkedin | (vazio) | "username" |
| socials.youtube | (vazio) | (não encontrado) |
3.2 Solicitar Aprovação
Use a ferramenta AskUserQuestion:
question: "Salvar essas alterações no perfil do autor?"
header: "Revisão"
multiSelect: false
options:
- label: "Salvar"
description: "Atualizar o arquivo do autor com esses valores"
- label: "Editar"
description: "Diga-me o que alterar"
- label: "Cancelar"
description: "Não modificar o arquivo"
3.3 Lidar com a Resposta
- Salvar: Prossiga para a Fase 4
- Editar: Aplique o feedback do usuário, mostre prévia atualizada
- Cancelar: Saia sem alterações
NÃO prossiga para a Fase 4 sem aprovação explícita do usuário.
Fase 4: Salvar Autor Aprimorado
4.1 Atualizar Frontmatter
Use a ferramenta de Edição para atualizar apenas os campos aprovados:
Antes:
---
name: "João Silva"
slug: "joao-silva"
bio: ""
avatar: ""
website: ""
socials:
twitter: ""
github: ""
linkedin: ""
youtube: ""
---
Depois:
---
name: "João Silva"
slug: "joao-silva"
bio: "Engenheiro de software especializado em sistemas distribuídos..."
avatar: "https://github.com/joaosilva.png"
website: "https://joaosilva.dev"
socials:
twitter: "joaosilva"
github: "joaosilva"
linkedin: "joaosilva"
youtube: ""
---
4.2 Preservar Valores Existentes
Crítico: Nunca sobrescreva valores não vazios existentes, a menos que solicitado explicitamente:
- Mantenha
nameeslugexistentes inalterados - Atualize apenas campos que estavam vazios/ausentes
- Preserve quaisquer campos personalizados adicionais
4.3 Confirmação
Relate ao usuário:
Atualizado: content/authors/{slug}.md
- bio: adicionado
- avatar: adicionado
- website: adicionado
- socials.twitter: adicionado
- socials.github: adicionado
Fase 5: Verificação de Qualidade
Execute o linter e o type check para capturar quaisquer problemas:
pnpm lint:fix && pnpm typecheck
Se forem encontrados erros, corrija-os antes de concluir a tarefa.
Recuperação de Erros
| Erro | Recuperação |
|---|---|
| Autor não encontrado | Liste autores disponíveis em content/authors/ |
| Nenhum campo ausente | Informe o usuário, ofereça-se para atualizar campos específicos |
| WebSearch falha | Tente padrões de consulta alternativos |
| Usuário rejeita alterações | Permita edição ou cancelamento |
| Não foi possível encontrar informação | Marque o campo como "(não encontrado)", prossiga com os outros |
Lista de Verificação de Qualidade
Antes de salvar, verifique:
- O arquivo do autor existe em
content/authors/ - Apenas campos vazios/ausentes estão sendo atualizados
- Bio tem 1 a 2 frases, tom profissional
- URL do avatar é válida (prefira formato GitHub)
- Identificadores de redes sociais são apenas nomes de usuário (sem URLs)
- Valores não vazios existentes preservados
- Usuário aprovou explicitamente as alterações