Dex

Dex gerencia fontes públicas de skills e agentes hospedados no GitHub e compõe os catálogos habilitados em cada workspace pelo Visual Studio Code ou pelo Kiro.

Como usar

1. Abra uma pasta ou workspace confiável.
2. No Explorer, localize a seção Fontes de skills Dex.
3. Use o botão + e escolha o catálogo Dex ou uma fonte personalizada.
4. Use o botão de sincronização no cabeçalho para atualizar todas as fontes habilitadas.

A extensão identifica o editor automaticamente e grava a composição em:

• Visual Studio Code: .agents/skills;
• Kiro: .kiro/skills.

Os agentes baixados ficam em .agents/agents no Visual Studio Code ou em .kiro/agents no Kiro. Cada repositório de agentes pode disponibilizar as duas variações na pasta configurada: a extensão instala apenas arquivos .md no Visual Studio Code e em outros editores, ou apenas arquivos .json no Kiro.

É necessário ter acesso à internet durante a sincronização e a verificação de atualizações.

Tempo do mês

No lado direito da barra de status, a Dex mostra um ícone de relógio e o percentual de dias úteis já transcorridos no mês atual. O cálculo considera segunda a sexta-feira, inclui o dia útil atual e não desconta feriados. Passe o mouse sobre o indicador para ver a quantidade de dias úteis transcorridos e o total do mês. O valor é atualizado na virada de cada dia local.

Configuração por workspace

As fontes ficam declaradas em .dex/sync.json na raiz selecionada. Abrir uma pasta sem esse arquivo não cria configuração, adiciona fontes ou sincroniza skills automaticamente. Durante a ativação, a extensão consulta apenas o catálogo público de fontes conhecidas para manter o seletor atualizado; essa consulta não altera o workspace. O arquivo é criado somente quando uma fonte é adicionada pela extensão.

Exemplo de configuração:

{
  "version": 1,
  "sources": [
    {
      "id": "dex-ai",
      "repository": "https://github.com/gdesordi/dex-ai",
      "ref": "main",
      "path": "skills",
      "agentsPath": "agents",
      "enabled": true
    }
  ]
}

Cada fonte define um identificador único, a URL pública do GitHub, uma branch, tag ou commit, o caminho do catálogo de skills no repositório e se participa das sincronizações. agentsPath é opcional e define o caminho dos agentes no mesmo repositório. Em workspaces com várias raízes, os comandos globais solicitam qual pasta deve ser usada.

Sincronização

O botão de sincronização no cabeçalho baixa todas as fontes habilitadas, valida seus catálogos de skills, atualiza a cópia local isolada de cada fonte e recompõe os destinos do workspace. Quando agentsPath estiver configurado, os agentes também são baixados e atualizados. Skills ou agentes de mesmo nome em fontes diferentes são rejeitados.

O botão de sincronização de uma fonte atualiza somente a fonte selecionada. O destino é recomposto com sua nova cópia e com as cópias locais das demais fontes habilitadas.

Ao adicionar uma fonte conhecida ou personalizada, a extensão inicia automaticamente sua primeira sincronização. Se ela falhar ou for cancelada, a configuração é preservada para uma nova tentativa manual.

Durante a composição, as pastas de skills e agentes permanecem no lugar e somente seu conteúdo é substituído. A extensão mantém uma cópia temporária do conteúdo anterior para restauração em caso de falha. Como esses destinos são gerenciados pela Dex, arquivos adicionados manualmente dentro deles são removidos na próxima composição.

Se o download de uma fonte falhar durante a sincronização global, a extensão registra a falha e usa sua última cópia local válida, quando disponível, para compor o destino. Os detalhes ficam no canal de saída Dex.

A verificação de atualizações é manual. Para cada repositório configurado, ela resolve a referência remota e compara seu commit com o commit armazenado na última sincronização, sem depender de um manifesto de versão e sem baixar o catálogo. Mudanças de repositório, referência ou caminho também indicam que a fonte precisa ser sincronizada.

Ao alterar uma fonte de enabled: true para enabled: false, a extensão remove imediatamente do workspace as skills e os agentes fornecidos por ela e informa quantos itens foram removidos. A cópia local isolada da fonte é preservada.

O estado também pode ser alternado pelo botão exibido em cada fonte na Tree View. Ao reativar uma fonte, a extensão a sincroniza imediatamente para restaurar suas skills e agentes no destino. Se a sincronização falhar ou for cancelada, a fonte permanece ativa para permitir uma nova tentativa manual.

Tree View

A seção Fontes de skills Dex lista as fontes de cada raiz do workspace.

• O botão + lista primeiro os catálogos conhecidos — Dex AI, GCT, GCT Staging, TOTVS EngPro ADVPL/TLPP e TOTVS EngPro Superpowers — e mantém Fonte de skills personalizada como última opção. A lista é atualizada pelo catálogo público do Dex durante a ativação; se ele estiver indisponível ou inválido, a extensão usa a lista distribuída na instalação.
• O botão de sincronização do cabeçalho atualiza todas as fontes habilitadas.
• O ícone e a descrição distinguem fontes ativas e inativas. Os botões de cada fonte permitem ativá-la ou desativá-la, sincronizá-la quando ativa, abrir seu repositório ou removê-la.
• O menu de três pontos permite abrir .dex/sync.json e verificar atualizações.

Clicar em uma fonte apenas a seleciona; o repositório é aberto pelo botão correspondente. Ao remover uma fonte, é possível preservar ou apagar sua cópia local isolada.

Comandos

• Dex: Sincronizar fontes de skills: sincroniza todas as fontes habilitadas e recompõe o destino.
• Dex: Sincronizar fonte de skills: sincroniza a fonte selecionada e recompõe o destino com todas as fontes habilitadas.
• Dex: Ativar fonte de skills e Dex: Desativar fonte de skills: alternam a participação da fonte nas sincronizações diretamente pela Tree View.
• Dex: Verificar atualizações das fontes: compara os commits locais com as referências remotas configuradas.
• Dex: Adicionar fonte de skills: permite escolher um catálogo conhecido ou cadastrar uma fonte personalizada, inclusive um caminho opcional de agentes, em .dex/sync.json.
• Dex: Abrir configuração de fontes: abre .dex/sync.json para edição.
• Dex: Abrir repositório da fonte: abre no navegador a origem selecionada.
• Dex: Remover fonte de skills: remove a fonte da configuração e oferece a opção de apagar sua cópia local.
• Dex: Responder questionário de especificação: localiza questionários JSON mantidos pela dex-spec-manage em .specs/dex/ e abre um painel para aceitar sugestões ou editar todas as respostas com salvamento automático.

Questionários de especificação

A skill dex-spec-manage mantém cada questionário em Markdown e no arquivo <feature>.refinement-questionnaire.json. Ao executar o comando de resposta, a extensão procura esses arquivos em todas as pastas do workspace, apresenta os pendentes primeiro e também permite revisar questionários já respondidos.

O painel agrupa as perguntas por seção, mostra o progresso e informa quando as alterações foram salvas. O estado pode ser Pendente, Respondido parcialmente ou Respondido. Fechar o painel preserva as respostas já salvas. Arquivos inválidos ou com versão de schema incompatível não são alterados; os detalhes ficam no canal de saída Dex.

Depois de responder, solicite à dex-spec-manage que sincronize ou consolide a spec para transportar as respostas do JSON ao questionário Markdown.

Os comandos acompanham o idioma do editor em inglês ou português do Brasil. Nenhuma fonte é consultada ou sincronizada automaticamente durante a ativação.