universal-dev-standards 6.14.0-beta.2 → 6.14.0-beta.4

package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md

@@ -0,0 +1,289 @@
+---
+name: comprehend
+source: ../../../../skills/comprehension-ladder/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-10-05
+source_hash: 7c69dc2bfc9f
+status: current
+scope: universal
+description: |
+  [UDS] 把一段難懂的 AI 輸出換成較好懂的形式：受控文字、Mermaid 圖、單檔 HTML 解說頁。所有形式都來自同一份大綱，所以形式會變，事實不會變。
+  Use when: AI 的說明、規格或程式碼解說太密、讀的人看不出該不該核准；非專業的人必須靠它做核准；想要它的圖或離線解說頁。
+  Not for: 寫新內容或加新分析——本技能只把既有的文字換形式；從原始碼產生文件——請用 /docgen；為專家讀者縮短文字——直接改寫即可。
+  Keywords: comprehension ladder, explainer, controlled language, Mermaid, HTML explainer, outline, plain language, understand AI output, 理解階梯, 受控語言, 流程圖, 解說頁, 換形式不換事實.
+allowed-tools: Read, Glob, Grep, Write
+argument-hint: "[text or file | 原文或檔案] [rungs: 1 | 2 | 3]"
+---
+
+# 理解階梯
+
+> **語言**: [English](../../../../skills/comprehension-ladder/SKILL.md) | 繁體中文 | [简体中文](../../../zh-CN/skills/comprehension-ladder/SKILL.md)
+
+**版本**: 1.0.0 | **最後更新**: 2026-10-05 | **適用**: Claude Code Skills
+
+把一段難懂的 AI 輸出換成較好懂的形式。形式會變，事實不會變。
+
+## 目的
+
+現在慢的不是拿到答案，而是看懂答案並判斷它。本技能幫忙這一步。它拿一份原文，最多做出三種形式，每一種叫一「階」。
+
+本技能的文字依 [ai-response-navigation](../../core/ai-response-navigation.md) 第 12 條（受控語言）寫成。它自己也遵守自己的防護。
+
+## 階梯
+
+階梯正好有三階。每一階都從同一份大綱產生（見[大綱](#大綱)）。任何一階都不得在大綱之外加東西。
+
+| 階 | 形式 | 適合 | 產出 |
+|----|------|------|------|
+| 1 | 受控文字 | 任何原文。永遠是第一階 | 短句或編號列，放在對話或檔案裡 |
+| 2 | Mermaid 圖 | 有流程、先後順序、多個角色，或 3 個以上選項的原文 | 一個 Mermaid 程式碼區塊，外加一份畫不出來的項目文字清單 |
+| 3 | 單檔 HTML 解說頁 | 需要探索或核准的讀者 | 一個可離線開啟的 `.html` 檔 |
+
+先問使用者要哪幾階。使用者沒說，就先做第 1 階，再提議另外兩階。
+
+沒有影片階。影片需要語音服務，而且會把原文送給第三方。
+
+## 三條防護
+
+這三條防護**必須**遵守。破壞任何一條的那一階，就還沒做完。不得交出去。
+
+| 編號 | 防護 | 等級 |
+|------|------|------|
+| G1 | `no-new-facts`：不加原文沒有的事實 | **必須（Required）** |
+| G2 | `keep-hedges`：保留每一個不確定語氣。不得把不確定的說法改成確定 | **必須（Required）** |
+| G3 | `trace-and-gaps`：每一項都附「對應原文哪一段」與「沒涵蓋什麼」 | **必須（Required）** |
+
+G2 與 [ai-response-navigation](../../core/ai-response-navigation.md) 的 12.1 條是同一條規則。這裡把它用在本技能的三階。
+
+### G1 `no-new-facts`（必須）
+
+每一階的每一個說法都必須來自原文。不要加原因、數字、名字、日期或「已確認」。不要加你知道、但原文沒寫的背景。
+
+**正例**——原文寫：「訂單有時會在付款步驟失敗。」
+
+```text
+O1  訂單有時會在付款步驟失敗。
+```
+
+**反例**——同一份原文：
+
+```text
+O1  訂單會在付款步驟失敗。這也會讓退款壞掉。
+```
+
+「退款」是新增的事實。「有時」也不見了，所以 G2 同時被破壞。
+
+### G2 `keep-hedges`（必須）
+
+不確定語氣告訴讀者，一個說法可以信到什麼程度。例如：可能、推斷、大概、尚未確認、might、could、probably。它是資訊，不是贅字。
+
+- 原文寫「可能」，這一階就寫「可能」。
+- 圖裡也要保留。不確定的項目用虛線畫，標籤裡留下那個詞。
+- HTML 裡也要保留。不確定的項目要顯示看得見的「尚未確認」標記。
+- 只有在原文自己說這個說法已經驗證時，才可以拿掉不確定語氣。這時要寫出檢查了什麼。
+
+**正例**——原文寫：「原因可能是快取留著舊的價目表。」
+
+```text
+O2  原因可能是快取留著舊的價目表。   [hedge: 可能]
+```
+
+**反例**——同一份原文：
+
+```text
+O2  原因是快取留著舊的價目表。
+```
+
+反例比較短，也比較好讀。但它與原文不符。讀的人若憑這一行核准修復，就被誤導了。
+
+### G3 `trace-and-gaps`（必須）
+
+每一項都帶兩個註記：
+
+- **對應原文**：這一項出自原文的哪個位置。用段落與句子編號，或檔名與行號，再加一段 12 個詞以內的引文（中文約 20 字以內）。
+- **沒涵蓋**：這一項沒說到什麼，或它證明不了什麼。原文沒有更多內容時，寫「原文沒有更多內容」。
+
+最後一項之後，加一份清單，叫做**這份大綱沒有收的部分**。它列出原文中所有沒變成項目的部分。
+
+**正例**
+
+```text
+O3  我們尚未在測試環境重現這個問題。
+    對應原文：第 1 段第 3 句——「尚未在測試環境重現」
+    沒涵蓋：為什麼沒有重現。原文沒有給理由。
+```
+
+**反例**
+
+```text
+O3  這個問題已在測試環境重現。
+    對應原文：那份報告。
+```
+
+「那份報告」沒有指向某個位置。這個說法也與原文相反。而且沒有「沒涵蓋」註記。
+
+## 大綱
+
+大綱是唯一共用的事實來源。先做大綱，再做任何一階。不要直接從原文寫某一階。
+
+每個大綱項目有一個編號和一個種類。
+
+| 種類 | 意思 |
+|------|------|
+| `claim` | 原文提出的說法 |
+| `mechanism` | 一個步驟、一個原因，或兩件事之間的關聯 |
+| `uncertainty` | 原文說不知道或尚未確認的事 |
+| `example` | 原文拿來說明某個說法的案例 |
+
+每個項目寫成這個樣子：
+
+```text
+O<編號> | 種類 | 文字 | hedge: <原文的不確定用詞，或 none>
+  對應原文：<位置> — 「<引文，12 個詞以內>」
+  沒涵蓋：<這一項沒說到的事>
+```
+
+依原文的順序編號。編號不得重複使用。三階都用同一組編號。
+
+## 工作流程
+
+### 步驟 1——讀原文
+
+讀完整份原文。原文是檔案，就讀那個檔案。讀完之前，不要開始做大綱。
+
+### 步驟 2——建立大綱
+
+抽出項目。一項一個事實。每個不確定用詞都要原樣抄下。
+
+### 步驟 3——為每一項標出處
+
+為每一項寫「對應原文」與「沒涵蓋」。再寫「這份大綱沒有收的部分」清單。
+
+### 步驟 4——把大綱給使用者看
+
+項目超過 5 個，或使用者要求時，就把大綱給使用者看。讓使用者刪除或修正項目。使用者否決的大綱，不要拿去做任何一階。
+
+### 步驟 5——做出各階
+
+使用者要哪幾階，就做哪幾階。照下面各階的規則做。
+
+#### 第 1 階：受控文字
+
+照 [ai-response-navigation](../../core/ai-response-navigation.md) 的 12.2 條：
+
+- 一句一件事。英文約 15 到 25 個詞，中文約 25 到 40 個字。
+- 一物一名。不要為了文采換名稱。
+- 寫清楚誰做什麼。
+- 一步一動作。流程寫成編號列表。
+- 少用分號。
+- 數字要帶單位。
+
+每一行開頭保留項目編號，讀的人才找得到它在大綱裡的位置。
+
+#### 第 2 階：Mermaid 圖
+
+1. 步驟與因果用 `flowchart TD`。角色與交接用 `flowchart LR`。
+2. 每個 `mechanism` 項目畫一個節點。用項目編號當節點編號。
+3. 節點標籤取自項目文字。標籤裡要留下不確定用詞。
+4. 不確定的項目畫成虛線節點或虛線邊（`-.->`）。
+5. 不要畫沒有大綱編號的節點。
+6. 在圖的下面，用文字列出你沒有畫的每一項，並各附一個理由。
+
+```mermaid
+flowchart TD
+  O1["O1 訂單有時在付款步驟失敗"]
+  O2["O2 可能：快取留著舊的價目表"]
+  O1 -.-> O2
+```
+
+#### 第 3 階：單檔 HTML 解說頁
+
+頁面必須是一個檔案。必須能離線開啟。不得從網路載入任何東西。
+
+頁面**必須**符合：
+
+- 所有 CSS 都放在一個 `<style>` 元素裡。
+- 所有指令碼（若有）都放在一個內嵌的 `<script>` 元素裡。關掉指令碼，頁面仍要能用。
+- `src`、`href`、`action`、`@import`、`url()` 裡不得有 `http://`、`https://` 或 `//` 開頭的網址。只允許頁內的 `#` 錨點連結。
+- 不得有 `<link>` 元素。不得有網路字型、CDN 或外部圖片。
+- 不得呼叫 `fetch`、`XMLHttpRequest`、`WebSocket` 或 `import()`。
+- 不要載入 Mermaid 函式庫。把圖畫成內嵌 SVG，或畫成有樣式的清單。
+- 原文中 HTML 會當成標記的字元，都要跳脫。
+
+頁面依序包含：
+
+1. 標題，加一句話說明原文是什麼。
+2. 圖（若使用者要了第 2 階）。
+3. 每個大綱項目一張卡片。卡片顯示編號、文字、有不確定語氣時的「尚未確認」標記、對應原文，以及沒涵蓋註記。
+4. 「這份大綱沒有收的部分」清單。
+
+最小骨架：
+
+```html
+<!doctype html>
+<html lang="zh-Hant">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>解說頁：原文的簡短名稱</title>
+<style>
+  body { font: 16px/1.6 system-ui, sans-serif; max-width: 46rem; margin: 2rem auto; padding: 0 1rem; }
+  .card { border: 1px solid #8884; border-radius: 8px; padding: .75rem 1rem; margin: .75rem 0; }
+  .badge { background: #fd0; color: #000; border-radius: 4px; padding: 0 .4rem; font-size: .85em; }
+</style>
+</head>
+<body>
+<h1>解說頁</h1>
+<p>一句話：原文是什麼。</p>
+<section class="card" id="O2">
+  <strong>O2</strong> 原因可能是快取留著舊的價目表。
+  <span class="badge">尚未確認：可能</span>
+  <p><em>對應原文：</em>第 1 段第 2 句</p>
+  <p><em>沒涵蓋：</em>是哪一個快取。原文沒有說。</p>
+</section>
+</body>
+</html>
+```
+
+### 步驟 6——交出之前先檢查
+
+五項檢查都要跑。有一項沒過，就修好那一階，再跑一次。
+
+1. **數量**：每一階的項目數，等於大綱的項目數，減去你列為「沒有畫」的項目。原文有 5 個步驟，每一階就是 5 個步驟。不是 4，也不是 6。
+2. **沒有新項目**：每一階的每個項目都有大綱編號。找找看有沒有項目沒有編號。
+3. **不確定語氣比對**：`hedge:` 不是 `none` 的每一項，每一階都要有同一個不確定用詞。比對的是該階與原文。任何語言都做得到。
+4. **出處**：每一項都有指向某個位置的「對應原文」，也有「沒涵蓋」註記。
+5. **離線**（只用於第 3 階）：在檔案裡搜尋 `http`、`//`、`<link`、`fetch(` 與 `XMLHttpRequest`。每一項搜尋，除了你從原文引用的文字，都必須是零命中。
+
+### 步驟 7——回報
+
+結尾放這張表。沒有這張表，不要交出任何一階。
+
+| 項目 | 第 1 階 | 第 2 階 | 第 3 階 | 保留不確定語氣 | 對應原文 | 沒涵蓋 |
+|------|---------|---------|---------|----------------|----------|--------|
+| O1 | 有 | 有 | 有 | 不適用 | 第 1 段第 1 句 | 「有時」的頻率 |
+
+有任何一項防護檢查沒過、又修不好，就說是哪一項、為什麼。不要回報成功。
+
+## 什麼時候不要用
+
+- 原文不到約 150 字。用 [ai-response-navigation](../../core/ai-response-navigation.md) 的 12.2 條改寫，並保留不確定語氣。不要做各階。
+- 讀者是專家，需要密度高的原形。
+- 任務是找出新的事實。本技能不做這件事。
+
+## 衡量它有沒有幫助
+
+本技能還沒有被證明有幫助。[eval-cases.md](eval-cases.md) 有 5 段原文，各附理解題與標準答案，並附一套跑法，會產出兩個數字：前後的答對率，以及防護違反次數。實跑需要模型呼叫，目前還沒做。實跑完成之前，不要宣稱本技能有效。
+
+## 相關
+
+- [ai-response-navigation](../../core/ai-response-navigation.md)：第 12 條，受控語言。12.1 條是防護 G2 的基礎。
+- [documentation-guide](../documentation-guide/SKILL.md)：Mermaid 圖在專案文件中該放哪裡。
+- [brainstorm-assistant](../brainstorm-assistant/SKILL.md)：相反方向，還沒有原文時用。
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-10-05 | 首次發佈。從同一份大綱做出三階。三條必須遵守的防護。評估案例。落實 dev-platform XSPEC-450 / DEC-125 D4。 |

package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md

@@ -0,0 +1,261 @@
+---
+source: ../../../../skills/comprehension-ladder/eval-cases.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-10-05
+source_hash: a2b33f2ef215
+status: current
+scope: universal
+description: |
+  理解階梯技能的評估案例與跑法：5 段原文，各附理解題、標準答案與防護違反檢查。尚未實跑。
+  Use when: 想衡量理解階梯技能是否幫得上讀者，或想重新檢查它的三條防護。
+  Keywords: evaluation, eval cases, comprehension questions, answer key, guard violations, DEC-114.
+---
+
+# 理解階梯：評估案例
+
+> **語言**: [English](../../../../skills/comprehension-ladder/eval-cases.md) | 繁體中文 | [简体中文](../../../zh-CN/skills/comprehension-ladder/eval-cases.md)
+
+**狀態：尚未實跑。** 本檔只有案例與跑法。沒有呼叫過任何模型，也沒有任何讀者作過答。實跑完成之前，不要說本技能讓文字比較好懂。
+
+下面五段原文都是為這次評估寫的。它們不描述任何真實的客戶、人物或系統。
+
+## 實跑會產出什麼
+
+一次實跑產出兩個數字：
+
+1. **前後的答對率。** 讀者看原文時（A 組，「之前」）與看技能產出時（B 組，「之後」），答對題目的比例。
+2. **防護違反次數。** 技能的產出破壞 G1、G2 或 G3 的次數。
+
+建議的通過線，實跑前要與負責人談定：B 組比 A 組高至少 10 個百分點，而且防護違反次數為 0。10 個百分點只是起始值，還沒有校準過。
+
+## 跑法
+
+### 1. 產出
+
+每個案例都對原文跑一次技能。要求第 1 階與第 2 階。存下大綱與兩階的產出。若也要測第 3 階，就要求它並存下 HTML 檔。
+
+五個案例使用同一個模型、同樣的設定。記下模型名稱。
+
+### 2. 分讀者
+
+至少用 6 位讀者。讀者可以是人，也可以是模型。人給出的證據比較強。模型是比較便宜的替身。
+
+把讀者分成人數相同的兩組。
+
+| 案例 | 第 1 組讀 | 第 2 組讀 |
+|------|-----------|-----------|
+| 1 | A（原文） | B（技能產出） |
+| 2 | B | A |
+| 3 | A | B |
+| 4 | B | A |
+| 5 | A | B |
+
+每位讀者每個案例只看一次。這樣讀者不會在一組學到答案，再帶到另一組。
+
+B 組的讀者只看技能產出，不看原文。
+
+### 3. 問題
+
+把該案例的題目交給每位讀者。讀者只能依手上拿到的文字作答，不得用任何其他來源。
+
+讀者可以答「文字沒有說」。對標為**未提及**的題目，這是正確答案。
+
+### 4. 評分
+
+依下面的標準答案評分。答案要符合「採計」欄才算對。標為**不確定語氣**的題目，若答案把說法講成確定，即使事實對了也算錯。
+
+答對率 = 答對的題數 ÷ 全部答案數，各組分開算。
+
+### 5. 計算防護違反
+
+對照原文，檢查每一份產出。下列情形，每一項各算一次。
+
+| 防護 | 一次違反是 |
+|------|------------|
+| G1 `no-new-facts` | 某一項或某一句，說了原文沒說的事。每個案例的「陷阱」清單列出最可能的幾種。 |
+| G2 `keep-hedges` | 原文的說法有不確定語氣，產出的那一項卻沒有，或語氣變得更強。每個案例的「不確定用詞清單」列出這些用詞。 |
+| G3 `trace-and-gaps` | 某一項沒有「對應原文」、指到的位置不是它所宣稱的位置，或沒有「沒涵蓋」註記。另外：產出沒有「這份大綱沒有收的部分」清單。 |
+
+請第二個人也數同一批產出，再比對兩份計數。不同時，逐項討論，記下最後的計數。
+
+### 6. 回報
+
+填這張表。兩個數字都要有。
+
+| 案例 | A 組答對 | B 組答對 | G1 | G2 | G3 |
+|------|----------|----------|----|----|----|
+| 1 | / | / | | | |
+| 2 | / | / | | | |
+| 3 | / | / | | | |
+| 4 | / | / | | | |
+| 5 | / | / | | | |
+| **合計** | **A 組答對率** | **B 組答對率** | | | |
+
+### 實跑規模
+
+說明實跑的規模，讓負責人在開跑前決定模型與預算：
+
+- 產出步驟：5 次技能執行，加 5 次防護檢查。共 10 次模型呼叫。
+- 讀者步驟，若讀者是模型：5 個案例 × 2 組 × 每組讀者數。
+- 題目很短。最長的輸入是一段原文或一份產出。
+
+模型與預算由負責人決定。這裡不設定。
+
+---
+
+## 案例 1：搜尋結果過期
+
+**類型**：含多處不確定語氣的事件紀錄。
+
+### 原文
+
+> 昨晚商品目錄匯入之後，搜尋頁約有 3 小時顯示舊的商品名稱。最可能的原因是，匯入之後搜尋索引沒有重建。我們認為匯入工作先結束，重建步驟才排進佇列，但我們還沒有檢查工作紀錄。顧客仍然可以購買那些商品。團隊計畫在星期四，替匯入工作加上重建步驟，前提是紀錄證實了事件的先後順序。沒有人量過有多少顧客看到舊名稱。
+
+### 問題與標準答案
+
+| # | 問題 | 類型 | 採計 |
+|---|------|------|------|
+| 1 | 搜尋頁顯示舊名稱的時間有多久？ | 事實 | 約 3 小時 |
+| 2 | 最可能的原因是什麼？已經確認了嗎？ | 不確定語氣 | 匯入之後索引沒有重建。尚未確認：「最可能」 |
+| 3 | 工作紀錄檢查過了嗎？ | 事實 | 沒有。還沒有 |
+| 4 | 問題發生期間，顧客還能購買商品嗎？ | 事實 | 能 |
+| 5 | 修復計畫在什麼時候？它取決於什麼？ | 事實 | 星期四。取決於紀錄是否證實事件的先後順序 |
+| 6 | 有多少顧客看到舊名稱？ | 未提及 | 文字沒有說。沒有人量過 |
+
+### 不確定用詞清單
+
+「約 3 小時」、「最可能」、「我們認為」、「還沒有檢查」、「前提是紀錄證實」、「沒有人量過」。
+
+### 陷阱（原文沒說的事實）
+
+受影響顧客的人數。原因已確認的說法。紀錄顯示了事件先後順序的說法。任何退款、營收或客服單的數字。
+
+---
+
+## 案例 2：退款核准流程
+
+**類型**：有分支的流程（適合第 2 階）。
+
+### 原文
+
+> 顧客在 App 裡申請退款。系統檢查訂單日期。訂單超過 30 天，系統立刻駁回申請，並向顧客顯示一則訊息。訂單在 30 天以內（含 30 天），系統把申請送給客服人員。客服人員在 2 個工作天內核准或駁回。客服人員核准後，系統把錢退回原付款方式，並寄電子郵件給顧客。超過 NT$5,000 的退款，還需要組長第二次核准。規格沒有說組長要在多久內回覆。
+
+### 問題與標準答案
+
+| # | 問題 | 類型 | 採計 |
+|---|------|------|------|
+| 1 | 45 天前的訂單申請退款，會怎麼處理？ | 事實 | 立刻駁回。顧客會看到一則訊息 |
+| 2 | 剛好 30 天的訂單申請退款，會怎麼處理？ | 事實 | 送給客服人員（「30 天以內（含 30 天）」） |
+| 3 | 客服人員有多久可以決定？ | 事實 | 2 個工作天 |
+| 4 | 核准之後，錢退到哪裡？ | 事實 | 原付款方式。顧客還會收到電子郵件 |
+| 5 | 哪些退款需要第二次核准？由誰核准？ | 事實 | 超過 NT$5,000 的退款。由組長 |
+| 6 | 組長要在多久內回覆？ | 未提及 | 文字沒有說 |
+
+### 不確定用詞清單
+
+主張裡沒有不確定用詞。文字明說了一個缺口：「規格沒有說組長要在多久內回覆。」產出必須保留這個缺口。
+
+### 陷阱
+
+組長的時限。訊息的內容。剛好 NT$5,000 的退款規則。檢查顧客歷史紀錄的步驟。
+
+### 預期規模
+
+原文有 7 個 `mechanism` 項目（申請、日期檢查、駁回、分流、客服決定、付款與電子郵件、組長核准），以及 1 個 `uncertainty` 項目（組長缺少時限）。每一階都應該呈現同樣的 8 項，或列出沒有畫的項目。
+
+---
+
+## 案例 3：重試函式
+
+**類型**：含數字與兩處不確定說法的程式碼解說。
+
+### 原文
+
+> 函式 `fetchWithRetry` 最多呼叫付款 API 4 次。第一次呼叫立刻發生。呼叫失敗後，它會先等一會兒，再做下一次。等待從 200 ms 開始，每次加倍，所以等待時間是 200 ms、400 ms 和 800 ms。它只在網路錯誤與 HTTP 狀態 503 時重試。遇到其他狀態，例如 400，它就停止並回傳錯誤。4 次呼叫全部失敗時，它丟出最後一個錯誤。程式沒有加入隨機抖動，所以許多同時失敗的用戶端可能會同時重試。我們還沒有測試 API 回傳狀態 429 時會發生什麼事。
+
+### 問題與標準答案
+
+| # | 問題 | 類型 | 採計 |
+|---|------|------|------|
+| 1 | 這個函式最多呼叫幾次？ | 事實 | 4 次 |
+| 2 | 呼叫之間的等待時間是多少？ | 事實 | 200 ms、400 ms、800 ms |
+| 3 | 哪些失敗會重試？ | 事實 | 網路錯誤與 HTTP 狀態 503 |
+| 4 | 遇到狀態 400 會怎樣？ | 事實 | 停止並回傳錯誤 |
+| 5 | 程式沒有加入抖動。接下來可能發生什麼？ | 不確定語氣 | 許多同時失敗的用戶端可能會同時重試。這是一種可能，不是必然 |
+| 6 | 遇到狀態 429 會怎樣？ | 未提及 | 不知道。還沒有測試過 |
+
+### 不確定用詞清單
+
+「可能會同時重試」、「我們還沒有測試」。
+
+### 陷阱
+
+狀態 429 的行為（重試或不重試）。用戶端確實會同時重試的說法。原文沒有給的等待總時間上限。API 的名稱。
+
+---
+
+## 案例 4：上傳檔案要存在哪裡
+
+**類型**：三個選項與取捨（適合第 2 階）。
+
+### 原文
+
+> 我們比較了三種儲存使用者上傳檔案的方式。選項 A：把檔案放在應用程式伺服器的磁碟上。它最便宜，也不需要新工具。但伺服器一換，檔案就會遺失，而且兩台伺服器無法共用檔案。選項 B：使用雲端供應商的物件儲存。以目前的量來說，費用約為每月 NT$600。更換伺服器後檔案仍在，任何一台伺服器都能讀取。它需要一次性的存取金鑰設定。選項 C：使用網路檔案共用。伺服器之間可以共用檔案，也不需要改程式。但它多出一台要維護的機器，而且我們認為，在高負載下它會比較慢。我們建議選項 B。我們還沒有測試選項 C 的速度。
+
+### 問題與標準答案
+
+| # | 問題 | 類型 | 採計 |
+|---|------|------|------|
+| 1 | 文字說哪個選項在更換伺服器後檔案仍在？ | 事實 | 選項 B。（文字說選項 A 不會。對選項 C，文字沒有說。） |
+| 2 | 選項 B 的費用是多少？ | 事實 | 以目前的量來說，約每月 NT$600 |
+| 3 | 哪個選項不需要改程式？ | 事實 | 選項 C |
+| 4 | 團隊建議哪個選項？ | 事實 | 選項 B |
+| 5 | 在高負載下，選項 C 比較慢嗎？ | 不確定語氣 | 團隊認為是，但還沒有測試過 |
+| 6 | 選項 C 的費用是多少？ | 未提及 | 文字沒有說 |
+
+### 不確定用詞清單
+
+「約 NT$600」、「我們認為它會比較慢」、「我們還沒有測試」。
+
+### 陷阱
+
+選項 A 或選項 C 的費用。選項 C 在更換伺服器後檔案仍在的說法。沒有帶不確定語氣、就說選項 C 比較慢。原文沒有給的建議理由。
+
+---
+
+## 案例 5：存取紀錄裡的工作階段權杖
+
+**類型**：含未知事項與尚未評等風險的資安發現。
+
+### 原文
+
+> 審查 API 閘道時，我們發現存取紀錄可能含有工作階段權杖。用戶端把權杖放在網址的查詢字串、而不是放在標頭時，權杖就會出現在紀錄裡。行動 App 2.3 版在個人資料畫面這樣做。網頁用戶端使用標頭，不受影響。紀錄保存 90 天，有 12 位工程師可以讀取。我們沒有找到有人使用過被記下的權杖的證據。風險大概是中等，但我們還沒有正式評等。我們提出兩項修改：行動 App 把權杖改放標頭，以及在紀錄中遮蔽查詢字串。我們還不知道有多少使用者在用 App 2.3 版。
+
+### 問題與標準答案
+
+| # | 問題 | 類型 | 採計 |
+|---|------|------|------|
+| 1 | 權杖什麼時候會出現在紀錄裡？ | 事實 | 用戶端把它放在網址的查詢字串、而不是標頭時 |
+| 2 | 哪些用戶端受影響？ | 事實 | 行動 App 2.3 版，在個人資料畫面。網頁用戶端不受影響 |
+| 3 | 紀錄保存多久？誰能讀？ | 事實 | 90 天。12 位工程師 |
+| 4 | 有沒有人被證實濫用被記下的權杖？ | 不確定語氣 | 沒有找到證據。這不等於「沒有人這樣做」 |
+| 5 | 風險有多嚴重？ | 不確定語氣 | 大概是中等。尚未正式評等 |
+| 6 | 有多少使用者在用 App 2.3 版？ | 未提及 | 還不知道 |
+
+### 不確定用詞清單
+
+「可能含有」、「沒有找到……證據」、「大概是中等」、「還沒有正式評等」、「還不知道」。
+
+### 陷阱
+
+受影響使用者的人數。沒有任何權杖被濫用的說法。正式的風險等級（例如「高」或「中」）。修復日期。網頁用戶端有風險的說法。
+
+---
+
+## 實跑之後
+
+- 記下日期、模型名稱、讀者人數，以及誰計算防護違反。
+- 把填好的回報表放在本檔旁邊。不要覆寫案例。
+- 防護違反次數大於 0 時，先修技能，再去解讀答對率。加了事實或拿掉不確定語氣的產出，可能拉高答對率，卻仍然誤導讀者。
+- 某段原文被發現有歧義時，把原文與答案一起修正，再重跑那個案例。

package/bundled/skills/README.md

@@ -49,6 +49,7 @@ These skills provide standard guidance and workflows. They can be accessed via s
 | `refactoring-assistant` | `/refactor` | [UDS] Refactoring guidance |
 | `project-discovery` | `/discover` | [UDS] Assess project health and risks |
 | `brainstorm-assistant` | `/brainstorm` | [UDS] Structured AI-assisted ideation |
+| `comprehension-ladder` | `/comprehend` | [UDS] Re-form a hard-to-follow AI output as controlled text, a Mermaid diagram, or an offline HTML explainer, without changing the facts |
 | `changelog-guide` | `/changelog` | [UDS] Generate changelog entries |
 | `dev-workflow-guide` | `/dev-workflow` | [UDS] Map development phases to UDS commands |
 | `docs-generator` | `/docgen` | [UDS] Generate usage documentation |