cirq

Visão geral do skill cirq

Para que o cirq serve

O skill cirq ajuda você a trabalhar com o framework Python open-source do Google Quantum AI para criar, simular e executar circuitos quânticos. Ele é mais útil quando sua tarefa é expressar circuitos com clareza, testá-los em simuladores ou preparar código voltado a hardware quântico e provedores compatíveis.

Casos de uso em que o cirq é mais indicado

Use o cirq quando você precisar de design de circuitos com consciência de ruído, experimentos de caracterização quântica ou fluxos de trabalho do Google Quantum AI. Ele é uma boa escolha para trabalho de baixo nível com circuitos, em que a disposição dos qubits, a sequência de portas e a estratégia de medição importam mais do que abstrações de alto nível.

Quando o cirq não é a melhor escolha

Se você precisa de hardware da IBM, qiskit normalmente é a opção mais adequada. Se sua tarefa é machine learning quântico com autodiff, pennylane tende a ser a melhor escolha padrão. Para fluxos de simulação em física, qutip pode ser mais apropriado do que o cirq.

Como usar o skill cirq

Instale o cirq no seu workspace

Instale o skill com:
npx skills add K-Dense-AI/claude-scientific-skills --skill cirq

Para dependências de runtime, o pacote principal normalmente é:
uv pip install cirq

Adicione pacotes de provedores apenas quando necessário, como cirq-google, cirq-ionq, cirq-aqt, cirq-pasqal ou azure-quantum para backends específicos.

Forneça a entrada no formato certo para o cirq

O skill cirq funciona melhor quando você especifica: o objetivo do circuito, a quantidade ou topologia de qubits, o backend ou simulador e se você precisa de ruído, amostragem ou execução em hardware. Uma solicitação vaga como “crie um circuito quântico” deixa escolhas demais em aberto. Um prompt mais forte seria: “Usando cirq, crie um circuito GHZ de 3 qubits, simule 1.000 shots e explique como adaptá-lo para o Google Quantum Engine.”

Leia primeiro os arquivos certos

Comece por SKILL.md para entender o fluxo de trabalho, a instalação e os padrões de quick start. Se sua cópia local incluir documentação extra, examine README.md, AGENTS.md, metadata.json e quaisquer pastas rules/, resources/, references/ ou scripts/ antes de gerar código. Neste repositório, SKILL.md é a principal fonte de verdade.

Fluxo de trabalho prático para melhorar a saída

Use o cirq em duas etapas: primeiro, defina a estrutura do circuito e o alvo de validação; depois, escolha os detalhes de integração com simulador ou hardware. Se você estiver gerando código, peça primeiro um exemplo mínimo funcional e, depois, amplie com parametrização, chaves de medição ou empacotamento específico do backend. Isso reduz APIs inventadas e torna o uso do cirq mais fácil de verificar.

Perguntas frequentes sobre o skill cirq

O cirq é amigável para iniciantes?

Sim, se seu objetivo for construir e simular circuitos simples. Ele fica mais difícil quando você avança para restrições de hardware, seleção de backend ou modelagem de ruído, cenários em que os detalhes exatos da entrada passam a importar muito mais.

O que torna o cirq diferente de um prompt genérico?

Um prompt genérico часто devolve um exemplo quântico plausível. O skill cirq é melhor quando você precisa de código alinhado aos objetos reais do Cirq, ao caminho de instalação e aos pacotes específicos de backend, o que reduz a chance de imports errados ou suposições incompatíveis de execução.

Quando não devo usar o cirq?

Não use o cirq quando o ecossistema alvo claramente não for alinhado ao Google ou quando a tarefa for principalmente matemática simbólica, ML clássico ou análise de física sem construção de circuitos. Nesses casos, uma pilha quântica ou científica diferente normalmente produz resultados mais limpos.

Como melhorar o skill cirq

Especifique o alvo de execução

O maior ganho de qualidade vem de nomear o alvo logo no início: simulador, Google Quantum Engine, IonQ, AQT, Pasqal ou Azure Quantum. Isso determina qual caminho de instalação do cirq, quais imports e quais escolhas de API são válidos.

Informe as restrições do circuito desde o começo

Declare o número de qubits, a família de portas, o formato de medição e se o circuito precisa ser parametrizado ou consciente de ruído. Por exemplo, “Construa um circuito variacional de 2 qubits com parâmetros sympy e explique como vincular valores antes da simulação” é muito melhor do que “faça algo variacional”.

Itere a partir de uma base testável

Peça primeiro um circuito mínimo executável e, depois, solicite extensões como mitigação de erro de leitura, migração de backend ou registro de experimento. Se o primeiro resultado vier fora do esperado, corrija a restrição ausente em vez de pedir uma reescrita completa; as saídas do cirq melhoram mais rápido quando o prompt reduz as suposições sobre hardware, amostragem e formato do circuito.