Xu-125/portfolio-collection-skill

Portfolio Collection / Criação e Manutenção de Coleções de Portfólio

Transforme trabalhos dispersos em uma coleção navegável; mantenha sua fonte de dados real sustentável.

1. Confirmar escopo / Confirmar limites

Classifique a solicitação como discussão de design, construção, atualização incremental, reparo ou agendamento. Não implemente durante uma solicitação apenas de discussão.

Inspecione links/arquivos fornecidos e artefatos existentes antes de perguntar. Confirme apenas incógnitas materiais, de preferência em um lote de até três perguntas:

• Nome da coleção, público e fontes autorizadas; distinga links públicos, documentos-fonte privados e uploads do usuário.
• Aplicação/fonte de dados existente versus nova construção; manutenção compartilhada, campos editáveis necessários e modelo de acesso.
• Categorias, referência visual e comportamento exigido de título/capa. Para trabalhos recorrentes, obtenha frequência, horário local exato, fuso horário e destino da atualização separadamente.

Use o estilo do projeto existente e a pilha escolhida. Para uma nova coleção sem referência, proponha um layout contido e focado em conteúdo antes de uma implementação custosa. Nunca imponha uma marca específica, plataforma, taxonomia de seis categorias ou cronograma diário.

2. Roteamento por capacidades disponíveis / Executar conforme capacidades

Descubra e leia as habilidades relevantes do host antes de usar suas ferramentas.

• Use Navegador por padrão para coleta de sites/feeds: observe → navegue → inspecione postagem → registre evidências. Leia os esquemas de ferramentas exatos; nunca adivinhe nomes de conectores ou sinalizadores.
• Use um conector autenticado aprovado pelo host para documentos/mensagens privados. Pesquise histórico privado apenas quando explicitamente solicitado ou necessário dentro do escopo autorizado do usuário.
• Use o construtor de aplicativos web do host para aplicações interativas. Uma coleção compartilhada precisa de persistência compartilhada e autorização no lado do servidor; armazenamento local não é substituto.
• Uma vitrine estática única pode usar a habilidade HTML do host. Explique sua falta de edição compartilhada ou coleta automática.
• Use a habilidade de planilha/banco de dados do host quando a fonte escolhida for uma planilha, Base ou banco de dados.
• Use o escalonador do host apenas após aprovação do agendamento e configuração bem-sucedida. Um prompt escrito não é uma tarefa agendada.

Se as capacidades não estiverem disponíveis, termine o trabalho independente e identifique a capacidade exata que falta. Não substitua silenciosamente um aplicativo compartilhado por uma demonstração local. Este pacote é um fluxo de trabalho de agente, não um aplicativo independente ou rastreador.

3. Coletar e reconciliar / Coleta, verificação e desduplicação

Para construção/atualização/reparo, leia referências/data-and-maintenance.md.

1. Releia a fonte de dados real atual e tire um instantâneo dos registros existentes antes de qualquer alteração. Localize o caminho real de leitura/gravação, não uma tabela não utilizada ou cópia da fonte.
2. Use um link de fonte exato fornecido pelo usuário ou identidade de conta oficial verificada. Não substitua outra conta, repostagem ou resultado de pesquisa genérico pela fonte solicitada.
3. Registre a URL original textualmente, título verdadeiro, capa verificada, tipo de mídia, data real se disponível, categorias e evidências. Mantenha campos incertos marcados como desconhecidos.
4. Obtenha capas de artigos a partir dos metadados de capa/compartilhamento do artigo, não de um avatar, imagem corporal decorativa ou captura de tela. Use capas de vídeo reais da plataforma; use um quadro de vídeo apenas se autorizado como alternativa. Salve ativos duráveis e preserve a proveniência.
5. Corresponda o título de exibição de uma entrada à política acordada. Padrão para artigos: títulos originais textuais. Rótulos de vídeos curtos podem resumir texto verificado da fonte apenas quando permitido; mantenha o original e o rótulo curto separadamente. Nunca chame uma descrição de transcrição de áudio.
6. Desduplique por identidade de fonte verificada e, em seguida, reconcilie manualmente versões multiplataforma corroboradas da mesma obra. Armazene várias fontes/categorias em uma entrada, não em cartões duplicados.
7. Encontre originais privados apenas quando solicitado; leia o conteúdo candidato para distinguir rascunhos finais de briefings, cronogramas ou esboços de entrevistas. Preserve as permissões originais do documento.
8. Aplique apenas alterações de campo autorizadas, proteja edições manuais e verifique o resultado armazenado. Se uma gravação expirar, inspecione o estado real antes de tentar novamente.

4. Apresentar a coleção / Exibir a coleção

Para trabalho de interface, leia referências/presentation-and-access.md.

• Use capas autênticas, um campo de busca claro e as categorias aprovadas pelo usuário. Separe filtros de formato de mídia de categorias de tópico.
• Deixe cada cartão ter sua altura natural. Para mídia mista horizontal/vertical, use alvenaria de coluna mais curta genuína ou um layout verificado equivalente. Não estique um cartão de artigo curto para um cartão de vídeo alto.
• Derive proporções do brief ou dos ativos originais. Recomendação opcional: 2.35:1 para artigos largos e 3:4 para vídeos em retrato; não é um invariante para todos os projetos.
• Mantenha um título conciso e ações necessárias. Não adicione resumos, datas, métricas ou selos que o usuário não solicitou.
• Faça com que cliques no corpo do cartão abram a URL pública do trabalho. Um botão separado para original privado abre o documento fonte; nem esse botão nem controles de curtir devem acionar o link do corpo do cartão.
• Aplique a ordenação confirmada; se uma categoria for priorizada, classifique esse grupo e o restante por datas reais de forma independente. Não fabrique datas ou redefina datas antigas para parecerem recentes.
• Ofereça uma entrada simples de manutenção do proprietário baseada na mesma fonte de dados. Mostre títulos reconhecíveis e apenas os campos editáveis escolhidos.

5. Isolar uso público e administração privada / Separar administração e uso público

Exija uma identidade de proprietário verificada pelo servidor para todas as leituras/gravações administrativas. Um botão oculto ou qualquer conta logada não é autorização. Mantenha a identidade/configuração do proprietário fora dos clientes públicos. Leitores anônimos recebem apenas campos públicos publicados; mantenha dados de contato e conteúdo de documentos privados fora das respostas públicas. Consulte os testes de acesso na referência de apresentação.

Publicação, visibilidade na internet e código do aplicativo são camadas separadas. Pergunte pelo escopo preciso antes de habilitar o compartilhamento público. Nunca abra permissões de um original privado simplesmente porque a coleção é pública. Use o caminho de implantação autorizado pelo host; se a publicação precisar ser feita pelo usuário, leve-o à entrada de desenvolvimento/publicação verificada e pare antes dessa ação.

6. Agendar manutenção incremental / Manutenção regular

Para agendamento, leia referências/recurring-update.md. Confirme o cronograma e o destino, resolva tarefas existentes para evitar duplicatas e use o escalonador real. Mantenha a identidade da coleção, fontes de conta, janela de sobreposição, campos protegidos e comportamento de falha/relatório nas instruções da tarefa. Registre pontos de verificação bem-sucedidos apenas após gravações verificadas. Relate fontes não suportadas ou bloqueadas por autenticação em vez de ignorá-las silenciosamente.

7. Verificar e entregar / Verificar e entregar

Leia referências/verification.md antes de declarar a conclusão. O verificador local opcional é:

python3 scripts/validate_manifest.py path/to/manifest.json
python3 scripts/validate_manifest.py path/to/after.json --baseline path/to/before.json --allow-update cover,original_urls --require-cover-proof

Esses comandos realizam apenas verificações de integridade local; eles não buscam páginas, provam que uma imagem ativa carrega, autenticam usuários, gravam em banco de dados ou agendam trabalho. Leia a referência para a forma do manifesto e regras de evidência.

Relate o número real adicionado, candidatos duplicados ignorados, originais vinculados, cobertura real de carregamento de capas, bloqueadores e se a pré-visualização e produção diferem. Verifique cada item reivindicado; identifique verificações apenas por amostragem. Entregue o artefato atual usando o mecanismo de entrega do host. Não reentregue evidências temporárias, logs privados ou segredos.

Prompts opcionais / Prompts reutilizáveis

Use referências/prompts.md para prompts bilíngues de construção/atualização. Preencha apenas valores aprovados pelo usuário; parâmetros materiais não resolvidos exigem esclarecimento, não padrões inventados. Mantenha configuração privada e credenciais fora deste pacote reutilizável.