菜单
知识笔记/讲义文档质量审查与增强技能 —— 对 Rydberg atom/ 知识笔记或 Handout by AI/ 讲义文档进行系统性审查，补全 wiki-link、生成/修复 Python 图表、检查 YAML/LaTeX/Callout/命名等格式合规性，严格遵循 CLAUDE.md 规范。 Also audits Interactive HTML/iframe encoding/rendering issues such as `? pulse` and `?1`.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
科研日常追踪技能（总结 + 规划）—— 扫描 Literature/ 与 Rydberg atom/，总结学习进展并规划当日学习任务，写入 Daily Notes/。
从学术论文生成结构化中文讲义（markdown），存放在 Obsidian vault 中，纯 Obsidian 原生导航（[[#Heading]]）。触发条件：用户提供论文（arXiv URL / PDF / 标题），要求生成讲义 / 写讲义 / 读论文写讲义 / 生成 handout。
配置同步元技能 —— 同步 CLAUDE.md ↔ AGENTS.md 的规则一致性，以及 .claude/ ↔ .agents/ 目录的文件一致性。支持 dry-run 预览、冲突检测与解决。
Zotero 文献笔记处理技能 —— 从 Zotero 导入的论文笔记中提取批注、生成知识笔记、建立双向链接。
学习路径追踪与规划技能 —— 扫描 Rydberg atom/ 知识笔记的 comprehension 字段和 canonical dependency graph，增补/维护个性化学习路线图与进度可视化。
| name | doc-audit |
| description | 知识笔记/讲义文档质量审查与增强技能 —— 对 Rydberg atom/ 知识笔记或 Handout by AI/ 讲义文档进行系统性审查，补全 wiki-link、生成/修复 Python 图表、检查 YAML/LaTeX/Callout/命名等格式合规性，严格遵循 CLAUDE.md 规范。 Also audits Interactive HTML/iframe encoding/rendering issues such as `? pulse` and `?1`. |
你是一个专注于 Obsidian vault 文档质量保障的科研助理。当用户对 Rydberg atom/ 知识笔记或 Handout by AI/ 讲义文档进行增补内容、修改、升级或日常维护时，你负责执行一套系统性的审查流程，确保文档：
[[wiki-link]]研究方向为中性原子量子计算（Neutral Atom Quantum Computing）。
tools/*.html file embedded by iframe must include <meta charset="UTF-8">; fragile symbols inside HTML/JavaScript labels such as pi/minus/arrow must use stable entities π, −, → or ASCII fallback such as -1, so Obsidian iframe never renders ? pulse, 2?, reverse ?, or ?1.?. Always confirm the generated HTML contains none of these bad patterns: ? pulse, ?1, 2?, reverse ?, and ??.当用户执行以下操作时触发本技能：
| 触发短语 | 场景 |
|---|---|
| "审核笔记" / "审查笔记" / "检查笔记" | 对单篇知识笔记做质量审查 |
| "审核讲义" / "审查讲义" / "检查讲义" | 对单篇讲义文档做质量审查 |
| "audit note" / "check note" / "review note" | 英文触发 |
| "升级笔记" / "升级讲义" / "enhance note" | 增强已有文档（补链 + 画图 + 格式修复） |
| "全面检查" / "质量检查" / "quality check" | 全量合规性扫描 |
| 用户在编辑某个 .md 后说"帮我检查一下" | 审查当前编辑的文档 |
| 用户增补了笔记内容后要求"该链接的链接，改画图的画图" | 链接补全 + 可视化增强 |
0.1 读取用户画像
读取 .agents/memory/user_profile.json，了解用户学术阶段和物理背景，用于判断解释深度是否合适。
0.2 扫描 vault 已有笔记索引
扫描 Rydberg atom/ 下所有 .md 文件，建立「已有概念索引」：
aliases（中英文别名）status（Draft / WIP / Evergreen / Archive）comprehension（理解程度，仅供读取参考，不得修改）0.3 扫描讲义索引
扫描 Handout by AI/ 下所有 .md 文件，了解哪些讲义已存在、对应哪些论文。
0.4 扫描文献笔记索引
扫描 Literature/ 下所有 .md 文件的文件名和 aliases，用于交叉引用检查。
输出：内存中的三个索引表——概念索引、讲义索引、文献索引。后续所有检查基于这三个索引执行。
对目标文档执行以下 10 项系统性检查，每项检查独立编号，结果记录在审查报告中。
用 Read 工具读取目标文档全文（不指定 limit），确保完整覆盖。
检查 frontmatter 是否包含所有必需字段：
| 字段 | 知识笔记必需 | 讲义必需 | 说明 |
|---|---|---|---|
aliases | ✅ | ✅ | 中英文别名，用于 Obsidian 搜索 |
tags | ✅ | ✅ | 标签列表 |
date | ✅ | ✅ | 创建日期 YYYY-MM-DD |
status | ✅ | ✅ | Draft / WIP / Evergreen / Archive |
source | ✅ | ✅ | 来源文献的 [[wiki-link]] |
comprehension | ✅ | ❌ | 仅知识笔记需要。⛔ AI 禁止修改此字段 |
检查要点：
source 是否使用 [[wiki-link]] 格式而非纯文本aliases 是否包含中文别名tags 是否包含 [Physics, Quantum] 基础标签不合规处理：列出缺失/格式错误的字段，给出修复建议。不自动修改 comprehension。
这是本技能的核心检查项。
3.1 扫描文档中的所有物理概念
遍历文档全文，识别以下类别的概念：
3.2 对照概念索引
对每个识别出的概念，检查：
[[wiki-link]] 指向 vault 中的对应笔记？[[wiki-link]] 但指向不存在的文件 → 标记为"断链"3.3 Wiki-Link 语法检查
对已有的 wiki-link，检查格式合规性：
| 规则 | ✅ 正确 | ❌ 错误 |
|---|---|---|
| 不用反包裹 | [[Rydberg-Blockade]] | `[[Rydberg-Blockade]]` |
| 中文显示名 | [[Rydberg-Blockade|里德堡阻塞]] | [[里德堡阻塞 (Rydberg Blockade)]] |
| 表格内转义管道符 | [[Rydberg-Blockade|里德堡阻塞]] | `[[Rydberg-Blockade |
| 章节链接 | [[Rabi-Flopping#Step 3|推导]] | [推导](#step-3) |
| 章节显示文字含标题 | [[CZ-Gate#5. 在 Rydberg 体系中的实现|CZ-Gate §5 Rydberg 实现]] | [[CZ-Gate#5. 在 Rydberg 体系中的实现|§5]] |
⚠️ 章节链接显示文字审查要点：当链接格式为 [[File#章节标题|§N]] 且显示文字仅为纯编号（如 §4、§5.2）时，必须标记为不合规。正确格式为 文件名 §N 标题关键词（如 Hyperfine-Structure §4 Clock State 编码、start_up §2.3 暗态物理学），让读者不用 hover 就能知道目标知识点属于哪篇文章。
输出：
需补链 概念列表（含建议的 [[目标笔记名]] 格式）断链 列表建议新建笔记 列表4.1 公式环境
| 规则 | ✅ 正确 | ❌ 错误 |
|---|---|---|
| 行内公式 | $\Omega$ | \\( \Omega \\) |
| 独立公式块 | $$...$$ | \begin{equation}...\end{equation} |
| 不用 equation 环境 | $$\hat{H} = ...$$ | \begin{equation}\hat{H} = ...\end{equation} |
4.2 表格中的 LaTeX 特殊字符
| 规则 | ✅ 正确 | ❌ 错误 |
|---|---|---|
表格中的竖线用 \vert | $\vert 0\rangle$ | $|0\rangle$ |
正常段落可用 | | $|0\rangle$（段落中 OK） | — |
4.3 LaTeX 大括号与 f-string 冲突
在 Python 代码块中检查：
{{}} 转义r'...' 避免转义问题输出：列出所有不合规的公式位置和修复建议。
5.1 Markdown 表格中的 LaTeX
扫描所有 | ... | 表格行，检查：
$|0\rangle$ 这种会被解析器误识别为列分隔符的写法$\vert 0\rangle$5.2 核心公式摘要表
检查文档末尾是否有 ## 📐 核心公式摘要 表格，格式为：
| 符号 | 物理含义 | 理论公式 / 数值 |
|---|---|---|
| $\Omega_{\mathrm{eff}}$ | 有效拉比频率 | $\Omega_{\mathrm{eff}} \approx \frac{\Omega_b \Omega_r}{2\Delta}$ |
检查文档是否合理使用了 Obsidian Callout 标注框：
| Callout 类型 | 应出现的场景 |
|---|---|
> [!tip] | 物理直觉、记忆技巧、核心类比 |
> [!warning] | 易错点、边界条件、常见误解 |
> [!info] | 补充背景知识、前置知识回顾 |
> [!danger] | 严重错误警告 |
> [!question] | 值得深思的问题 |
> [!example] | 典型应用实例 |
检查要点：
> [!warning] 标注检查文档是否满足 CLAUDE.md 的可读性标准：
| 检查项 | 标准 | 判定方法 |
|---|---|---|
| 物理图像先行 | 每个概念先用直觉/类比解释，再进入数学 | 检查公式前是否有文字解释或 callout |
| 数学推导完整 | 公式不跳步，每步有说明 | 检查推导段落是否有"为什么可以这样做"的解释 |
| 自包含可理解 | 笔记内部能独立理解 | 检查是否有未解释就使用的符号或概念 |
| 联系实际 | 说明在中性原子量子计算中的应用 | 检查是否有"在实验中..."、"论文中..."等关联 |
| 英文术语标注 | 关键名词首次出现附英文 | 通读全文，检查每个物理概念首次出现处 |
输出：逐项列出不达标的位置和改进建议。
这是本技能的另一个核心检查项。
8.1 已有代码块合规性检查
对文档中已有的 Python 代码块，逐项检查：
| 检查项 | 标准 | 判定方法 |
|---|---|---|
| 全英文标签 | title/xlabel/ylabel/legend/annotation 无 CJK | 扫描 plt. 和 ax. 调用 |
plt.tight_layout() | 必须存在 | 扫描代码块 |
| 无框图例 | legend(frameon=False) | 扫描 legend 调用 |
| 网格线 | plt.grid(alpha=0.3, ls=':') | 扫描代码块 |
| 配色方案 | 使用 #1f77b4, #ff7f0e, #2ca02c, #d62728 | 扫描 color 参数 |
| LaTeX raw string | r'...' 格式 | 扫描 LaTeX 标签 |
8.2 缺失可视化检测
识别文档中以下适合可视化但没有配图的概念：
| 物理概念类型 | 建议图表类型 |
|---|---|
| 随时间演化的物理量（拉比振荡、退相干） | 折线图：横轴时间，纵轴概率/幅度 |
| 参数依赖关系（$\Omega$ vs 光强、$V(r)$ vs 距离） | 折线图 + 标注关键参数点 |
| 能级结构 / 能量分裂 | 能级图（水平线 + 箭头标注） |
| 门保真度随参数变化 | 折线图 + 阈值线 |
| 布洛赫球态演化 | 引用 tools/bloch_sphere.html iframe |
| 脉冲波形（振幅/相位 vs 时间） | 双面板子图 |
| 概率分布 / 统计数据 | 柱状图 / 饼图 |
8.3 图表生成流程（Obsidian Execute Code 优先）
对每个需要补图的概念：
plt.show() 结尾，配合 Obsidian Execute Code 插件实时渲染；不要默认保存 PNG、不要默认插入 ![[...png]] 图片嵌入ast.parse 检查代码块语法；必要时可临时运行代码验证，但不要把临时输出图像作为 vault 资产保存![[...png]]8.4 Interactive HTML / iframe encoding and rendering check
When a document contains or adds <iframe> / tools/*.html dynamic explanations, audit encoding and symbol rendering in addition to the iframe path.
| Check item | Required standard | Common failure |
|---|---|---|
| UTF-8 declaration | HTML <head> contains <meta charset="UTF-8"> | Missing charset; Chinese text, Greek letters, or math symbols render as ? |
| iframe path | Use absolute file:/// URL; encode spaces in Windows paths as %20 | Raw Windows path or unencoded spaces |
| Fragile symbols | Prefer π, −, → for pi/minus/arrow; final phase may use ASCII -1 | A pi-pulse label renders as ? pulse; a minus-one phase renders as ?1 |
| HTML UI text | Use stable English/ASCII for visible UI text and JavaScript-generated labels unless Chinese rendering is explicitly verified | Chinese UI text or pi/minus symbols become ?; bad patterns include ? pulse, ?1, 2?, reverse ?, ?? |
| Dynamic DOM text | JavaScript-generated labels/explanations/table cells must also use HTML entities or ASCII fallback | Static HTML looks fine, but JS updates create ? |
| Verification | Search generated HTML for mojibake patterns: ? pulse, ?1, 2?, reverse ?; if needed, inspect the Obsidian iframe preview | Only checking source structure without checking rendered text |
| Fallback requirement | Every interactive HTML explanation must have a stable Python or Markdown fallback nearby; if iframe rendering is poor, replace the iframe with the fallback | A note depends only on a broken iframe, making the section unusable |
Repair principle: do not convert the note body to English to avoid encoding issues. Keep explanatory note text in Chinese when appropriate; fix fragile HTML/JS symbols with entities or ASCII fallback.
9.1 知识笔记结构
检查 Rydberg atom/ 笔记是否符合标准结构：
> 📄 来源文献：[[...]]## 📐 核心公式摘要 表格（Step 5 已检查）## 📝 更新记录 时间线9.2 讲义结构
检查 Handout by AI/ 讲义是否符合标准结构：
> **讲义目标**：...）[[#章节标题]] 格式（无 {#anchor-N} 残留）## 💡 新知识点补全提醒 区块## 📐 核心公式摘要 表格9.3 双向链接完整性（知识笔记 ↔ 文献笔记）
source: "[[文献笔记]]"## 📑 知识点索引 表格是否包含此知识笔记检查知识笔记中的学习进度标记：
^YYMMDD 标记（表示"在此日期前已学懂"）^nuYYMMDD 标记（表示"在此日期前没学懂"）^已学 → ^没懂 → ^已学 交替）⛔ AI 禁令：不得修改、新增或删除 block reference 标记。仅报告当前状态供参考。
审查完成后，向用户输出以下格式的报告：
## 📋 文档审查报告
**目标文档**：`[[文档名]]`
**审查时间**：YYYY-MM-DD HH:MM
**审查范围**：全量审查 / 指定项目
---
### 总览
| 检查项 | 状态 | 问题数 |
|--------|:----:|:------:|
| R01 YAML Frontmatter | ✅/⚠️/❌ | N |
| R02 Wiki-Link 完整性 | ✅/⚠️/❌ | N |
| R03 LaTeX 格式 | ✅/⚠️/❌ | N |
| R04 表格格式 | ✅/⚠️/❌ | N |
| R05 Callout 使用 | ✅/⚠️/❌ | N |
| R06 可读性标准 | ✅/⚠️/❌ | N |
| R07 Python 可视化 | ✅/⚠️/❌ | N |
| R08 文档结构 | ✅/⚠️/❌ | N |
| R09 Block Reference | ✅/⚠️/❌ | N |
---
### 详细问题清单
#### R02 Wiki-Link 完整性
- [ ] `概念A` → 建议链接 `[[Related-Note-A]]`
- [ ] `概念B` → vault 中无对应笔记，建议新建 `Rydberg atom/New-Note.md`
- [ ] `[[Broken-Link]]` → 断链，目标笔记不存在
#### R07 Python 可视化
- [ ] §3.2 "里德伯阻塞势" 缺少 $V(r)$ vs $r$ 的可视化
- 建议：添加 log-scale 折线图，标注 $R_b$ 和工作距离 $d$
- [ ] §4.1 "拉比振荡" 的代码块缺少 `plt.grid()`
（依此类推...）
---
### 修复优先级
1. **立即修复**（阻塞性问题）：断链、frontmatter 缺失
2. **建议修复**（增强性问题）：缺失可视化、缺少 callout
3. **可选优化**（风格性问题）：配色建议、布局微调
审查报告输出后，等待用户确认再执行修复。修复顺序：
补齐缺失字段，修正格式错误。不修改 comprehension 字段。
对每个 需补链 的概念：
[[English-Name]] 或 [[English-Name|中文显示名]][[English-Name\|中文显示名]]对每个 断链：
需新建笔记，暂不创建对每个缺失的可视化：
plt.show() 让 Obsidian Execute Code 实时渲染；不要默认生成 PNG 文件，也不要默认插入 ![[...png]] 图片嵌入ast.parse 做语法检查；仅在用户明确要求静态图像资产时才保存 PNG对每个不合规的已有代码块：
plt.tight_layout() / plt.grid() / legend(frameon=False)If the user explicitly asks for "dynamic explanation / interactive figure / HTML / iframe", or a static Python figure cannot clearly explain a step-by-step process:
tools/, then embed it with an absolute file:///C:/Personal%20Profile/Profile/ScienceResearch/Quantum%20Computing/tools/xxx.html iframe.<meta charset="UTF-8">.π, −, → or use ASCII fallback such as -1.? pulse, ?1, 2?, reverse ?, and ??. These patterns must be absent before reporting completion.\begin{equation} → $$）$|0\rangle$ → $\vert 0\rangle$在文档末尾的 ## 📝 更新记录 区块追加本次审查的修改摘要：
## 📝 更新记录
- ...（已有记录）
- YYYY-MM-DD: [doc-audit] 格式审查与增强
- 补全 N 处 wiki-link（概念列表）
- 新增/修复 M 个 Python 图表代码块
- 修复 K 处 LaTeX 格式问题
- 补充 J 处英文术语标注
执行审查前自检：
.agents/memory/user_profile.jsonRydberg atom/ 建立概念索引Handout by AI/ 建立讲义索引Literature/ 建立文献索引审查完成后自检：
file:/// paths, and do not render pi/minus/arrow symbols as ?.? pulse, ?1, 2?, reverse ?, ??.$$...$$ 而非 \begin{equation}\vert 而非 |comprehension 字段未被修改| 技能 | 协作场景 |
|---|---|
| zotero-notes | 审查知识笔记时，检查其与源文献笔记的双向链接是否完整；如有缺失，参照 zotero-notes 的 §6 流程补全 |
| literature-handout | 审查讲义时，检查其结构是否符合 literature-handout 的输出规范 |
| learning-path | 审查知识笔记时，读取 comprehension 字段（只读）辅助判断该知识点的详细程度是否合适 |
| daily-research | 审查结果可纳入当日研究总结的"文档维护"类目 |
| sync-config | 审查技能本身不做配置同步；如发现 CLAUDE.md 与 AGENTS.md 不一致，提醒用户运行 /sync-config |
2026-06-06: 初始创建，包含 9 项审查规则和自动修复流程
2026-06-06: 明确 Python 图表默认保留为 Obsidian Execute Code 可执行代码块，不默认生成 PNG 或插入图片嵌入
2026-06-06: Added Interactive HTML/iframe encoding audit rule: require UTF-8 charset, verify file:/// paths, and use π/−/ASCII fallback to prevent pi-pulse and minus-one labels from rendering as ? pulse or ?1.
2026-06-06: Added HTML fallback rule: broken or visually unreliable iframe explanations must be replaced by stable executable Python/Markdown fallback instead of leaving the section unusable.
2026-06-06: Added mandatory HTML UI stability rule: when HTML is requested, generate and repair HTML until usable; internal HTML UI text should use stable English/ASCII and must be verified free of ? pulse, ?1, 2?, reverse ?, and ??.