Przejdź do treści
Biblioteka skilli
Dokumenty i biuro · Przegląd i audyt

qa-quarto

/qa-quarto

Sprawdza zgodność HTML Quarto z benchmarkiem PDF, aż do zatwierdzenia lub braku nowych uwag.

Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Sprawdza zgodność HTML Quarto z benchmarkiem PDF, aż do zatwierdzenia lub braku nowych uwag.

Wyzwalacze z opisu

qa the quartocheck paritydoes the html match the pdf?quarto matches beamer?检查 Quarto 一致性HTML 和 PDF 一致吗

Argumenty

/qa-quarto [LectureN]
Oryginalny opis (EN)

对抗式检查 Quarto 与 Beamer 一致性。批评代理比较 Quarto HTML 渲染结果与 Beamer PDF 基准的内容和视觉效果;修复代理实施修改;循环直到 APPROVED,或连续两轮没有新增 CRITICAL/MAJOR,兜底上限 5 轮。用户说 "qa the quarto"、"check parity"、"does the html match the pdf?"、"quarto matches beamer?"、"检查 Quarto 一致性"、"HTML 和 PDF 一致吗",或在一次 translate-to-quarto 运行后使用。要求 `.qmd` 已渲染,并有 `.pdf` 基准。

Jak działa

  1. 输入
  2. 工作流
  3. 硬门禁(不可协商)
  4. 阶段 0:开始前检查
  5. 阶段 1:首轮审读
  6. 阶段 2:修复循环
  7. 阶段 3:复审
  8. 迭代上限——空轮收敛
  9. 最终报告
  10. 发现要经校验,而不只是写出来(v2.5)
Sekcje z nagłówków SKILL.md, w oryginale · 101 linii, 373 słów
Podgląd SKILL.md
---
name: qa-quarto
description: 对抗式检查 Quarto 与 Beamer 一致性。批评代理比较 Quarto HTML 渲染结果与 Beamer PDF 基准的内容和视觉效果;修复代理实施修改;循环直到 APPROVED,或连续两轮没有新增 CRITICAL/MAJOR,兜底上限 5 轮。用户说 "qa the quarto"、"check parity"、"does the html match the pdf?"、"quarto matches beamer?"、"检查 Quarto 一致性"、"HTML 和 PDF 一致吗",或在一次 translate-to-quarto 运行后使用。要求 `.qmd` 已渲染,并有 `.pdf` 基准。
description_zh: 对抗式检查 Quarto 与 Beamer 一致性。批评代理比较 Quarto HTML 渲染结果与 Beamer PDF 基准的内容和视觉效果;修复代理实施修改;循环直到 APPROVED,或连续两轮没有新增 CRITICAL/MAJOR,兜底上限 5 轮。用户说 "qa the quarto"、"check parity"、"does the html match the pdf?"、"quarto matches beamer?"、"检查 Quarto 一致性"、"HTML 和 PDF 一致吗",或在一次 translate-to-quarto 运行后使用。要求 `.qmd` 已渲染,并有 `.pdf` 基准。
argument-hint: "[LectureN]"
allowed-tools: ["Read", "Grep", "Glob", "Write", "Edit", "Bash", "Agent", "Task"]
---

# 对抗式 Quarto 与 Beamer QA 工作流

> **[本平台适配 · 2026-10-31] 这个技能刻意不声明 `context: fork`。**
> 声明该字段后,技能会进入 detached 子会话,而那个会话的工具集**没有 `Agent`**,
> 即使 `allowed-tools` 已申请也拿不到。本技能依靠「批评者 → 修复者 → 重审」
> 实现空轮收敛,每个透镜都必须在**独立上下文**中运行,避免相互污染,最后再归并结果。
> 没有 `Agent` 时,同一会话只能依次扮演这些透镜;报告看似完成了多角度审查,
> 实际只是同一双眼睛重复查看,而第二遍仍可能看不见第一遍漏掉的问题。
>
> 不 fork 也有代价:读文件、运行命令和试错等中间过程会占用主会话上下文,
> 长流程可能需要中途压缩一次。**这个代价换的是独立性,值。**
> 实测证据与复现命令见 [`platform-facts.md`](../../references/platform-facts.md) 的技能一节。

本技能通过迭代批评/修复循环,比较 Quarto HTML 幻灯片与 Beamer PDF 基准。

**理念:** Beamer PDF 是黄金标准,Quarto 译本在每个维度上都必须至少一样好。

---

## 输入

按 shell 引号规则对 `$ARGUMENTS` 分词,将可选位置参数 `LectureN` 赋给命名变量 `lecture`;未提供时设 `lecture=LectureN`。额外位置参数或任何未知旗标都必须拒绝:停止并报告用法错误,不得猜测。后续阶段只使用 `lecture`,不再读取原始参数串;所有由它派生的路径都必须以加引号的完整路径使用。

## 工作流

```
Phase 0: Pre-flight → Phase 1: Critic audit → Phase 2: Fixer → Phase 3: Re-audit → Loop until APPROVED or dry (2 consecutive rounds with no new CRITICAL/MAJOR; fallback cap 5)
```

## 硬门禁(不可协商)

| 门禁 | 条件 |
|------|-----------|
| **Overflow(溢出)** | 没有内容被裁切 |
| **Plot Quality(图形质量)** | 交互图表 >= 静态图 |
| **Content Parity(内容一致)** | 不缺幻灯片/公式/文字 |
| **Visual Regression(视觉回归)** | 所有维度上 Quarto >= Beamer |
| **Slide Centering(居中对齐)** | 内容居中,不跳动 |
| **Notation Fidelity(记号保真)** | 全部数学式与 Beamer 逐字一致 |

## 阶段 0:开始前检查

1. 定位 Beamer(.tex/.pdf)与 Quarto(.qmd/.html)文件。
2. 检查新鲜度;QMD 比 HTML 新时重新渲染。
3. 如适用,核验 TikZ SVG。
4. 度量本次渲染:`"${SLIDE_QA_PYTHON:-python}" scripts/slide-qa.py "Quarto/${lecture}.html"`。脚本在无头 Chrome 中加载整套幻灯片,写出 `quality_reports/audits/slide-qa/[Lecture]/report.md`,包含每页溢出的像素值和每页一张截图。退出码 1 表示发现问题,包括溢出、内容裁切、图片损坏、文件缺失或大小写错误。退出码 2 表示无法运行,通常因为缺少 Playwright;脚本会打印一次性的 venv 安装命令和需要设置的 `SLIDE_QA_PYTHON` 行。必须照实报告,此时批评代理改为读取源码。

## 阶段 1:首轮审读

启动 `quarto-critic` 代理,全面对比 Beamer 与 Quarto,并把阶段 0 的 slide-qa 报告路径传给它,供 Overflow 门禁使用。报告保存到 `quality_reports/[Lecture]_qa_critic_round1.md`。

## 阶段 2:修复循环

若结果不是 APPROVED,启动 `quarto-fixer` 代理按 Critical → Major → Minor 的顺序实施修改,然后重新渲染并核验。

## 阶段 3:复审

对修复代理重新渲染的结果再次运行 `scripts/slide-qa.py`,再把新报告交给重新启动的批评代理核验修改。必要时返回阶段 2。

## 迭代上限——空轮收敛

本技能采用 [`orchestrator-protocol.md`](../../rules/orchestrator-protocol.md) 的**空轮收敛**原语。批评代理返回 `FINDING`,硬门禁表是 CRITICAL 的汇总,见 [`orchestration-schemas.md`](../../references/orchestration-schemas.md)。**同一轮内按 `id = sha1(file:line:locus)` 去重;跨轮按 `file` + `locus` 判断是否新增**,因为修复会移动行号,不能拿含行号的 id 做跨轮身份。循环在**连续 2 个空轮后收敛**;空轮指与此前轮次按 `file` + `locus` 比较后,新增 0 条 CRITICAL/MAJOR 发现。循环不会仅因达到固定轮数而停止。

- **兜底上限:**不收敛的循环最多运行 5 轮,随后带着剩余问题升级给用户。
- **两次命中:**同一发现按 `file` + `locus` 判定,在第 N 轮和第 N+2 轮都存在时,标记给用户,不再打第三次补丁;不得按是否属于同一门禁判定([`summary-parity.md`](../../rules/summary-parity.md))。
- 当且仅当每个硬门禁都通过,且没有剩余 CRITICAL 或 MAJOR 发现时,结果才是 APPROVED;minor 发现仍列出给用户。

## 最终报告

保存到 `quality_reports/[Lecture]_qa_final.md`,包含硬门禁状态、迭代摘要和剩余问题。

## 发现要经校验,而不只是写出来(v2.5)

审读者必须按照 [`finding-schema.json`](../../references/finding-schema.json) 的机器校验契约输出发现。报告是 JSON **数组**。

**投入审读成本前,先对这套装置做冒烟测试。**若扇出审读者后无法写出合法报告,整轮工作都会浪费:

```bash
echo '[]' | python scripts/validate-findings.py
```

审读代理只读,因此**由本技能写文件**。收到每个审读者的最终响应后,把散文报告保存到指定路径,把响应末尾的围栏 `json` 块复制到草稿文件,并在校验时填入 id:

```bash
python scripts/validate-findings.py --fill-ids block.json > <report>.json.tmp \
  && mv <report>.json.tmp <report>.json || rm -f <report>.json.tmp   # exit 0 required; a failed run keeps no file
python scripts/validate-findings.py --check-quotes <report>.json   # each quote must be the file's own text (orchestration-schemas.md §1)
```

审读者未返回 `json` 块,或返回内容未通过校验,就等于没有完成审读。带上校验器错误文本重新派发一次;若仍失败,把该透镜记为缺失,不得在缺少它的情况下归并。

契约要求及理由如下:

- **`rule`**:被违反的成文规则或标准。没有引用规则的发现只是意见,不能为提交把关。
- **`failing_case`**:一个会使断言失效的具体配置,或确切缺失的前提。*"This could be clearer"* 无法通过校验。
- **`id = sha1("<file>:<line>:<locus>")`**:确定性 id 用于同一轮内精确去重;跨轮改用 `file` + `locus`,因为修复会改变行号。两次即止规则也按跨轮身份机械检查,不靠肉眼。
- **`mechanical`**:只有不可能改变结果的修改,例如错字、交叉引用、格式和标签,才为 `true`。涉及估计目标、假设、设定、推断程序、样本定义或报告语言时,**永远**不为 true;这些必须退回研究者。

校验*之前*,先应用 [`orchestration-schemas.md` §7](../../references/orchestration-schemas.md) 的**逐透镜证据负担**和**「不算数」过滤器**,避免已知误报进入裁决。核验阶段应**优先尝试反驳**,并设置每条发现的 `verdict`,审读者留空。只有 `verdict: "confirmed"` 的发现可以发布;无法找到依据的发现一律丢弃,不能降级为警告。

Wersje

RepozytoriumWynikLicencja
Ta strona · Sellyew/Workbuddy-workflow100MIT
pedrohcgs/claude-code-my-workflow100MIT

Migawka bazy z 13.11.2026 · wersja paczki 08b193ec76b9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90translate-to-quarto
    Zamienia wykład Beamer w pliku .tex na lustrzaną wersję Quarto RevealJS .qmd: wyciąga TikZ, tłumaczy strony i sprawdza spójność.
  • 90translate-to-quarto
    Tłumaczy wykład Beamer w .tex na lustrzany Quarto RevealJS w .qmd: ekstrakcja TikZ, tłumaczenie slajd po slajdzie, konwersja cytowań i automatyczna kontrola zgodności z wynikiem w katalogu Quarto.
  • 96quarto
    Konwertuje dokumenty docx na projekt Quarto, który da się skompilować do gotowego raportu.
  • 90deploy
    Renderuje slajdy Quarto z plików .qmd do HTML i synchronizuje je do katalogu docs dla GitHub Pages po zmianach, które mają trafić do publikacji.
  • 100quarto-authoring
    Wspiera pracę z Quarto: pliki .qmd, _quarto.yml, projekty, callouty, odwołania, cytowania, diagramy Mermaid, rozszerzenia, strony, książki, prezentacje i migracja z R Markdown, bookdown i Jupyter.
  • 100quarto-revealjs
    Buduje prezentacje HTML w Quarto Reveal.js: szablony, motywy SCSS, notatki prelegenta, fragmenty, podświetlanie kodu i eksport do PDF.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.