CATEular/skill

Virtuoso Connect

Responsável pela conexão e diagnóstico entre o ambiente local (máquina física) → SSH → máquina virtual → CIW do Virtuoso. Uma vez conectado com sucesso, delega as tarefas ao skill da área correspondente; aqui não se modificam circuitos, PDKs ou configurações de simulação.

Convenções de execução para ChatGPT / Codex

• Leia primeiro o platform.md. Use os arquivos, comandos ou ferramentas de operação do computador realmente fornecidos na sessão atual; não presuma a existência do Claude Code, ferramentas Antigravity, parâmetros de fundo ou comandos de barra.
• O Python local chama virtuoso_bridge, o SKILL é executado no CIW remoto; os caminhos local e da VM são registrados separadamente. A biblioteca bridge é uma dependência externa de execução; este skill não implementa o serviço de comunicação.
• Antes de escrever uma chamada, verifique o código ou assinaturas realmente instalados; use api_probe.py para sondagem puramente local, sem necessidade de conectar à VM. Quando a interface de referência divergir da máquina real, prevaleça o código instalado atualmente, a documentação da Cadence e uma validação mínima; não adivinhe a interface.
• Já foram verificadas conexão, plotagem, ajuste de parâmetros ADE, operações básicas de layout e leitura independente do OCEAN; para limites de versão específicos, pontos de entrada bem-sucedidos e escopo não testado, consulte runtime-capabilities.md. O ambiente atual é lido da configuração local.

Fluxo de conexão

1. De acordo com o protocolo de configuração de ambiente, leia o arquivo config.local.json do diretório deste skill (ou a configuração explicitamente indicada pelo usuário) e extraia dele as informações do interpretador, arquivo de configuração da bridge, host, escopo de trabalho e PDK. O skill principal não armazena caminhos pessoais; reutilize primeiro o ambiente existente, não reinstale no Python global.
2. Use workflow_config.py para selecionar explicitamente o bridge .env da configuração e verificar o endpoint; se a configuração estiver ausente ou campos inválidos, identifique o item faltante e não recue para máquinas históricas. Use a ajuda do CLI atual para verificar o comportamento. Verifique apenas os campos necessários; não imprima senhas, chaves privadas ou todo o .env; inicialize apenas quando faltar configuração.
3. No ambiente selecionado, verifique a ajuda do CLI, inicie a bridge e consulte o status. No PowerShell, execute através do interpretador ou do caminho absoluto do programa em .venv/Scripts/; não use source do Bash, nem monte comandos python -c com múltiplas camadas de aspas.
4. O túnel estar ativo e o CIW estar escutando são duas condições independentes. Se a VM remota precisar carregar um .il de inicialização, use o caminho fornecido na saída de inicialização atual; não codifique caminhos históricos em /tmp. Execute quando houver um canal CIW disponível e autorizado; caso contrário, forneça ao usuário instruções precisas sobre o CIW.
5. Use chamadas de somente leitura, como getCurrentTime(), para verificar result.ok e saída sem erros; registre a versão da bridge, interpretador, origem da configuração e status da conexão. Se a versão remota não for encontrada, marque como desconhecida.
6. Mantenha o serviço e o túnel estabelecidos nesta sessão para operações subsequentes. Não presuma que processos em segundo plano continuem vivos após o término do comando; verifique seu status de forma independente.

Para SKILL multilinha, prefira salvar o arquivo como .py ou .il. Se o CLI eval --stdin está disponível deve ser verificado na versão atual; não herde a conclusão de desabilitação permanente de versões antigas.

Tratamento de falhas

Leia o recovery.md e faça a diagnose em camadas: programa local, SSH, encaminhamento de porta, escuta remota, diálogos modais do CIW. Timeout de conexão não equivale a falha de circuito. Trate apenas diálogos identificados e pertencentes à operação atual; não confirme pop-ups desconhecidos em lote, não exclua automaticamente arquivos de bloqueio de design, nem termine processos de outros usuários.

Delegação

• Varredura de parâmetros, otimização → virtuoso-params.
• Esquemáticos, symbols, ADE, testbenches e cópia de bibliotecas de design → virtuoso-testbench.
• Layout, DRC/LVS/PEX → virtuoso-layout.
• Atalhos de teclado, menus, explicações e consultas a documentação → virtuoso-helper.

Detalhes de pesquisa de funções estão em skill-finder-python-api.md. Use a conexão apenas quando precisar consultar a documentação de funções remotas; não inicie o serviço da VM apenas para verificar arquivos.