cirq

cirq 스킬 개요

cirq는 무엇에 쓰나

cirq 스킬은 Google Quantum AI의 오픈소스 Python 프레임워크를 사용해 양자 회로를 만들고, 시뮬레이션하고, 실행하는 작업을 도와줍니다. 회로를 명확하게 표현하고, 시뮬레이터로 검증하거나, 지원되는 양자 하드웨어와 공급자를 대상으로 하는 코드를 준비해야 할 때 가장 유용합니다.

가장 잘 맞는 사용 사례

잡음까지 고려한 회로 설계, 양자 특성화 실험, Google Quantum AI 워크플로가 필요하다면 cirq를 쓰는 것이 좋습니다. 특히 큐비트 배치, 게이트 순서, 측정 전략이 고수준 추상화보다 더 중요한 저수준 회로 작업에 잘 맞습니다.

cirq가 맞지 않는 경우

IBM 하드웨어가 필요하다면 보통 qiskit이 더 적합합니다. 양자 머신러닝에 autodiff가 필요하다면 기본 선택지는 pennylane이 더 낫습니다. 물리 시뮬레이션 워크플로라면 qutip이 cirq보다 더 알맞을 수 있습니다.

cirq 스킬 사용 방법

작업공간에 cirq 설치하기

다음 명령으로 스킬을 설치하세요.
npx skills add K-Dense-AI/claude-scientific-skills --skill cirq

런타임 의존성은 보통 핵심 패키지부터 설치합니다.
uv pip install cirq

cirq-google, cirq-ionq, cirq-aqt, cirq-pasqal, azure-quantum 같은 공급자 패키지는 특정 백엔드가 필요할 때만 추가하세요.

cirq에 맞는 입력 형태를 주기

cirq 스킬은 회로의 목표, 큐비트 개수나 토폴로지, 사용할 백엔드 또는 시뮬레이터, 그리고 잡음·샘플링·하드웨어 실행 중 무엇이 필요한지를 명확히 적을 때 가장 잘 작동합니다. “양자 회로를 만들어줘”처럼 모호한 요청은 선택지가 너무 많습니다. 더 좋은 프롬프트는 다음처럼 구체적입니다. “cirq를 사용해 3큐비트 GHZ 회로를 만들고, 1,000 shots로 시뮬레이션한 뒤 Google Quantum Engine에 맞게 어떻게 바꿀 수 있는지 설명해줘.”

먼저 읽어야 할 파일

먼저 SKILL.md를 읽어 워크플로, 설치 방법, 빠른 시작 패턴을 확인하세요. 로컬 복사본에 추가 문서가 있다면 코드를 생성하기 전에 README.md, AGENTS.md, metadata.json, 그리고 rules/, resources/, references/, scripts/ 폴더를 살펴보는 것이 좋습니다. 이 저장소에서는 SKILL.md가 핵심 기준 문서입니다.

더 나은 결과를 위한 실전 워크플로

cirq는 두 단계로 쓰면 결과가 좋아집니다. 먼저 회로 구조와 검증 목표를 정하고, 다음으로 시뮬레이터 또는 하드웨어 연동 세부사항을 고르세요. 코드를 생성할 때는 먼저 최소 동작 예제를 요청한 뒤, 파라미터화, 측정 키, 백엔드별 패키징을 덧붙이게 하세요. 이렇게 하면 존재하지 않는 API를 만들어낼 가능성이 줄고, cirq 사용 방식도 더 쉽게 검증할 수 있습니다.

cirq 스킬 FAQ

cirq는 초보자에게도 친숙한가요?

네, 단순한 회로 구성과 시뮬레이션이 목적이라면 그렇습니다. 다만 하드웨어 제약, 백엔드 선택, 잡음 모델링으로 들어가면 난도가 올라갑니다. 이때는 정확한 입력 정보가 훨씬 더 중요해집니다.

cirq는 일반적인 프롬프트와 무엇이 다른가요?

일반적인 프롬프트는 그럴듯한 양자 예시를 돌려주는 경우가 많습니다. cirq 스킬은 Cirq의 실제 객체, 설치 경로, 백엔드별 패키지에 맞는 코드를 얻어야 할 때 더 유용합니다. 잘못된 import나 실행 가정 불일치의 가능성을 낮출 수 있기 때문입니다.

언제 cirq를 쓰지 말아야 하나요?

대상 생태계가 Google과 분명히 맞지 않거나, 작업이 회로 구성보다는 기호 계산, 일반적인 ML, 물리 분석에 가깝다면 cirq를 쓰지 마세요. 그런 경우에는 다른 양자 또는 과학 스택이 더 깔끔한 결과를 내는 경우가 많습니다.

cirq 스킬 개선하기

실행 대상을 먼저 지정하기

가장 큰 품질 향상은 초반에 대상 환경을 명시하는 데서 나옵니다. 시뮬레이터인지, Google Quantum Engine인지, IonQ인지, AQT인지, Pasqal인지, Azure Quantum인지 먼저 밝히세요. 그래야 어떤 cirq 설치 경로, import, API 선택이 유효한지 결정됩니다.

회로 제약 조건을 미리 주기

큐비트 수, 게이트 계열, 측정 형식, 그리고 회로가 파라미터화되어야 하는지 또는 잡음 인식이 필요한지를 적어주세요. 예를 들어, “sympy 파라미터를 사용하는 2큐비트 변분 회로를 만들고, 시뮬레이션 전에 값을 어떻게 바인딩하는지 설명해줘”는 “변분 회로를 만들어줘”보다 훨씬 낫습니다.

검증 가능한 기준점에서 반복하기

먼저 최소 실행 가능 회로를 요청한 다음, 읽기 오류 완화, 백엔드 마이그레이션, 실험 로깅 같은 확장 기능을 추가해 달라고 하세요. 첫 결과가 어긋나면 전체를 다시 쓰게 하기보다 빠진 제약을 바로잡는 편이 낫습니다. cirq 결과는 하드웨어, 샘플링, 회로 형태에 대한 가정을 좁힐수록 가장 빠르게 좋아집니다.