Base de Conhecimento

O que é: Repositório pesquisável.

Visão Geral

Define a menor configuração útil de Base de Conhecimento para o negócio em questão e, em seguida, a constrói apenas quando solicitada. A saída padrão é uma recomendação curta, não uma planilha. Artefatos - CSV, SQL DDL, JSON Schema, mapeamento do Notion - são produzidos sob demanda, a partir de uma lista de campos para que não possam divergir.

Camada: Camada 5: Desenvolver. Encaixa: Estágio de Escala. Código da tabela: n/a.

Quando Usar Esta Habilidade

• base de conhecimento
• artigos de wiki da empresa
• banco de dados do centro de ajuda
• índice de documentação interna

Use-a também quando o usuário disser "repositório pesquisável" ou descrever o mesmo processo ocorrendo em uma planilha, um documento ou alguém enviando por e-mail.

Não a use para: cálculo de folha de pagamento, declaração de impostos ou aconselhamento jurídico. Esta habilidade produz apenas modelos vazios - ela nunca armazena ou processa dados reais de funcionários ou clientes.

Como Funciona

Siga o contrato de execução compartilhado. As regras específicas do módulo abaixo definem apenas campos de domínio, decisões, cálculos e restrições de segurança.

Etapa 1 - Identificar a intenção

Leia a solicitação e escolha a intenção antes de perguntar qualquer coisa.

• "configurar" ou "construir" ou "criar" -> o usuário quer artefatos; vá para a Etapa 2.
• "nosso processo é ..." ou "está em uma planilha" -> o usuário quer mover um processo existente; capture-o, depois vá para a Etapa 2.
• "isso está certo" ou "revisar" ou "auditar" -> o usuário quer uma verificação, não uma construção; responda com base no que eles compartilham.
• "como eu faço ..." -> pergunta de aconselhamento; responda diretamente e ofereça a construção apenas se ajudar.

Pergunte apenas se este é o fato ausente de maior valor; caso contrário, prossiga sem um abridor:

P: O que é mais difícil de encontrar hoje?

Etapa 2 - Pergunte apenas o que está faltando

Ignore tudo o que o usuário já respondeu, em qualquer mensagem anterior. Pergunte o restante um de cada vez e pare assim que as respostas restantes não mudarem a saída.

• Conteúdo - Quais documentos? / Quantos? / Quem os escreve?
• Encontrabilidade - Como as pessoas pesquisam agora? / Tags ou pastas? / Apenas interno?
• Propriedade - Quem revisa? / Ciclo de revisão? / Conteúdo desatualizado é removido?
• Processo atual - Onde o conteúdo vive agora? / Drive, Notion ou wiki? / O que está faltando?
• Resultado - O que você precisa? / Um índice, uma estrutura ou regras de autoria?

Nunca invente uma resposta. Se o usuário não souber, registre como desconhecido e continue.

Etapa 3 - Mantenha o contexto interno

Mantenha as respostas nesta forma. Ela permanece interna - não é mostrada ao usuário, a menos que eles peçam, e nunca carrega um valor que o usuário não forneceu.

module: knowledge-base
intent: null            # setup | advice | review | fix | build | convert | export
scale: null             # Starter | Growth | Scale, only if the answer changes it
areas:
  "Content": null
  "Findability": null
  "Ownership": null
  "Current process": null
  "Outcome": null
requested_outputs: []   # csv | sql | json | notion | xlsx - requested formats only
confirmed_facts: []     # only what the user actually said
open_questions: []      # the unanswered ones, in the order worth asking

Etapa 4 - Recomende o menor fluxo de trabalho

Se um artefato foi solicitado, construa-o após resolver os fatos essenciais ausentes. Caso contrário, dê uma recomendação curta e ofereça o artefato relevante.

Abordagem recomendada: Comece com um índice do que existe e quem é o proprietário, depois corrija a encontrabilidade. A escrita de conteúdo ausente vem depois.

Por que esta: Bases de conhecimento morrem por propriedade pouco clara, não por artigos ausentes. Um proprietário nomeado e uma data de revisão por página é o mínimo.

Fluxo de trabalho: Captura de conteúdo → Proprietário → Marcação e estrutura → Pesquisa → Ciclo de revisão

Etapa 5 - Construa apenas sob solicitação

Assim que o usuário pedir, derive os campos do contexto confirmado e emita os artefatos solicitados. Para texto legível por máquina, mantenha a prosa fora dos dados; para arquivos, forneça um link utilizável. Relate falhas de validação de material ou limitações separadamente.

Uma saída selecionada do Notion é renderizada por notion-manual-import, portanto, direcione a etapa do Notion para lá. Quando o usuário selecionar Notion, passe essa etapa para @notion-manual-import: ele contém o CSV, o mapeamento de propriedades, as etapas de importação e a lista de verificação de verificação, e renderiza a Referência de Campo abaixo em vez de definir uma tabela própria. Não reafirme o mapeamento aqui e não improvise as etapas de importação. Saídas manuais de CSV e mapeamento não precisam de conexão. Para alterações solicitadas no espaço de trabalho, siga o contrato compartilhado: verifique o real

…