Configurar Meu QI: Criar e Atualizar Portfólio de Contexto

Crie e mantenha o portfólio de contexto pessoal: um conjunto de arquivos markdown estruturados que representam quem você é, como você trabalha e o que é importante para você. Os arquivos podem residir em qualquer lugar do disco (pasta do OneDrive, um repositório git, um diretório local, etc.). O que os conecta ao agente é um ponteiro em um dos arquivos de instruções personalizadas do usuário (AGENTS.md, copilot-instructions.md, CLAUDE.md, ou qualquer *.instructions.md que o host carregue na sessão).

Como Esta Habilidade Funciona

Quando invocada, determine o estado atual e tome a ação correta.

Descobrindo Contexto Existente

Procure na sessão por referências aos arquivos que esta habilidade cria. O host já mesclou todos os arquivos de instruções personalizadas relevantes na sessão: AGENTS.md (escopo de trabalho ou de usuário), copilot-instructions.md, CLAUDE.md, qualquer arquivo *.instructions.md, e equivalentes específicos do host. Não importa de qual arquivo veio o ponteiro, apenas procure pelos nomes dos arquivos:

• identity.md
• role-and-responsibilities.md
• team.md
• tools-systems-and-config.md
• communication-style.md
• preferences-and-constraints.md

Para cada um, encontre um @<absolute-path> (ou referência de caminho equivalente) em qualquer lugar no texto de instrução carregado. Essa é a localização do arquivo. Não confie no rótulo ou nome da variável ao lado do caminho: os usuários podem nomear os ponteiros de forma diferente (identityProfile, me, who-i-am, etc.). Corresponda ao nome do arquivo no final do caminho.

Para cada nome de arquivo, classifique como:

• NÃO REFERENCIADO — nenhum caminho para este nome de arquivo está carregado na sessão.
• REFERENCIADO, ARQUIVO AUSENTE — um caminho está carregado, mas o arquivo não existe no disco.
• PRESENTE — o caminho está carregado e o arquivo existe. Leia-o para verificar se há placeholders.

Se os seis nomes de arquivos estiverem em estados mistos, trate-os nesta ordem de prioridade: primeiro crie quaisquer arquivos NÃO REFERENCIADOS através da entrevista, depois preencha as entradas REFERENCIADO, ARQUIVO AUSENTE, e por fim corrija os campos incompletos em arquivos PRESENTES. Resuma o estado combinado para o usuário antes de começar, para que ele saiba o que esperar.

Exemplo concreto. Suponha que identity.md e team.md estejam PRESENTES e completos, tools-systems-and-config.md esteja PRESENTE, mas tenha placeholders TODO na seção ADO, role-and-responsibilities.md e communication-style.md estejam REFERENCIADOS, mas os arquivos não existam no disco, e preferences-and-constraints.md NÃO ESTEJA REFERENCIADO. A habilidade deve dizer ao usuário: "Identidade e equipe estão prontas. A configuração de ferramentas tem lacunas. Cargo e estilo de comunicação são referenciados, mas ausentes. Preferências não estão configuradas. Vou entrevistá-lo sobre preferências primeiro, depois criar cargo e estilo de comunicação, e então preencher as lacunas na configuração de ferramentas. OK?"

1. Nenhum arquivo de contexto referenciado

Nenhum dos nomes de arquivos esperados aparece em qualquer lugar nas instruções carregadas. Trate isso como configuração inicial. Execute Configuração Inicial abaixo.

2. Alguns arquivos referenciados, mas ausentes no disco

O usuário iniciou a configuração anteriormente e não a concluiu, ou existem caminhos sem arquivos por trás deles. Retome de onde parou:

• Liste quais arquivos existem e quais estão ausentes.
• Diga ao usuário: "Você tem {arquivos existentes}. Ainda precisa de: {arquivos ausentes}. Quer retomar de onde parou?"
• Ao escolher o próximo arquivo para entrevistar, a ordem de prioridade de Descobrindo Contexto Existente ainda se aplica. Dentro de um empate, use esta sequência padrão: identidade -> cargo -> equipe -> ferramentas -> estilo de comunicação -> preferências-e-restrições.

3. Arquivos existem, mas têm campos incompletos

Arquivos existem, mas alguns contêm valores de placeholder não preenchidos. Preencha lacunas:

• Procure em todos os arquivos referenciados por quaisquer destes padrões de campos incompletos:
  • <!-- TODO --> — placeholder explícito
  • Comentários HTML da forma <!-- ... --> usados como valores substitutos (por exemplo, <!-- your name -->, <!-- org name -->, <!-- manager name -->)
  • Qualquer célula de tabela ou campo cujo único conteúdo seja um comentário HTML
• Liste as lacunas: "Encontrei campos incompletos em {arquivos}. Quer preenchê-los?"
• Para cada lacuna, faça a pergunta específica para esse campo (não a entrevista completa).
• Atualize o arquivo no local com a resposta do usuário.

4. Arquivos estão completos, usuário quer atualizar

O usuário pediu para mudar algo, ou mencionou uma mudança de contexto de passagem (por exemplo, "meu gerente mudou", "contratamos alguém novo", "mudei para uma equipe diferente"). Atualização direcionada:

• Se o usuário mencionou a mudança de passagem durante outra tarefa, ofereça: "It