指南

黑客松期间，你将以小队形式（1–3 人，第一天自由组队）专攻一种模拟方法。你的工作伙伴有两个：一个 AI 编码智能体——运行在终端里的对话助手，能读文件、写代码、跑程序；以及智御系统（harness）——共享的 GitHub 仓库 QuantumBFS/quantum.harness，每种方法的专家在其中整理了关键文献、可运行的示例和分步指令，教会智能体正确地运行该方法。

这一周的目标：复现一篇已发表论文的结果，然后超越它——完成一个你们自己的挑战，最后以 Pull Request 的形式提交全部成果。Pull Request（PR）是 GitHub 上向共享仓库提议合并你的修改的机制，也是导师评审你们工作的载体。

本页按时间顺序走完整周流程。每个 ▶ Prompt 框中的文字请直接粘贴给你的智能体（Claude Code、Codex CLI、Kimi Code CLI 或 OpenCode，见配置）；鼠标悬停可显示复制按钮。

// 时间节点

时间	事项
第一天（周一）15:00 前	通过 `/take-challenge` 创建登记用的草稿 PR
第四天（周四）20:00	运行 `/challenge-report`，将 PR 标记为可评审，并停止更新
第四天（周四）20:00–22:00	导师分赛道线上评审 PR，选出 8 个小组
第五天（周五）上午	8 个入选小组展示，每组 15 分钟；展示后颁奖

// 方法赛道

每张卡片列出方法、负责该赛道的专家，以及在智能体中加载该方法指令的命令。

|n⟩

精确对角化

有限尺寸哈密顿量的精确对角化。
专家：程晨 · /method-ed

⊗

MPS / LTRG / DMRG / TEBD

一维和有限温体系的张量网络方法。
专家：李伟 · /method-mps · /method-ltrg

⊞

PEPS / CTMRG

投影纠缠对态与角转移矩阵重整化方法。
专家：廖海军 · 姜胜寒 · /method-peps

∮

量子蒙特卡洛

配分函数与基态的蒙特卡洛采样。
专家：秦明普 · 刘子宏 · /method-qmc

𝒰

量子线路模拟

量子线路和基于门电路的算法的经典模拟。
专家：张士欣 · /method-qcs

⪰

半正定规划

用半正定规划给出基态能量的严格下界。
专家：王杰 · /method-polyopt

⌘

AI 智能体与知识库

改进智御系统本身：skills 与知识库。
专家：陈锟 · 刘金国 · tracks/agent-kb

仓库中的赛道文件夹名（也用于提交路径和 PR 标题）：ed、mps、peps、qmc、qcs、polyopt、agent-kb。

// 配置——第一天

开始第一天的流程前，请安装并登录一个 AI 编码智能体。你还需要一个免费的 GitHub 账号。

工具	推荐模型	链接
Claude Code	Opus 5 · xhigh effort	code.claude.com
Codex CLI	GPT-5.6 Sol · xhigh effort	github.com/openai/codex
Kimi Code CLI	K3 · max effort	kimi.com/code
OpenCode	路由至上述任一模型	opencode.ai

验证方法：在任意文件夹中启动工具，让它读取一个文件。

接着安装两个帮手。superpowers 是一套 skills——可复用的指令文件，教智能体养成严谨的工作习惯，例如先规划再写码、先测试再下结论。gh 是 GitHub 官方命令行工具，智能体用它复制仓库、提交 PR。

Install https://github.com/obra/superpowers and gh (GitHub CLI) if not already installed.
Authenticate me to GitHub via gh auth login if I'm not logged in.

// 获取智御系统（第一天）

先克隆共享仓库并安装其中的 skills。之后运行 /take-challenge 时，流程会创建用于登记小队和挑战的草稿 PR。

Clone https://github.com/QuantumBFS/quantum.harness to ~/code/quantum.harness.
Run make skills to install the harness skills.
Then run /beginner-training to start the guided training.

// 上手——复现一篇已发表的结果

每条赛道都指定了一篇参考论文和需要复现的具体图表。复现出与论文一致的数字，说明你的整套流程——智能体、代码、环境——端到端可用，然后才进入下一步。从这里开始：

/beginner-training

运行 /beginner-training。它提供五条新手教学轨道——环境自检、复现论文、文献调研、像专家一样开发代码、超越已有结果——每一步都先讲解、经你确认后才执行；不熟悉 git、GitHub 或 Julia 也没关系，教会你正是训练的任务。复现请选轨道 2：它会列出各赛道的参考论文，让你选择一条，然后一步步指导复现。结束后，记下哪些结果与论文吻合、哪些不吻合，以及所用的软硬件环境——写报告时都用得上。

// 接受挑战

挑战是一个明确定义、且超越参考论文的问题：更大的体系、不同的可观测量、更紧的界，或更好的算法。请组成 1–3 人小队，从挑战页选择一个已接受的题目，或带上你们自己的题目，然后在第一天 15:00 前运行 /take-challenge。该 skill 会创建小队的登记草稿 PR；PR 创建后，挑战即登记完成。你可以在服务台咨询导师，但登记不需要许可。

和智能体一起分析一个已列出的挑战：

Read challenge issue #<N> from https://github.com/QuantumBFS/quantum.harness/issues/<N>.
Brainstorm with me: surface 3–5 distinct angles, name the riskiest assumption in each, and recommend one to start with.

如需 HPC 算力，请带着登记 PR 到现场服务台，由工作人员分配 SCNet 账号。

// 在草稿 PR 中工作——周四 20:00 前提交

所有提交都进入周一创建的同一个草稿 PR；挑战成果放在 tracks/<赛道>/solutions/ 下。随着结果推进，把每次 commit 都推送到这个 PR。生成的数据和图片放在 tracks/<赛道>/results/ 下，该目录不进入 git。

成果就绪后，运行 /challenge-report，再将草稿 PR 标记为可评审。这个状态转换——而不是再开一个 PR——才是正式提交。

/challenge-report

报告生成后，运行 gh pr ready。请在周四 20:00 前完成。届时 PR 必须处于可评审状态，并停止更新，因为导师评审随即开始。

// 评审与展示

利用第四天下午让 PR 易于评审：从头重跑一遍演示，再以新读者的眼光重读 README。PR 的最后更新时间是周四 20:00。

当晚 20:00–22:00，导师分赛道线上评审全部 PR，选出 8 个小组。这些小组于周五上午在主会场展示，每组 15 分钟。展示结束后，导师团共同评定 4 台 Mac mini 奖励；第 5 台授予本周最佳分享会。

评判标准很简单。导师团是否愿意为这个成果投入一台 Mac mini 奖励？如果是，获选小组承担两项义务：花大约 2 小时打磨 skills 与迷你智御系统以便合并入仓库，并分享与智能体的聊天记录（我们提供提取工具），作为文章撰写或其他研究分析的原始素材。

// 求助渠道

Zulip — harnessing-quantum.zulipchat.com：公告、服务台问答和各赛道讨论串。邀请随录取邮件发出。
服务台（现场）——咨询、日程指引和临时支持，由老师和助教轮值。
专家答疑时间——本周内定时安排，详见日程。

// 延伸学习

学习资料：

可选工具与 skills： 详见资源页——MCP 服务器、命令行工具和 skill 合集。