用途:把 Qiskit Python 代码或 Qiskit 风格线路构造移植为 CUDA-Q Python kernel,目标是得到不依赖原框架的 CUDA-Q 移植版本,保留源量子算法,在小测试规模上匹配源行为,并记录不可避免的 CUDA-Q 限制。
前提:Python 3.10+;目标环境已安装 CUDA-Q,可用 python -c "import cudaq; print(getattr(cudaq, 'version', 'unknown'))" 检查版本;能访问源实现并运行或检查其预期行为;若需与 Qiskit 对比验证,验证环境需安装 Qiskit/Aer,但最终 CUDA-Q 移植本身不得依赖 Qiskit。
主要能力与用法:先阅读源线路构造,识别算法、量子比特/寄存器布局、测量行为和框架辅助函数;保持高层算法不变,未经用户许可不替换中段测量、QPE 结构、oracle 定义或分解策略。执行模式上,最终测量采样用 cudaq.sample,需要按 shot 返回或使用中段测量值时用 cudaq.run,优先使用运行时参数 kernel 而非按规模生成 kernel。门与子线路翻译、顺序规则、精度指导和辅助函数提取模式见 references/porting-reference.md。移植后移除源框架运行时依赖,把纯辅助函数抽到无框架模块;先用小规模确定性输入验证,比较原始计数键与分布而非仅聚合保真度,每次修复后重跑此前失败的配置。
核心规则:保持源算法完整;不引入固定量子比特上限、固定控制元数或源框架导入,除非确实不可避免并已记录;优先使用原生 CUDA-Q 门(r1.ctrl、x.ctrl、swap.ctrl 等)而非经 Qiskit 转译;位序转换只放在移植边界(分配顺序、测量返回列表或最终计数键格式);保真度差异重要时匹配浮点精度;当保留源兼容行为时,可接受在 CUDA-Q 中变为空操作的源标志。
限制:指南面向 CUDA-Q 0.14/0.15 装饰器模式 Python API,版本敏感特性需对照已安装版本复核;部分 CUDA-Q kernel 语言构造比普通 Python 受限,核心编写约束可参考配套 cudaq-guide 技能;CUDA-Q 与 Qiskit 默认精度和计数键显示顺序不同,表面保真度或比特串不匹配可能是约定差异;硬件目标行为、可用后端与目标选项取决于本地 CUDA-Q 安装;本技能不保证性能等价,只关注保持正确性的移植。