universal-dev-standards 6.7.5 → 6.9.0

package/bundled/locales/zh-TW/core/deferred-item-exit.md

@@ -0,0 +1,251 @@
+---
+source: ../../../core/deferred-item-exit.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-08-24
+source_hash: e76ef99c88a5
+status: current
+---
+
+# 延後項目出口標準
+
+> **Language**: [English](../../../core/deferred-item-exit.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2026-08-24
+**適用**: 任何標準要求產出、且可能記下延後項目的文件
+**範圍**: universal
+
+---
+
+## 目的
+
+有一批標準會要求產出**會產生延後項目**的文件——ADR 的既受風險與「之後再決定」、
+規格的未納入清單、retrospective 的 action items、探索矩陣裡未確認的候選、
+review 的非阻斷建議、AC 報告的缺口。每一條標準都規定了那份文件要怎麼寫好，
+**沒有一條規定那些項目之後去哪**。
+
+於是它們哪裡也沒去。項目被記下、文件被核准，**那筆紀錄就是終點**。
+沒有東西會再提起它，因為承載它的只有一份已被視為完成的檔案裡的一段文字。
+
+**本標準補上那個缺失的關係：延後項目必須離開文件。**
+
+---
+
+## 本標準的寫法，以及為什麼這樣寫
+
+**讀下面任何一條要求之前先讀這一段。它拘束它們全部。**
+
+UDS 定義**活動**，採用層負責**編排**（DEC-049；見 [MIGRATION-v6](../../../docs/MIGRATION-v6.md) §2）。
+6.0.0 依該決策移除八條機器可讀標準，其中七條正是工作流狀態協定。
+**一份寫成編排協定的標準屬於採用層，不屬於這裡。**
+
+本標準受此拘束的分界：
+
+| 這裡容許——**what** | 這裡不容許——**how** |
+|---|---|
+| artefact 之間必須存在的關係 | artefact 必須通過的狀態機 |
+| 一項宣稱要算作證據所必須具備的性質 | 必須產出該宣稱的 pipeline 階段 |
+| 一份回報必須保留的區別 | 回報格式、工具或 schema |
+| 延後項目必須有出口 | 哪一個 issue tracker／看板／檔案是那個出口 |
+
+**下面每一條要求都寫成「必須存在什麼關係」，絕不寫成「應使用什麼機制維持它」。**
+UDS 本來就有一整類這個形狀的標準——[acceptance-criteria-traceability](acceptance-criteria-traceability.md)
+要求每一條 AC 都能被某個測試到達，而不規定用什麼維持那條可達性。
+本標準是同一個形狀，套用在延後項目上。
+
+**直說它的後果**：本標準**不附帶任何閘門**。它只說什麼必須為真。
+有沒有東西在檢查，是採用專案的決定——而 DEX-004 是用來讓那個決定沒辦法被默默做掉的。
+
+---
+
+## 不變量
+
+**一個記錄在文件裡的延後項目，必須在該文件之外有一個可追蹤的出口，而該出口的識別字必須寫在文件裡、緊鄰該項目。**
+
+### 什麼算延後項目
+
+任何被該文件記錄為**現在不做、不由這份文件做**的項目。措辭變化無窮——
+「待決定」「第一版未納入」「另案處理」「尚未實作」「之後再看」「既受風險」「這個我們先放著」。
+**措辭不是定義**；定義是該項目相對於「這份文件所了結的那份工作」的狀態。見[錨點](#錨點走訪結構不走訪措辭)。
+
+### 什麼算出口
+
+**刻意不指定。** issue、tracked TODO、manifest 條目、backlog 檔案的一列、
+專案已經在跑的任何工單系統——全都算。判準是**「這個項目離開文件了嗎」**，不是「用了什麼工具」。
+
+一個出口要滿足不變量，下列三條必須同時成立：
+
+| # | 關係 | 何時失敗 |
+|---|---|---|
+| 1 | 出口存在於這份文件之外 | 該項目唯一的紀錄就是這份文件的文字 |
+| 2 | 出口可由一個寫在文件裡的識別字定址 | 文件寫著「之後再處理」而沒有任何可定址的東西 |
+| 3 | 產出該文件的那次變更落地**之後**，出口仍然解析得到 | 出口被同一次變更關閉、刪除或取代 |
+
+第 3 條不是假想。兩個實際觀察到的洩漏，都同時滿足第 1、2 條而仍然遺失項目：
+
+- 待辦寫進**會被本次合併關閉的 issue**。文件指向一筆在工作被接受的當下就停止存在的紀錄。
+- 待辦寫進出口的**留言而非本體**，被後續留言推走。出口解析得到；讀出口卻讀不到那個項目。
+
+---
+
+## 要求
+
+| ID | 要求 | 嚴重度 |
+|---|---|---|
+| **DEX-001** | 文件裡記下的延後項目，在文件之外有可追蹤的出口，且文件在該項目旁載明出口識別字 | error |
+| **DEX-002** | 產出該文件的變更落地之後，出口仍然解析得到，且仍承載該項目 | error |
+| **DEX-003** | 本標準的每一條要求都可表述為 artefact 之間可判定的關係。不能如此表述的要求不得進入本標準 | error |
+| **DEX-004** | 被提出作為本標準證據的檢查，已被觀察到對刻意違規的樣本回報失敗。從未紅過的檢查不是可採信的證據 | error |
+| **DEX-005** | 驗證確立「那個出口**承載這個項目**」——而不只是「識別字解析得到」 | error |
+| **DEX-006** | 「有連結且已驗證內容」與「有連結但內容未驗證」回報為兩個相異狀態。合併為單一通過狀態即不滿足 DEX-005 | error |
+| **DEX-007** | 「這裡有一個延後項目」的錨點，是可由該文件自身既定結構窮舉出來的位置 | error |
+| **DEX-008** | 以措辭清單補充結構錨點時，明示其涵蓋率未知，且其綠燈不被回報為完整 | warning |
+| **DEX-009** | 該判定所用的任何窗口或閾值，載明來歷，或標為未校準 | warning |
+
+---
+
+## 一條無法被檢查的要求，不是這裡的要求
+
+**DEX-003 是對本標準自身內容的約束。** 上面每一條都指名了 artefact 與它們之間的關係，
+使得讀的人——或專案自己建的東西——可以判定它成不成立。
+**一條無法被判定的要求不屬於這裡**，不論它聽起來多正確。
+
+理由是量出來的，不是美學：在這一類規則之下第一次大批產出文件，**五項延後項目全部漏掉**。
+規則被理解了，人也稱職。缺的是任何一個能分辨「滿足它的文件」與「不滿足它的文件」的東西。
+
+### 一支從未紅過的檢查
+
+**DEX-004 講的是什麼算證據，不是要你去建什麼。**
+**一支從未失敗過的檢查，與一支不可能失敗的檢查，輸出一模一樣。**
+在它被觀察到「對一個刻意違規的樣本回報失敗」之前，它不是「規則成立」的證據，
+只是「有東西跑過」的證據。
+
+證明檢查非空跑的做法、以及為何必須逐子集而非整體進行，見 [class-level-fix](class-level-fix.md)；
+「exit 0」為何不等於「它在工作」，見 [verification-evidence](verification-evidence.md)。
+**兩者都不在此複述。**
+
+---
+
+## 連結存在，不等於連結有效
+
+一個寫在延後項目旁邊的識別字，製造出「有出口」的外觀。
+那個出口**有沒有承載**這個項目，是另一個問題，而兩個答案不能互換。
+
+命名這條規則的實例：文件寫著「與 issue #19 一併決定」，而 #19 裡根本沒有這件事。
+上面第 1、2、3 條全部成立，項目照樣不見了。
+**一道只問識別字在不在的閘門會放行這份文件**，而它印出的綠燈，
+與它印在出口都為真的文件上的綠燈，逐位元相同。
+
+### 兩態，不得合併為一
+
+確立 DEX-005 需要讀出口的內容，成本明顯高於讀文件。
+**DEX-005 不要求一步到位做到每一處。** 它要求的是「差別必須看得見」：
+
+| 狀態 | 意義 |
+|---|---|
+| **有連結且已驗證內容** | 讀過出口，它承載這個項目 |
+| **有連結但內容未驗證** | 識別字在；它有沒有承載這個項目，未知 |
+| **無出口** | 違反 DEX-001 |
+
+把前兩態合併成單一通過數，不是通往規則的捷徑——那正是這條規則要防的缺陷，
+被制度化並給了一個編號。**一個被回報成通過的未知，比一個被回報成未知的未知更糟**，
+因為後者還找得到。
+
+若一個專案今天只做得起便宜的那一半，那屬於 [verification-evidence](verification-evidence.md) VE-012
+與 [class-level-fix](class-level-fix.md) CLF-008 已經在管的涵蓋缺口：
+**必須帶日期登記，不能只在文字裡揭露一次。** 此處不複述。
+
+---
+
+## 錨點：走訪結構，不走訪措辭
+
+判定「這裡有沒有延後項目」時，**走訪文件的結構**。
+結構由「要求產出這份文件的那條標準」所定義，因此可窮舉。
+**措辭不可窮舉，而且沒有任何一張措辭清單能被證明是完整的。**
+
+| 文件 | 延後項目出現的結構位置 |
+|---|---|
+| ADR | `Consequences` → **Bad**／**Accepted risk**；`Links`；被考慮而未採用的選項 |
+| 規格 | 未納入／不在本版的段落；open questions；待確認的 assumptions |
+| Retrospective | `Action Items`；`Previous Action Items Review` 中仍為 Open 的列；附理由 Cancelled 的項目 |
+| 功能探索 | 零打勾候選；`dead_code_candidates`；升級為人工觀察的候選 |
+| Code review | 本次未改而被接受的非阻斷留言類別（`⚠️ IMPORTANT`、`💡 SUGGESTION`、`[SUGGESTION]`、`[NIT]`）|
+| AC 覆蓋率報告 | `Gaps` → **Uncovered AC**／**Partial AC**；`Threshold Exceptions`；`Action Items` |
+
+### 仍然要用措辭清單時
+
+合法——結構走訪抓得到待在自己段落裡的項目，抓不到被丟進一段敘述文字裡的那一個。
+但此時 **DEX-008 隨即適用**：該清單的涵蓋率未知，這件事必須明說，
+而它的綠燈不得被讀成「沒有漏掉任何延後項目」。
+一張含「待決定」與「未納入」的清單，對「這一點我們先放著」這句話**什麼也沒說**。
+
+**一道自行列舉範圍的閘門，正確到有人新增第四個成員為止**——
+[class-level-fix](class-level-fix.md) 是這個失敗的通則形式。
+措辭清單在構造上就是那個失敗；它可以用，但不能信。
+
+### 閾值必須帶著來歷
+
+**DEX-009。** 「識別字必須出現在項目後 3 行內」這類判準，決定了建立其上的一切的召回率。
+若沒有東西記下 3 是怎麼來的，就沒有人能評估把它改成 2 或 5，
+也沒有人分得出它是量出來的還是猜的。
+**寫下那個數字的來歷，或標為未校準。** 兩者都可接受；沉默不行。
+
+**一個沒有來歷的閾值，是一個沒有人能檢查的決定。**
+
+---
+
+## 反模式
+
+| 反模式 | 為什麼失敗 |
+|---|---|
+| 記下延後項目，然後核准文件 | 文件是唯一的載體，而它現在被視為完成了 |
+| 出口被產出該文件的同一次變更關閉 | 指標在工作進行中解析得到，工作結束後就不再解析得到 |
+| 項目寫進出口的留言，不是出口本體 | 出口解析得到；讀出口卻讀不到那個項目 |
+| 檢查識別字在不在 | 「在」與「對」印出同一個綠 |
+| 已驗證與未驗證的連結共用一個通過狀態 | 把上一列的缺陷變成永久的，還給了它一個編號 |
+| 把措辭清單當成「延後」的定義 | 正確到有人換一種寫法為止，而沒有東西會說 |
+| 沒有記下來歷的窗口大小 | 它決定整個判定的召回率，而沒有人能檢查它 |
+| 從未被觀察到失敗的檢查 | 與一支不可能失敗的檢查無從分辨 |
+
+---
+
+## 什麼在執行本標準
+
+**UDS 側沒有任何東西在執行，而這件事是被記錄的，不是被暗示的。**
+UDS 陳述關係；有沒有東西去判定它，依上面的[寫法約束](#本標準的寫法以及為什麼這樣寫)，是採用專案的決定。
+
+本標準做的事，是讓那個決定顯形：DEX-003 保證這裡每一條**能**被判定，
+DEX-004 固定「一次判定要算數需要什麼」，DEX-006／DEX-008 固定「一次不完整的判定容許印出什麼」。
+一個採用本標準而什麼都沒建的專案**並未違反它**——
+但它同樣不能宣稱自己的延後項目有出口，因為它沒有任何可採信的證據說明有。
+
+**重啟條件**：若 UDS 開始出貨那些文件本身，而不只是出貨要求產出它們的標準，
+走訪[錨點](#錨點走訪結構不走訪措辭)那張表所列的結構位置就在本 repo 內變得可能，
+屆時誠實的做法是去跑它。
+
+---
+
+## 會產出延後項目的標準
+
+下列各條都指回這裡；**沒有一條複述規則**，因為同一條規則的六份副本會往六個方向腐壞。
+
+- [adr-standards](adr-standards.md) — 既受風險、負面後果、被考慮而未採用的選項
+- [spec-driven-development](spec-driven-development.md) — 未納入項目、open questions、待確認的 assumptions
+- [retrospective-standards](retrospective-standards.md) — action items，以及仍為 Open 的上期項目
+- `feature-discovery-standards` — 未確認候選與 `dead_code_candidates`
+- [code-review-checklist](code-review-checklist.md) — 本次未改而被接受的非阻斷留言
+- [acceptance-criteria-traceability](acceptance-criteria-traceability.md) — 涵蓋缺口、閾值例外、報告的 action items
+
+---
+
+## 與其他標準的關係
+
+- [acceptance-criteria-traceability](acceptance-criteria-traceability.md) — 上一層的同一個形狀：
+  它要求每條 AC 都能被驗證項到達，而不規定用什麼維持。本標準要求每個延後項目都能被出口到達。
+- [class-level-fix](class-level-fix.md) — 提供 DEX-004 所要求證據的產生程序；
+  也是 DEX-008 所揭露之措辭清單失敗的通則形式。
+- [verification-evidence](verification-evidence.md) — VE-012 的帶到期日例外清冊，
+  正是 DEX-006 那群「未驗證」項目該被登記進去的地方，而不是揭露一次就放著。
+- [self-review-protocol](self-review-protocol.md) — 自我複查抓得到矛盾、抓不到缺漏；
+  沒有出口的延後項目正是缺漏。

package/bundled/locales/zh-TW/core/documentation-writing-standards.md

@@ -2,7 +2,8 @@
 source: ../../../core/documentation-writing-standards.md
 source_version: 1.2.0
 translation_version: 1.2.0
-last_synced: 2026-03-17
+last_synced: 2026-07-23
+source_hash: 9d2d83e23aef
 status: current
 ---
 
@@ -13,6 +14,9 @@ status: current
 **版本**: 1.2.0
 **最後更新**: 2026-03-17
 **適用範圍**: 所有軟體專案（新建、重構、遷移、維護）
+**範圍**: partial
+**業界標準**: OpenAPI 3.1、AsyncAPI 2.6、JSON Schema 2020-12、WCAG 2.1（文件無障礙）
+**參考**: [openapis.org](https://www.openapis.org/)
 
 ---
 
@@ -118,6 +122,38 @@ status: current
 
 ---
 
+## 文件語言設定
+
+文件語言與 [commit-message-guide.md](commit-message-guide.md) 共用 `output_language` 設定。此統一設定控制專案中所有書面輸出的語言。
+
+### 語言選項
+
+| 設定值 | Commit 訊息 | 文件 |
+|--------------|----------------|---------------|
+| `english` | 僅英文 | 僅英文 |
+| `traditional-chinese` | 僅繁體中文 | 僅繁體中文 |
+| `bilingual` | 英文 + 中文 | 分層雙語（見下方） |
+
+### 文件分層（雙語模式）
+
+當 `output_language` 設為 `bilingual` 時，文件遵循三層系統：
+
+| 層級 | 文件 | 行為 | 理由 |
+|------|-----------|----------|-----------|
+| **L1 — 必要** | Commit 訊息、CHANGELOG.md、PR 說明 | 自動雙語 | 直接由語言設定控制 |
+| **L2 — 建議** | README.md、CONTRIBUTING.md、ADR/ | AI 建議雙語 | 開發者最常閱讀 |
+| **L3 — 不受影響** | ARCHITECTURE.md、API.md、DATABASE.md、DEPLOYMENT.md、MIGRATION.md | 遵循顯示語言 | 技術規格；雙語會造成過多冗餘 |
+
+### 雙語文件格式
+
+使用段落層級雙語格式，與雙語 commit 訊息內文一致：
+
+- 英文段落在前，接著空一行，然後是中文段落
+- 程式碼區塊和表格只寫一次（不重複）
+- 章節標題使用 `|` 分隔：`## Installation | 安裝`
+
+---
+
 ## 核心原則
 
 > **文件是程式碼的延伸，應與程式碼同等重視。好的文件能減少溝通成本、加速新人上手、降低維護風險。**
@@ -502,17 +538,61 @@ version: 2.1.0
 last_updated: 2026-01-24
 owner: auth-team
 status: stable
+dependencies:
+  - user-service
+  - token-service
 ---
 ```
 
 **模式 2：清晰的章節標記**
 
+使用 AI 能辨識的一致章節標題：
+
 ```markdown
 ## Overview / 概述
+[此元件/API 的簡短說明]
+
 ## Quick Start / 快速開始
+[開始使用的最少步驟]
+
 ## API Reference / API 參考
+[詳細的 API 文件]
+
 ## Configuration / 配置
+[配置選項與預設值]
+
 ## Troubleshooting / 故障排除
+[常見問題與解決方法]
+```
+
+**模式 3：明確範例**
+
+提供帶有清晰情境的完整、可執行範例：
+
+```markdown
+### 範例：建立使用者
+
+**前置條件**：
+- 有效的 API 金鑰
+- Admin 角色
+
+**請求**：
+```bash
+curl -X POST https://api.example.com/v1/users \
+  -H "Authorization: Bearer $API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "John", "email": "john@example.com"}'
+```
+
+**回應**（201 Created）：
+```json
+{
+  "id": "usr_123",
+  "name": "John",
+  "email": "john@example.com",
+  "created_at": "2026-01-24T10:30:00Z"
+}
+```
 ```
 
 ### LLM 最佳化寫作規則
@@ -552,6 +632,8 @@ last_validated: 2026-03-17
 
 ### 為 AI 程式碼生成撰寫
 
+當文件將用於生成程式碼時：
+
 **包含明確限制**:
 
 ```markdown
@@ -564,6 +646,18 @@ last_validated: 2026-03-17
 | role | string | 列舉: "admin", "user", "guest" |
 ```
 
+**明確錯誤情境**:
+
+```markdown
+## 錯誤回應
+
+| 情境 | HTTP 狀態碼 | 錯誤碼 | 訊息 |
+|----------|-------------|------------|---------|
+| Email 無效 | 400 | INVALID_EMAIL | "Email format is invalid" |
+| 使用者已存在 | 409 | DUPLICATE_USER | "User with this email already exists" |
+| 缺少認證 | 401 | UNAUTHORIZED | "Authentication required" |
+```
+
 **明確業務邏輯**:
 
 ```markdown
@@ -572,7 +666,34 @@ last_validated: 2026-03-17
 1. 基礎折扣 = 0%
 2. 若客戶類型為 "VIP"，加 20%
 3. 若訂單總額 > $100，加 5%
-4. 最大總折扣 = 50%
+4. 若優惠券代碼有效，加上優惠券折扣
+5. 最大總折扣 = 50%
+6. 折扣套用於小計（不含稅）
+```
+
+### AI 提示詞整合
+
+對於定義 AI 輔助工作流程的文件：
+
+**內嵌提示詞範本**：
+
+```markdown
+## AI 程式碼審查提示詞
+
+審查程式碼變更時，使用以下提示詞：
+
+```
+Review this code change for:
+1. Security vulnerabilities (OWASP Top 10)
+2. Performance issues
+3. Error handling completeness
+4. Adherence to [project-conventions.md]
+
+Provide feedback in this format:
+- 🔴 Critical: [Must fix before merge]
+- 🟡 Important: [Should address]
+- 🟢 Suggestion: [Nice to have]
+```
 ```
 
 ---
@@ -590,6 +711,46 @@ last_validated: 2026-03-17
 | JSON Schema 對齊 | 與 JSON Schema 完全相容 |
 | Webhooks 支援 | 一級 webhook 文件 |
 | `type` 陣列 | 支援 `"type": ["string", "null"]` |
+| `$ref` 與屬性並存 | 可在同一物件中參照並擴充 |
+
+**OpenAPI 3.1 Schema 範例**：
+
+```yaml
+openapi: 3.1.0
+info:
+  title: 使用者 API
+  version: 2.1.0
+paths:
+  /users:
+    post:
+      summary: 建立新使用者
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateUserRequest'
+      responses:
+        '201':
+          description: 使用者已建立
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/User'
+components:
+  schemas:
+    CreateUserRequest:
+      type: object
+      required: [name, email]
+      properties:
+        name:
+          type: string
+          minLength: 1
+          maxLength: 100
+        email:
+          type: string
+          format: email
+```
 
 ### AsyncAPI 2.6 用於事件驅動 API
 
@@ -605,6 +766,21 @@ channels:
     publish:
       message:
         $ref: '#/components/messages/OrderCreated'
+components:
+  messages:
+    OrderCreated:
+      payload:
+        type: object
+        properties:
+          orderId:
+            type: string
+          customerId:
+            type: string
+          totalAmount:
+            type: number
+          createdAt:
+            type: string
+            format: date-time
 ```
 
 ---
@@ -677,11 +853,60 @@ last_synced: 2026-03-17
 
 | 項目 | 標準 |
 |------|----------|
-| 同步更新 | 程式碼變更時同步更新文件 |
+| 同步更新 | **自動 AI 行為**：完成程式碼變更後，AI 必須檢查哪些文件受影響並列為提醒。詳見下方 [AI 行為：自動文件影響檢查](#自動文件影響檢查) |
 | 版本標記 | 文件頂部標記版本與更新日期 |
 | 審查納入 | 程式碼審查需包含文件變更 |
 | 定期檢視 | 每季檢視文件是否過時 |
 
+### 自動文件影響檢查
+
+**這是一項自動 AI 行為** — AI 助手必須在完成任何程式碼修改任務後執行此檢查，無需等待使用者詢問。
+
+**工作流程：**
+
+1. 完成程式碼變更後，識別哪些檔案被修改
+2. 對每個修改的檔案，檢查是否有文件引用它（README、CLI 文件、API 文件、規格、skills、翻譯）
+3. 若發現受影響的文件，附加提醒區塊並提供**建議指令**：
+
+```
+---
+📋 **Documentation Impact**
+The following documents may need updating:
+- `README.md` — describes changed CLI option `--xxx`
+  → `/docs readme`
+- `docs/CLI-INIT-OPTIONS.md` — references modified function `promptXxx()`
+  → manual update or `/docs generate`
+- `locales/zh-TW/docs/CLI-INIT-OPTIONS.md` — translation of modified source
+  → `/docs translate docs/CLI-INIT-OPTIONS.md --lang zh-TW`
+
+Or run `/docs impact` for a full analysis.
+---
+```
+
+4. 若無文件受影響，靜默略過
+5. **不自動修改文件** — 僅列出提醒並等待使用者確認
+
+**指令建議對照：**
+
+| 受影響文件 | 建議指令 |
+|-------------------|-------------------|
+| README.md | `/docs readme` |
+| API 文件 | `/docs api` |
+| 產生的文件（cheatsheet、參考文件） | `/docs generate` |
+| 翻譯檔案（`locales/`） | `/docs translate <source-file> --lang <lang>` |
+| 規格檔案、skill 檔案、其他文件 | 手動更新（建議具體檔案路徑） |
+| 多個文件受影響 | `/docs impact` 取得完整概覽 |
+
+**檢查範圍：**
+
+| 文件類型 | 對照檢查 |
+|--------------|---------------|
+| CLI 文件（`docs/`） | 修改的函式、CLI 選項、指令 |
+| 規格檔案（`docs/specs/`） | 修改的介面、schema、工作流程 |
+| Skills（`skills/`） | 修改的行為、標準參考 |
+| 翻譯（`locales/`） | 任何有翻譯的已修改原始檔案 |
+| README、CHANGELOG | 修改的公開 API、功能、配置 |
+
 ### 審查清單
 
 提交文件前：

package/bundled/locales/zh-TW/core/full-coverage-testing.md

@@ -2,8 +2,8 @@
 source: ../../../core/full-coverage-testing.md
 source_version: 1.1.0
 translation_version: 1.1.0
-last_synced: 2026-06-17
-source_hash: a8cffbab007a
+last_synced: 2026-07-23
+source_hash: 8ca921c68533
 status: current
 ---
 
@@ -196,6 +196,18 @@ CI 會回報 AC 覆蓋率。若超過 20% 的 AC 沒有 `@ac` 標籤的測試，
 
 對步驟 1 的**每條** legacy 錯誤分支，驗證新系統有對應 handler。無對映者標 `not_implemented`（XSPEC-199）並 **block**。產出涵蓋完整推導清單的**「遺漏錯誤分支」gap 報告**——而非僅抽樣通過。
 
+```markdown
+## Error-Path Gap Report — <module>
+
+| Legacy branch (error type / code) | New-system handler | Status |
+|-----------------------------------|--------------------|--------|
+| PaymentDeclinedException → 402 | PaymentService.handleDecline | MAPPED |
+| GatewayTimeout → retry+fallback | (none found) | not_implemented — BLOCK |
+| ValidationError → 422 + field list | InputValidator | MAPPED |
+
+**Branches: N total · M mapped · K not_implemented (block if K>0)**
+```
+
 ### 步驟 3 — 降級／Fallback 對等（R3）
 
 legacy 降級模式（外部服務失敗時的 fallback、重試、部分結果）因只在失敗時才執行而容易被漏。驗證新系統保留對應降級行為，避免「正常路徑一致、失敗時行為迥異」：
@@ -241,6 +253,7 @@ legacy 降級模式（外部服務失敗時的 fallback、重試、部分結果
 - `unit-testing.ai.yaml` — 單元測試範圍與組織
 - `integration-testing.ai.yaml` — 整合測試模式
 - `deployment-standards.ai.yaml` — 部署閘門需求
+- `flaky-test-management.md` — 間歇性失敗處理：會 flaky 的測試**不算**通過的測試。在覆蓋率數字被計入閘門之前，間歇性失敗必須依該標準被隔離（quarantine）／設定重試預算（retry-budget）／根因排除——否則「全覆蓋」會掩蓋非決定性的缺口。
 - `behavior-snapshot.md` — 錯誤回應差分 oracle（遷移錯誤路徑完整性，軸⑨）
 - `migration-assistant` skill — legacy 例外/錯誤碼 derive + 降級對等（XSPEC-288）
 - XSPEC-178 — 完整規格與實作階段