Skill 寫法圖鑑

slidex-deck-qa

zz41354899 | 測試與驗證 | 原文 | MIT

完成前驗證並目視檢查 OpenSlideX deck 的溢出、對比與素材

中文翻譯

---
name: slidex-deck-qa
description: 驗證並以視覺檢查可編輯的 OpenSlideX deck。在完成前、來源或設計有重大變更後,以及要審查溢出、重疊、對比、素材、montage、動態、證據或匯出就緒程度時使用。
---

# OpenSlideX Deck QA

來源格式有效是必要條件,但絕對不能取代渲染後的實際證明。

## Required reference

讀 [the review matrix](references/review-matrix.md)。套用每一項 release blocker,以及和 deck 來源類型相關的檢查。

## Acceptance loop

1. 用 `open_slidex_read` 確認所選的 deck、目前的 revision 和確切的來源範圍。
2. 做編輯時,依賴 `open_slidex_edit`:它會驗證、渲染、做視覺檢查,而且只有候選版本通過時才會以原子方式寫入。
3. 如果被拒絕,用回報的投影片、code、node ID 和指標修正同一個候選版本。做了兩次有針對性的修正嘗試後就停下,並回報剩下的阻礙。
4. 純審查的工作,呼叫 `open_slidex_review`,並檢視完整的 montage 加上每一張有實質變動的投影片。
5. 做一輪證據檢查和一輪視覺檢查。兩者都通過,而且編譯後的 React deck 保有預期的層次,這份 deck 才算完成。

超過 20 頁的 deck,要檢視完整的 montage 和每一張投影片,不是只抽樣檢查。瀏覽器原生的 HTML,要驗證標準頁數、每個對應頁面都有一張縮圖,以及在全螢幕播放中檢查第一頁、中間頁、最後一頁和章節交界頁。

只要有視覺 QA 可用,沒有通過的渲染預覽就絕對不要宣告完成。

英文原文

---
name: slidex-deck-qa
description: Validate and visually inspect editable OpenSlideX decks. Use before completion, after material source or design changes, and for overflow, overlap, contrast, asset, montage, motion, evidence, or export-readiness review.
---

# OpenSlideX Deck QA

Source validity is necessary but never substitutes for rendered proof.

## Required reference

Read [the review matrix](references/review-matrix.md). Apply every release
blocker and the checks relevant to the deck's source type.

## Acceptance loop

1. Confirm the selected deck, current revision, and exact source scope with
   `open_slidex_read`.
2. For an edit, rely on `open_slidex_edit`: it validates, renders, visually
   checks, and writes atomically only when the candidate passes.
3. If rejected, repair the same candidate using the reported slide, code,
   node IDs, and metrics. Stop after two focused repair attempts and report the
   remaining blocker.
4. For review-only work, call `open_slidex_review` and inspect the complete
   montage plus every materially changed slide.
5. Do one evidence pass and one visual pass. A deck is complete only when both
   pass and the compiled React deck preserves the intended hierarchy.

For a deck longer than 20 pages, inspect the complete montage and every slide,
not only a representative sample. For browser-native HTML, verify the canonical
page count, one thumbnail per mapped page, and first, middle, last, and section
boundary pages in full-screen playback.

Never declare completion without an accepted rendered preview when visual QA is
available.