CommunityEscrita e Ediçãogithub.com

steffen74/assumido-conhecimento

Regras para a fronteira de pré-requisitos de um curso – o que se pode assumir que os alunos sabem e possuem em cada ponto, e como distinguir uma lacuna de uma suposição justa. Use ao escrever ou revisar instruções, tarefas, etapas de configuração ou questionários voltados para os participantes, e quando um aluno ficar travado.

O que é assumido-conhecimento?

Esta skill define o conceito de **fronteira de conhecimento assumido** para cursos de treinamento ou instrução. Ela estabelece regras claras para instrutores e revisores de material didático sobre o que um aluno pode ser razoavelmente esperado saber, possuir (como contas, software instalado) ou ser capaz de fazer em um determinado ponto do curso. A habilidade ajuda a identificar e evitar **lacunas** – etapas que exigem algo fora da fronteira, causando travamentos ou adivinhações. Ela cobre não apenas conceitos, mas também artefatos físicos/digitais (clonar repositórios, ter permissões de administrador), convenções (saber o que é um prompt de comando) e a ordem temporal dos materiais. Útil para plataformas de criação de cursos (Canvas, por exemplo) e agentes de IA que auxiliam na escrita de instruções passo a passo, garantindo que cada etapa seja suportada por um pré-requisito documentado ou por uma instrução anterior executável.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steffen74/agentic-course-creation/tree/HEAD/skills/assumed-knowledge

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Conhecimento assumido

A fronteira é o que se pode assumir que um aluno sabe, possui e é capaz de fazer em um dado ponto do curso. O bloco 6 do Canvas a mantém para o início do curso; o material de cada unidade a estende. Cada passo que se pede a um aluno deve estar dentro da fronteira naquele ponto. Um passo fora dela é uma lacuna: o aluno fica travado, adivinha ou pergunta.

O que a fronteira cobre

Não apenas conceitos. Lacunas surgem pelo menos com tanta frequência a partir de:

  • Coisas que eles têm: contas, assinaturas, software instalado, direitos de administrador, um laptop próprio, um repositório próprio.
  • Coisas que eles fizeram: um clone, um fork, um uv sync, entrar em uma sala de chat, aceitar um convite.
  • Onde as coisas estão: qual repositório, qual pasta, qual link. “Seu clone do repositório modelo” assume que eles fizeram um.
  • Convenções: o que é um prompt de comando, o que “executar” significa em um notebook, que /comando é digitado no agente.

Regras

  • A fronteira é decisão do instrutor. Quando não estiver claro se algo pode ser assumido, pergunte; não decida.
  • Algo se torna conhecido apenas quando o material o ensinou antes de ser usado, ou pediu que os alunos o fizessem com instruções que pudessem seguir. Estar em um vídeo listado para a mesma unidade só conta se o vídeo vier antes da tarefa.
  • Uma ferramenta que faz isso pelo aluno (um agente, um script de configuração) só conta se o aluno for instruído a usá-la naquela etapa, com o prompt ou comando exato.
  • Cada artefato do qual uma etapa depende precisa de uma origem: uma etapa que o criou, ou um link para onde ele vive.
  • Material opcional nunca estende a fronteira.
  • Quando duas personas diferem, a fronteira segue a mais fraca, a menos que o bloco 6 as exclua explicitamente.

Lacunas típicas

  • Uma instrução se refere a um objeto (repositório, arquivo, sala, conta) cuja etapa de criação está faltando ou apenas implícita.
  • Duas páginas nomeiam repositórios ou pastas diferentes para a mesma etapa.
  • Um comando funciona apenas a partir de uma pasta específica, e a página não diz qual.
  • Uma ferramenta da qual a etapa depende é gratuita em um plano e paga em outro; a página assume a paga.
  • Uma tarefa exige um conceito que está agendado para uma unidade posterior.

Bandeiras vermelhas em sala de aula

A mesma pergunta de vários alunos; alunos esperando o instrutor antes de poderem começar; uma entrega faltando para um grupo inteiro. Trate cada uma como uma violação da fronteira até que se prove o contrário, e carregue course-checks para transformá-la em uma verificação.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Habilidades Relacionadas