Wiki Builder

Fonte: dair-ai/dair-academy-plugins (MIT).

Propósito

Criar e manter wikis de pesquisa configuráveis. Cada wiki é uma pasta independente com suas próprias fontes, páginas compiladas, artefatos derivados, prompts e configuração local.

Por padrão, as wikis ficam em ~/dair-wikis/. Substitua a localização com a variável de ambiente WIKI_ROOT ou o sinalizador --root em init_wiki.sh.

Esta habilidade é intencionalmente geral. Não codifique em excesso cada wiki na estrutura de artigos de IA. Use o wiki.config.md de cada wiki como a fonte da verdade para propósito, público, tipos de página, regras de estilo e fluxo de trabalho de atualização.

Quando Usar

Use esta habilidade quando o usuário pedir para:

• Iniciar uma nova wiki ou base de conhecimento.
• Criar uma wiki para anotações de pesquisa, artigos, produtos, pessoas, organizações, domínios, projetos ou eventos.
• Ingerir material fonte em uma wiki existente.
• Gerar páginas de wiki, páginas de origem, páginas de conceitos, mapas, cronogramas, resumos ou índices.
• Consultar uma wiki e arquivar a resposta de volta na wiki.
• Refatorar ou evoluir a estrutura, os requisitos ou o estilo de uma wiki.
• Manter a proveniência, anotações de origem e logs de atualização para uma wiki.

Localização Padrão da Wiki

Armazene as wikis aqui, a menos que o usuário forneça explicitamente um caminho diferente:

${WIKI_ROOT:-$HOME/dair-wikis}/<wiki-slug>

Use slugs em minúsculas no formato kebab-case, por exemplo, agent-memory, ai-evals, open-source-models ou company-research.

Layout Principal

Novas wikis devem começar com este layout:

<wiki-slug>/
├── wiki.config.md
├── raw/
├── wiki/
│   └── index.md
├── derived/
├── prompts/
│   ├── compile-index.md
│   ├── compile-source-page.md
│   ├── compile-concept-page.md
│   ├── query-and-file.md
│   └── lint-wiki.md
├── logs/
│   └── maintenance-log.md
└── sources.md

Adicione mais pastas apenas quando a configuração da wiki as necessitar. Adições comuns incluem wiki/papers, wiki/concepts, wiki/people, wiki/products, wiki/organizations, wiki/timelines, wiki/questions, wiki/maps e assets.

Iniciando Uma Wiki

Para novas wikis, use o script incluído (resolva o caminho dele na localização de instalação do plugin, geralmente ${CLAUDE_PLUGIN_ROOT}/skills/wiki-builder/scripts/init_wiki.sh):

bash "${CLAUDE_PLUGIN_ROOT}/skills/wiki-builder/scripts/init_wiki.sh" <slug> --title "Readable Title" --flavor research

Passe --root /custom/path para colocar a wiki em outro lugar que não seja ~/dair-wikis.

Os sabores padrão suportados são research, paper, domain, product, person, organization e project. Use research quando não tiver certeza.

Após a criação:

1. Edite wiki.config.md para corresponder ao objetivo real do usuário.
2. Coloque o material fonte copiado ou baixado em raw/.
3. Registre a proveniência da fonte em sources.md.
4. Gere páginas em wiki/.
5. Registre as principais ações de manutenção em logs/maintenance-log.md.

Fluxo de Trabalho de Operação

1. Resolva a Tarefa

Identifique se o usuário está pedindo para iniciar, ingerir, compilar, consultar, reestruturar, verificar ou exportar. Se a solicitação nomear uma wiki existente, inspecione seu wiki.config.md antes de fazer alterações.

2. Use a Configuração Local

Cada wiki pode ter regras diferentes. Antes de gerar ou modificar páginas, leia:

• wiki.config.md
• sources.md quando a proveniência da fonte for importante
• arquivos relevantes em prompts/ quando a wiki tiver prompts personalizados

A configuração local prevalece sobre os padrões genéricos nesta habilidade.

3. Preserve a Proveniência

Não converta alegações soltas em fatos da wiki sem uma fonte. Ao usar páginas da web, artigos, transcrições, anotações ou arquivos de repositório, registre proveniência suficiente para que um agente futuro possa encontrar a fonte original novamente.

No mínimo, as entradas de sources.md devem incluir título, caminho ou URL da fonte, data de adição e uma breve nota sobre o que ela contribui.

4. Compile Páginas

Prefira páginas de wiki duráveis em vez de resumos únicos. Páginas fortes geralmente incluem:

• uma visão geral concisa
• pontos-chave baseados em fontes
• links para páginas de wiki relacionadas
• perguntas em aberto ou incerteza
• notas de atualização quando relevante

Mantenha a estrutura da página consistente com a configuração e o sabor da wiki.

5. Mantenha a Wiki

Ao adicionar ou alterar muitas páginas, atualize wiki/index.md, mapas relevantes e logs/maintenance-log.md. Se a solicitação do usuário alterar o propósito ou a estrutura da wiki, atualize wiki.config.md primeiro.

Sabores

…