universal-dev-standards 6.8.0 → 6.9.0

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 — 完整規格與實作階段

package/bundled/locales/zh-TW/core/governance-layer.md

@@ -1,8 +1,9 @@
 ---
 source: ../../../core/governance-layer.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-07
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-08-20
+source_hash: 15ca18717240
 status: current
 ---
 
@@ -10,8 +11,8 @@ status: current
 
 > **語言**: [English](../../../core/governance-layer.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2026-05-07
+**版本**: 1.1.0
+**最後更新**: 2026-08-20
 **適用範圍**: 所有具有多 Agent 或多角色 AI 工作流程的軟體專案
 **範疇**: universal
 **產業標準**: 無（UDS 原創）
@@ -130,9 +131,79 @@ Vision（方向）→ Mission（邊界 + 紅線）→ Goals（可量測的 KPI
 | `signatory` | 接受風險的人員或角色 |
 | `gates_bypassed` | 列舉所有繞過的人工閘門 |
 | `risks_accepted` | 明確描述已接受的風險 |
+| `review_by` | 本次接受失效、必須重新做一次判斷的日期 |
 
 若無有效的風險接受條款，pipeline **必須拒絕啟動（fail-closed）**。
 
+### 接受到期
+
+`review_by` 已過的條款**不是有效條款**。pipeline 必須 fail closed，與完全沒有條款時一模一樣。
+
+`date` 記錄的是「何時接受了這個風險」，不是「何時該重新判斷」。沒有 `review_by`，簽過一次的接受就永遠有效——當初支持它的條件可能已經改變、簽署人可能已經離開專案，而條款裡每一個欄位讀起來仍然完全正確。
+
+到期時，必須施用且只能施用下列三種處置之一，與[技術債標準 → 到期處置](tech-debt-standards.md#到期處置)所定義的三種相同：
+
+| 處置 | 意義 |
+|------|------|
+| **重新接受** | 由當下的簽署人重新簽署，並給出新的 `review_by` |
+| **撤銷** | 移除該繞過，恢復人工閘門 |
+| **延期** | 新的 `review_by` **與**書面理由，一起記下 |
+
+**禁止自動延長 `review_by`。** 那會把一道 fail-closed 的閘門變成 fail-open，而所有欄位看起來都還是對的——失效之所以隱形，正是因為條款仍然驗證得過。
+
+---
+
+## 待裁決事項
+
+「還沒決定」是一種治理狀態，不是治理的缺席。規格裡的未決問題、提出但未批准的紅線、沒有 owner 的 KPI——每一項都是有人被期待要做的決定，而每一項對「只讀已做成決定」的檢查都是隱形的。
+
+待裁決事項與已接受風險**同級受治理**：它們帶時鐘，而且必須可被列舉。
+
+**規則 GOV-PD-001（必要）**——專案必須宣告待裁決事項**記在哪裡**，以及**什麼標記代表一項待裁決**：一個固定的 token（狀態值、標籤、字面標記字串），不得是自由書寫的散文。列舉不該取決於讀者猜中當初用了哪些字。三份分別寫「TBD」「待拍板」「待確認」的文件，是三份無法被列舉的文件；一個宣告過的標記讓三份都找得到。
+
+**規則 GOV-PD-002（必要）**——列舉待裁決事項時，必須同時回報總數**與**無法解析的來源份數（見[匯總報告](#匯總報告)）。「查無待裁決事項」在不知道走訪集合有多大時，不帶任何資訊。
+
+**規則 GOV-PD-003（必要）**——每一項待裁決事項都帶一個**裁決期限日期**。到期時適用與逾期技術債相同的三種處置——**做出決定**、**撤回這個問題**、或**延期並寫明理由**。禁止自動延期。
+
+**規則 GOV-PD-004（必要）**——若沒有任何東西在排程上列舉待裁決事項，專案必須帶一份**無人看管宣告**，寫明負責人、複查頻率與最後複查日期——與技術債登記表被要求的兩態規則相同。沒有被列舉是可接受的；沒有被列舉又沒有宣告則不可接受。
+
+> 一項沒有日期的待裁決事項，在行為上與「決定不做」完全相同。差別只在於待裁決的形式讓人以為還有人會去看它。
+
+---
+
+## 匯總報告
+
+每一份治理報告——合規摘要、閘門報告、KPI 匯總、紅線掃描——都是對某個集合提出的宣稱。這個宣稱的價值，恰好等於它對「自己判不了什麼」的交代的價值。
+
+**規則 GOV-RPT-001（必要）**——報告必須印出三個數字，不能只印兩個：**通過**、**失敗**、**判不了**（無法解析的檔案、缺欄位、來源不可達、不支援的格式）。
+
+**規則 GOV-RPT-002（必要）**——「判不了」**不得**併入「通過」，也**不得**省略。一份解析不了的檔案不是一份乾淨的檔案。只印「N 項檢查通過」的報告，不論 N 是多少都不合規。
+
+**規則 GOV-RPT-003（必要）**——報告必須寫出自己的**分母**以及分母是怎麼推導出來的。範圍來自硬編碼清單的報告，是一份關於那份清單的報告，不是關於這個專案的報告：清單之外的東西全部腐壞，它照樣是綠的。要用「走訪並排除」推導集合，不要用列舉——見[類別層級修正](class-level-fix.md)。
+
+**規則 GOV-RPT-004（必要）**——正向與負向計數分開回報；絕不合併成單一的合規分數。**一個「什麼都不做」與「把工作做完」得分相同的指標，量的不是那份工作。**「11 項中通過 5 項」與「檢查器從未啟動」產生同一個數字，而單一分數分不出這兩者。
+
+**規則 GOV-RPT-005（建議）**——當報告的正確性取決於它自己的工具能運作時，加一隻金絲雀：一個輸入已知會失敗、因此**必須**失敗的檢查。若金絲雀通過了，整份報告不可信，必須整份回報為「判不了」，而不是綠燈。
+
+---
+
+## 新鮮度指標
+
+**規則 GOV-FRESH-001（必要）**——任何新鮮度／停滯指標都必須指名它讀的是下列哪一個時鐘：
+
+| 時鐘 | 回答的問題 | 可以從哪裡讀 |
+|------|-----------|-------------|
+| **編輯時間** | 這份產物上次被改動是多久以前？ | 檔案 mtime、最後動到它的 commit、「最後更新」欄位 |
+| **對帳時間** | 這份產物上次與它宣稱在描述的真實來源做比對是多久以前？ | 那次比對被記下的日期——沒有別的東西能提供它 |
+
+**規則 GOV-FRESH-002（必要）**——兩者**不得**共用同一個欄位或同一個欄位標題。它們回答不同的問題，而同一份產物可以在其中一個上滿分、在另一個上任意地舊：一份今天剛編輯、內容從未與現實對過的文件，以編輯時間算是零天，以對帳時間算是無上限。
+
+**規則 GOV-FRESH-003（必要）**——只有編輯時間可取得時，報告必須把該欄標示為編輯時間，**並且**把對帳時間回報為「判不了」（GOV-RPT-001）——絕不能標成新鮮，也絕不能省略不提。
+
+**規則 GOV-FRESH-004（建議）**——對帳時間只有在「由執行該比對的東西自己記下」時才有意義。事後由人手動填入的日期是一項斷言，不是一次量測；請如實標示。
+
+> 這是「單軸裝多維」的失敗：一個欄位，被兩個不同的問題讀取。這個欄位永遠不會被抓到是錯的，因為從來沒有人問過它在回答哪一個問題。
+
 ---
 
 ## 治理檔案結構
@@ -156,4 +227,46 @@ governance/
 - [ ] Goals 清單存在，每個 KPI 均含：id、metric_name、threshold、measurement_method
 - [ ] 沒有任何 KPI 使用模糊詞彙（「改善」、「提升」、「更好」）
 - [ ] 若 `gate.mode = trace_only`，`mission.md` 中存在風險接受條款
+- [ ] 每一份風險接受條款都有 `review_by` 日期，且沒有任何一份已經過期
+- [ ] 專案已宣告待裁決事項記在哪裡、以及哪一個固定標記代表一項待裁決
+- [ ] 每一項待裁決事項都有裁決期限日期
+- [ ] 待裁決事項要麼被某個會執行的東西列舉，要麼被無人看管宣告涵蓋
+- [ ] 每一份治理報告都分開印出「通過／失敗／**判不了**」，並寫出分母與分母的推導方式
+- [ ] 沒有任何報告把正向與負向計數合併成單一分數
+- [ ] 每一個新鮮度指標都指名自己讀的是編輯時間或對帳時間，且兩者不共用欄位
 - [ ] 所有 AI 評估器以 0.4/0.3/0.3 權重評分，且任一軸 < 0.3 即不通過
+
+---
+
+## 執行現實
+
+> **本標準對它的任何一條規則都不提供檢查器——不只是 1.1.0 新增的那些，也包括自 1.0.0 起就在裡面的那條 fail-closed 風險接受要求。這是已知代價，寫在這裡，而不是留給採用者自己撞到。**
+> 
+> 2026-08-20 實測：`review_by`、`risks_accepted`、`gates_bypassed` **沒有出現在任何程式裡**——UDS CLI 沒有，任何消費端也沒有。那句寫著 pipeline「必須拒絕啟動」的條款，在它被寫下來的三個半月裡，**從來沒有讓任何一條 pipeline 拒絕啟動過**。把這件事講明白不是外加的但書，它就是本節自己的規則套用在本節身上；而本節的初稿只列出新規則為未執行，那會讓人以為舊的那條有在執行。
+>
+> UDS 定義的是這些要求，它不提供執行這些要求的程式。想要它們被執行的採用者必須自己寫那支列舉器、那支三態計數報告器、那個對帳日期記錄器——而多數人不會寫。那正是本標準所描述的失敗，現在同樣適用於本標準自己。
+>
+> 所以最低標準**不是**「去把工具做出來」，而是：**任何被記載為待裁決、已接受、或新鮮的東西，要麼指向一個會執行的檢查，要麼明白說出沒有東西在看它。** 宣告「無人看管」是合規的。無人看管卻不宣告，才是這些規則真正禁止的唯一結果，因為只有它會讓讀者對「有沒有東西在看」產生誤解。
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.1.0 | 2026-08-20 | 新增：風險接受條款的 `review_by` 欄位 + 接受到期的三種處置與禁止自動延期；待裁決事項（GOV-PD-001..004）；匯總報告（GOV-RPT-001..005——通過／失敗／判不了、分母推導、不得合併成單一分數、金絲雀）；新鮮度指標（GOV-FRESH-001..004——編輯時間與對帳時間不得共用欄位）；執行現實說明；合規檢查清單擴充 |
+| 1.0.0 | 2026-05-07 | 初始版本：Vision/Mission/Goals 三層架構、紅線格式、評估器整合、風險接受條款、合規檢查清單 |
+
+---
+
+## 相關標準
+
+- [技術債標準](tech-debt-standards.md) — 「到期處置」定義了本標準沿用的三種處置
+- [類別層級修正](class-level-fix.md) — 以走訪並排除而非列舉推導集合（GOV-RPT-003）
+- [驗證證據](verification-evidence.md) — 為何綠燈必須被證明來自一個真的在運作的檢查（GOV-RPT-005）
+
+---
+
+## 授權
+
+本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。

package/bundled/locales/zh-TW/core/iac-design-principles.md

@@ -2,8 +2,8 @@
 source: ../../../core/iac-design-principles.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: 6cf9c75621e0
+last_synced: 2026-07-23
+source_hash: beecfddec375
 status: current
 ---
 

package/bundled/locales/zh-TW/core/incident-response.md

@@ -2,8 +2,8 @@
 source: ../../../core/incident-response.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: b1c1a516710b
+last_synced: 2026-07-23
+source_hash: 251b05a9fd51
 status: current
 ---
 

package/bundled/locales/zh-TW/core/model-provenance.md

@@ -2,8 +2,8 @@
 source: ../../../core/model-provenance.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: 62e6b25a38dd
+last_synced: 2026-07-23
+source_hash: 59e471405e7e
 status: current
 ---
 
@@ -15,6 +15,8 @@ status: current
 > **AI 最佳化版本**: `ai/standards/model-provenance.ai.yaml`
 > **規格**: XSPEC-255 (cross-project/specs/XSPEC-255-model-provenance-policy.md)
 
+**Scope**: universal
+
 ## 概述
 
 模型選擇不只是「成本 × 品質」——還有 **第三軸：模型的*來源*是否被客戶接受**（地緣政治 /

package/bundled/locales/zh-TW/core/pii-classification.md

@@ -1,17 +1,17 @@
 ---
 source: ../../../core/pii-classification.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: f4ff92c3fe1d
-status: stale
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-07-23
+source_hash: 16bf07c4e383
+status: current
 ---
 
 # PII 分類與處理標準
 
 > **Language**: [English](../../../core/pii-classification.md) | 繁體中文
 
-> **版本**: 1.0.0 | **狀態**: Active | **更新日期**: 2026-06-17
+> **版本**: 1.1.0 | **狀態**: Active | **更新日期**: 2026-06-19
 > **AI 最佳化版本**: `ai/standards/pii-classification.ai.yaml`
 > **規格**: XSPEC-066（cross-project/specs/XSPEC-066-uds-compliance-audit-pack.md）
 
@@ -90,6 +90,41 @@ TIER-1 或 TIER-2 PII 的跨國境傳輸 MUST 遵循適用的傳輸機制。EU
 - **`database-standards`**——資料字典欄位帶有 PII 等級與 REQ-002 的文件化目的／
   法律依據。
 
+## PII 發現與交接契約
+
+上述整合僅指出了消費方，但交接需要明確定義的**觸發點、介面、負責人與狀態**——
+否則「驅動遮罩規則」只是一種主張，而非契約。本節沿用 `data-contract` REQ-005
+的消費方註冊模型，以及 `agent-communication-protocol` §3 的結構化交接形式。
+
+### 觸發點——分類何時啟動
+
+| 時機 | 發生的事 |
+|------|----------|
+| 新功能設計 | REQ-006 PII 衝擊評估**須於**實作前為每個新 PII 欄位分類 |
+| PR／掃描時 | 帶有 PII 但無等級標記的欄位為**阻擋（blocking）**發現（CI） |
+| 資料字典變更 | `database-standards` 欄位新增／移除 PII 等級 → 重新通知消費方 |
+
+### 介面——傳遞的內容
+
+生產方產出物是每個欄位的**PII 分類登錄（registry）**項目：
+`{ field, tier (TIER-1/2/3), purpose, legal_basis, masking_rule, retention }`。
+消費方依此註冊（依 `data-contract` REQ-005），並於變更時收到通知。
+
+### 負責人與已註冊消費方
+
+| 角色 | 職責 |
+|------|------|
+| 資料負責人／功能作者 | **產出**分類結果（REQ-001／REQ-006） |
+| `logging-standards`（消費方） | 對非正式環境中的 TIER-1/2 套用 `masking_rule` 並記錄日誌 |
+| `audit-trail`（消費方） | 記錄必備的存取／匯出／刪除事件 |
+| `security-standards`（消費方） | 對 TIER-1 強制執行靜態／傳輸中加密 |
+| 隱私／合規負責人 | 於任何新增 TIER-1 欄位或分類變更時**收到通知** |
+
+### 狀態轉換
+
+`Found（已發現）→ Classified（已分類，已指定等級）→ Handled（已處理：遮罩／加密／已設定保留期）→ Verified（已驗證：消費方確認規則已套用）`。
+停留在 `Found`（有 PII 但無等級）狀態的欄位**將阻擋發布**（REQ-001 + 上述 PR 時觸發規則）。
+
 ## 相關規格
 
 - XSPEC-066 — UDS 合規與稽核標準包（本標準來源）
@@ -99,4 +134,5 @@ TIER-1 或 TIER-2 PII 的跨國境傳輸 MUST 遵循適用的傳輸機制。EU
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| v1.1.0 | 2026-06-19 | 新增：PII 發現與交接契約（觸發點／介面／負責人／狀態），使宣稱與 logging-standards／audit-trail 的交接成為明確契約而非空談（XSPEC-292 T16） |
 | v1.0.0 | 2026-06-17 | 初版——REQ-001~006：PII 等級、資料最小化、非正式環境遮罩、保留／刪除、跨境傳輸、PIA（XSPEC-066） |

package/bundled/locales/zh-TW/core/prd-standards.md

@@ -2,8 +2,8 @@
 source: ../../../core/prd-standards.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: 3addb642ee83
+last_synced: 2026-07-23
+source_hash: 73615684c1be
 status: current
 ---
 
@@ -15,6 +15,8 @@ status: current
 > **AI 最佳化版本**: `ai/standards/prd-standards.ai.yaml`
 > **規格**: XSPEC-069（cross-project/specs/XSPEC-069-uds-product-layer-pack.md）
 
+**Scope**: universal
+
 ## 概觀
 
 本標準定義**產品需求文件（PRD）**的結構、內容要求與生命週期治理。涵蓋五大必備

package/bundled/locales/zh-TW/core/product-metrics-standards.md

@@ -2,8 +2,8 @@
 source: ../../../core/product-metrics-standards.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: e37a44aefd92
+last_synced: 2026-07-23
+source_hash: 111babd0b39d
 status: current
 ---
 
@@ -15,6 +15,8 @@ status: current
 > **AI 最佳化版本**: `ai/standards/product-metrics-standards.ai.yaml`
 > **規格**: XSPEC-069（cross-project/specs/XSPEC-069-uds-product-layer-pack.md）
 
+**Scope**: universal
+
 ## 概觀
 
 本標準定義團隊如何**選擇、結構化與治理產品指標**。涵蓋框架選用矩陣（成長型用

package/bundled/locales/zh-TW/core/release-readiness-gate.md

@@ -2,8 +2,8 @@
 source: ../../../core/release-readiness-gate.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: 3d156e19680e
+last_synced: 2026-07-23
+source_hash: 622d8cb59abb
 ---
 
 # 發布就緒閘門（Release Readiness Gate）

package/bundled/locales/zh-TW/core/resource-cost-boundary.md

@@ -2,8 +2,8 @@
 source: ../../../core/resource-cost-boundary.md
 source_version: 1.0.0
 translation_version: 1.0.0
-last_synced: 2026-06-17
-source_hash: a9be6a420041
+last_synced: 2026-07-30
+source_hash: 9c3d4359e7a0
 status: current
 ---