kaiwu-qubo SKILL.md skillA
kaiwu-qubo from xi-zhao/openquantum is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add xi-zhao/openquantum/kaiwu-qubo@git:20261012.5ce3b3ePins git:20261012.5ce3b3e in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- xi-zhao/openquantum
- Path
.agents/skills/kaiwu-qubo/SKILL.md- Versions recorded
- 2
- Latest version
- git:20261012.5ce3b3e, committed Oct 12, 2026
- First version recorded
- Sep 27, 2026
- Size
- 2,979 bytes
- Repository stars
- 71
- License
- MIT
用玻色 Kaiwu Community 构建带线性等式平方罚项的 QUBO，转换增广 Ising 矩阵并评估指定二进制方案。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Kaiwu Community 符号 QUBO 建模
<!-- BEGIN NATIVE SDK ACCESS -->
## 原生 SDK 路径
本能力同时支持 **Kaiwu Community 的原生公开 API**。用户需要 上游社区版表达式、约束、QUBO/Ising 转换与优化接口 时，由 Agent 在固定依赖环境中编写和运行任务代码，不限于下文便捷 Tool 的预设模型。
使用 `node scripts/sdk-access.mjs inspect kaiwu-qubo` 定位环境，按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航：`kaiwu`；导航不是 API 白名单。
固定的是 Kaiwu Community；商业服务和企业版不是该发行版的一部分。
下文关于模型、门集、输入与预算的限制描述便捷 Tool 的合同；原生 SDK 另受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
<!-- END NATIVE SDK ACCESS -->
Agent 经 Harness 调用 `kaiwu_local` 提供的 `build_kaiwu_qubo`。本 Skill 负责模型选择和结果解释，Tool 在独立 Python 环境执行真实上游 SDK。
输入目标函数的 `linear`、`quadratic=[{i,j,bias}]`、`offset`，以及可选 `constraints=[{coefficients,rhs,penalty}]`。每个约束贡献 `penalty*(coefficients.x-rhs)^2`；penalty 必须为正，变量及约束维度必须一致。
SDK 使用真实 Binary 表达式与 QuboModel。输出 `variableNames` 按输入索引排列，包括零系数变量。QUBO 能量为 `x^T quboMatrix x + quboOffset`；非对角元严格按矩阵相乘计数，不另乘二。
Kaiwu 的 Ising 符号约定是 `E=-s^T isingMatrix s + isingOffset`。设置 `s_i=2*x_i-1`，并把额外的最后一个辅助 spin 固定为 +1。不要直接把这一矩阵当成通常正号的 J 系数表。
`assignments` 是要评估的二进制向量，可为空。返回原目标能量、每个等式残差、罚项能量和总能量。此动作只建模和评估，不求解；有限罚项不保证最优解可行。后续可将编译的 QUBO 转为 Ocean 等求解器的对应系数时保留 offset 与非对角元约定。
…Read the whole file at its exact version.
How to install
mdr add xi-zhao/openquantum/kaiwu-qubo@sha256:32a28a61ba543294The line at the top of this page pins the label git:20261012.5ce3b3e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_c65u4hq63va6a5fb)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, between Sep 27, 2026 and Oct 12, 2026, about one every 14 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261012.5ce3b3e latest | 2026-10-12 | 5ce3b3e | 2,979 B | A | view · diff |
| git:20260927.3f344ad | 2026-09-27 | 3f344ad | 2,058 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2979 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
xi-zhao/openquantum · 71 stars · license MIT · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_c65u4hq63va6a5fb GET https://markdownregistry.com/api/v1/resolve?ref=xi-zhao/openquantum/kaiwu-qubo GET https://markdownregistry.com/api/v1/blob/32a28a61ba543294e2a35e5ef7085b8cc8476d77ff6406fa9741ffe24803ece9
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.