Criar habilidades de agente a partir da documentação de um projeto e mantê-las atualizadas

## Ver quem mantém uma habilidade antes de editá-la Determine como cada habilidade é administrada antes de criar ou atualizar arquivos. Use habilidades geradas para projetos que publicam documentação, mas não mantêm um pacote de habilidades de agente; habilidades sincronizadas para projetos que já publicam suas próprias habilidades; e habilidades escritas manualmente para conhecimentos especializados selecionados de forma intencional. Não misture esses fluxos de trabalho. Habilidades geradas são sintetizadas a partir da documentação, habilidades sincronizadas são copiadas de sua fonte de habilidades original, e habilidades escritas manualmente permanecem intactas, a menos que a tarefa as inclua explicitamente. ## Pegar da documentação só o que ajuda o agente nas tarefas Concentre-se em capacidades, pontos de decisão, padrões práticos de uso, exemplos funcionais e nas circunstâncias em que um agente deve escolher uma abordagem em vez de outra. Dê preferência ao conhecimento que melhore substancialmente a execução das tarefas. Ignore introduções voltadas ao usuário, orientações de instalação, materiais genéricos de primeiros passos, textos promocionais e conceitos que um modelo competente já consegue tratar com confiabilidade. Reescreva e sintetize o material de origem em vez de copiar a documentação literalmente. Mantenha a habilidade compacta. Crie apenas as referências necessárias para abranger conceitos distintos, evite arquivos redundantes e explique tanto como um padrão funciona quanto por que ou quando ele deve ser usado. ## Incluir um novo projeto no registro e gerar sua habilidade Adicione uma nova fonte gerada ao registro oficial de projetos do repositório, incluindo sua localização de origem e um identificador estável do projeto. Inicialize ou sincronize a fonte pelo fluxo de trabalho compatível do repositório, em vez de criar uma cópia local não rastreada. Leia a documentação do projeto e todas as instruções de geração específicas do projeto com detalhes suficientes para entender suas capacidades e convenções. Organize o material útil em categorias como conceitos fundamentais, recursos, práticas recomendadas e fluxos de trabalho avançados. Crie o diretório de saída cujo nome corresponda ao identificador registrado da fonte gerada. Escreva os arquivos de referência, construa o índice da habilidade e registre metadados de geração que contenham a revisão exata da fonte. ## Atualizar habilidades geradas só onde a documentação mudou Leia a revisão da fonte registrada nos metadados de geração e compare-a com a fonte atual. Limite a diferença da fonte à área de documentação que rege a habilidade gerada. Atualize apenas as referências afetadas por essa diferença e, quando necessário, atualize no índice a versão do projeto, a data de geração, a tabela de tópicos e as descrições. Preserve as referências não afetadas e evite gerar novamente conteúdo não relacionado apenas porque o repositório de origem avançou. Após a análise, substitua a revisão registrada pela revisão exata usada na atualização, para que a próxima comparação tenha uma base confiável. ## Copiar habilidades mantidas na origem sem editá-las à mão Para uma habilidade mantida na origem, use o registro para determinar qual habilidade de origem copiar e qual nome de saída usar. O nome de saída pode ser intencionalmente diferente do diretório de origem; portanto, nunca o deduza apenas pelo nome da fonte. Na primeira importação, copie a árvore de habilidades configurada e registre a revisão de origem nos metadados de sincronização. Nas atualizações, compare a revisão registrada com o diretório atual de habilidades da origem, copie apenas os arquivos alterados abrangidos pela configuração e avance a revisão registrada. Nunca modifique manualmente o conteúdo de uma habilidade sincronizada. Envie as correções ao responsável pela origem e traga-as de volta pelo fluxo de trabalho de sincronização, para que as cópias locais não se desviem. ## Escrever um índice curto com links para cada referência Forneça ao índice da habilidade um cabeçalho de metadados válido com um nome em kebab-case, uma descrição concisa da capacidade, metadados de proveniência, a data de geração ou sincronização e a versão pertinente da ferramenta ou do projeto. Adicione um breve parágrafo de orientação e depois agrupe as referências em categorias claras. Para cada tópico, forneça uma descrição breve e um link relativo para a referência correspondente, permitindo que um agente carregue apenas o material necessário para a tarefa atual. Mantenha o índice conciso e voltado à navegação. Não duplique no índice o conteúdo completo das referências nem adicione entradas para arquivos que não existem. ## Tratar um só tema prático em cada arquivo de referência Forneça a cada arquivo de referência um cabeçalho de metadados com um nome estável e uma descrição específica, seguido por um título claro do conceito. Trate uma capacidade ou um fluxo de trabalho coerente por arquivo, em vez de combinar recursos não relacionados. Inclua orientações práticas de uso, exemplos de código funcionais quando o conceito for executável, restrições importantes e a justificativa dos padrões recomendados. Remova o contexto que não ajude um agente a tomar ou executar uma decisão. Termine com referências às fontes que identifiquem a documentação usada para sintetizar o conteúdo. Mantenha essas referências rastreáveis sem transformar a habilidade em uma cópia do material de origem. ## Registrar a revisão e a data da fonte de cada habilidade Para habilidades geradas, registre a localização da fonte, a revisão exata da fonte e a data de geração. Para habilidades sincronizadas, registre a localização da habilidade de origem, a revisão exata da origem e a data de sincronização. Mantenha a versão do índice alinhada ao estado real da fonte e use a data da última geração ou sincronização de acordo com a política do repositório. Não declare uma versão ou revisão do projeto mais recente do que aquela da qual o conteúdo foi derivado. Trate o registro como a lista canônica de projetos compatíveis e localizações de fontes. Evite duplicar URLs mutáveis de repositórios ou mapeamentos de responsabilidade entre arquivos de habilidades quando o registro já for responsável por essas informações. ## Revisar as mudanças finais em busca de links quebrados e revisões antigas Antes da conclusão, confirme que a classificação da fonte, a entrada do registro, a regra de nomenclatura da saída, os links do índice, os cabeçalhos de metadados das referências, a organização das categorias, os metadados de revisão e as citações das fontes sejam todos coerentes. Verifique se o conteúdo gerado foi sintetizado em vez de copiado, se o conteúdo sincronizado não apresenta desvios manuais, se as habilidades escritas manualmente não foram alteradas sem estarem no escopo e se cada referência oferece um valor distinto ao agente. Analise a diferença final em busca de arquivos não relacionados, referências em excesso, versões desatualizadas, exemplos ausentes, links quebrados e alterações da fonte não registradas. Relate qualquer limitação da fonte ou das ferramentas que tenha impedido uma geração ou sincronização completa.