ariel-lee-1023/Livros-para-Referências-de-Habilidades

O que Livros-para-Referências-de-Habilidades faz?

Habilidade de agente que destila vários livros/documentos em uma única execução em uma biblioteca de conhecimento plana: um SKILL.md mestre indexando todas as fontes, mais um reference-.md por livro. Estrutura sobre resumo, termos do autor, densidade sobre extensão — nunca texto bruto.

Propósito

• Destilar muitos livros/documentos em um formato de referência estruturado, voltado para desenvolvimento.
• Criar uma biblioteca de conhecimento plana e desacoplada: um único SKILL.md indexa tudo, cada livro ganha seu próprio reference-<slug>.md.
• Ênfase em estrutura > resumo, termos do autor > paráfrase, densidade > extensão, preservação > compressão.

Distinção principal em relação a outras habilidades: Esta habilidade processa MÚLTIPLOS livros/documentos em uma única execução. Ela não se limita a um único livro. É ideal para construir rapidamente uma ampla base de conhecimento a partir de toda uma biblioteca, currículo ou lista de leitura.

---

Como funciona (em uma única execução)

1. Você fornece uma lista de livros/documentos (Links, caminhos de arquivo, títulos para busca).
2. A habilidade processa cada um sequencialmente.
3. Para cada livro, ela gera:
   • Um arquivo reference-<slug-do-livro>.md dedicado (saída estruturada).
4. Após processar todos, ela gera (ou atualiza):
   • Um arquivo SKILL.md mestre indexando e referenciando cada arquivo de referência.

Modelos recomendados: Sonnet/Opus, GPT-4 (para qualidade de extração). Modelos pequenos podem ter dificuldades com densidade.

---

Estrutura da sua pasta de saída

Você (ou o agente) deve preparar uma pasta de saída, por exemplo, minha-biblioteca/.

Dentro dela, o agente criará:

minha-biblioteca/
├── SKILL.md              (Arquivo mestre: índice + seções fundacionais)
├── reference-clean-code.md
├── reference-pragmatic-programmer.md
├── reference-designing-data-intensive-apps.md
└── ... (um por livro/dado)

Convenção de nomenclatura

• Arquivo Mestre: SKILL.md (sempre maiúsculo).
• Arquivos de Referência: reference-<slug>.md
  • <slug> é extraído do título ou fornecido por você. Deve ser curto, em letras minúsculas e usar hífens (Ex: Título: "Introdução ao React" → reference-introducao-ao-react.md).

---

Formato do Arquivo de Referência (reference-<slug>.md)

Cada arquivo deve seguir esta estrutura. Trata-se de uma transformação estruturada, não de um resumo.

# Título do Livro: <Título Original Completo>

## Metadados

- **Autor(es):** <Autor>
- **Ano:** <Ano de Publicação>
- **ISBN:** <ISBN (se disponível)>
- **Slug:** <slug>
- **Arquivo Mestre:** [`SKILL.md`](SKILL.md)

## Estrutura do Livro

### Índice

<Reproduzir o índice do livro. Preservar a numeração dos capítulos e nomes.>

### Seções Principais (Taxonomia)

<Dividir o livro em 10-20 seções lógicas (elas podem seguir a estrutura do livro ou ser agrupadas tematicamente). Cada seção deve ter um título de terceiro nível.>

### Regras para o corpo da seção

- **Use marcadores e pequenas tabelas.** Sempre que possível, prefira tabelas a listas. Exigir pelo menos uma tabela por arquivo.
- **Preserve os termos exatos do autor.** Se o autor usa um termo específico (por exemplo, "Orthogonality"), use esse termo. Coloque-o em **negrito** na primeira menção dentro de cada seção.
- **Seja denso.** Extraia princípios, heurísticas, advertências, regras de bolso e trechos de código (se for um livro técnico).
- **Sem prosa longa.** Um parágrafo introdutório curto (1-2 frases) por seção é o máximo.
- **Sem opiniões.** Apenas extraia. Não adicione interpretação ou avaliação do agente.

#### Seção de Exemplo (do "The Pragmatic Programmer")

### Seção: O Cerne do Pragmatismo

| Princípio | Descrição |
|---|---|
| **Responsabilidade** | Assuma a responsabilidade por seu trabalho. Ofereça opções, não desculpas esfarrapadas. |
| **Não Deixe Estragos** | Não deixe janelas quebradas (mau design, decisões erradas, código ruim) sem reparo. Repare assim que for descoberto. |
| **Sopro de Vida** | Seja um catalisador para a mudança. Agite o pote. |

> **Citação chave:** "Cuidado com o que você pede, pois você pode conseguir."

...

### Mapas de Conhecimento

- **Conceitos:** <Lista de conceitos-chave com definições curtas de 1 frase.>
- **Técnicas:** <Metodologias e práticas.>
- **Pessoas/Menções:** <Pessoas notáveis referenciadas no livro.>

### Trechos de Código (se aplicável)

<Incluir exemplos de código úteis. Preservar a linguagem. NÃO traduzir comentários de código a menos que seja seguro.>

---

Comportamento do agente:

• Sempre que ler um termo do autor pela primeira vez, envolva-o em negrito.
• Use o tempo presente.
• Produza pelo menos uma tabela por arquivo.

---

Formato do Arquivo Mestre (SKILL.md)

Este arquivo indexa todos os livros processados e fornece uma visão geral fundacional.

# <Nome da Biblioteca de Conhecimento (derivado do nome da pasta, por exemplo, "Minha Biblioteca Técnica")>

> <Breve descrição de 1-2 frases. Derivada da sua introdução ou da natureza dos livros.>

## Índice de Livros

| # | Título | Slug | Arquivo de Referência |
|---|---|---|---|
| 1 | Clean Code | `clean-code` | [`reference-clean-code.md`](reference-clean-code.md) |
| 2 | The Pragmatic Programmer | `pragmatic-programmer` | [`reference-pragmatic-programmer.md`](reference-pragmatic-programmer.md) |
| ... | ... | ... | ... |

## Seções Fundacionais

<Esta seção extrai **conceitos transversais** que aparecem em MÚLTIPLOS livros. Por exemplo, se todos os livros mencionam "testes", escreva uma seção sobre testes.>

### Tema: <Nome do Tema>

<Seção curta estilo referência sintetizando insights de múltiplas fontes.>

...

## Metodologia de Extração

- Autor: ariel-lee-1023/Books-to-Skill-Refs
- Estrutura sobre resumo
- Termos do autor preservados
- Densidade sobre extensão
- Nunca texto bruto

---

---

Modo de Uso (para você, LLM)

Quando o usuário lhe pedir para construir uma biblioteca de conhecimento:

1. Peça a lista de entrada: "Por favor, forneça os títulos dos livros/documentos, URLs para o conteúdo ou os caminhos para os arquivos. Preciso de pelo menos um."
2. Peça a pasta de saída: "Por favor, especifique o diretório de saída (por exemplo, minha-biblioteca/). Se a pasta não existir, eu a criarei."
3. Confirme: Mostre ao usuário sua intenção: "Processarei [n] livros: [lista]. Criarei [n+1] arquivos (1 SKILL.md + n referências) em [pasta]. Vou começar."
4. Execute: Processe cada livro. Após cada um, marque como concluído. Você É IDEMPOTENTE — se executar duas vezes, obterá o mesmo resultado (você sobrescreverá os mesmos arquivos).
5. Conclua: "Pronto. [n] livros processados. Biblioteca criada em [pasta]."

---

Exemplo de Prompt

Construa uma biblioteca de conhecimento para mim usando o Books-to-Skill-Refs. 
Livros:
1. "Building Microservices" de Sam Newman
2. "Clean Architecture" de Robert C. Martin
3. "Domain-Driven Design" de Eric Evans

Pasta de saída: ./minha-biblioteca-microservices/

Resposta:

"Processarei 3 livros (Building Microservices, Clean Architecture, Domain-Driven Design). Criarei 4 arquivos (1 SKILL.md + 3 referências) em ./minha-biblioteca-microservices/. Vou começar."

... (executa) ...

"Pronto. 3 livros processados. Biblioteca criada em ./minha-biblioteca-microservices/."