universal-dev-standards 5.17.0 → 6.1.0

package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md

@@ -0,0 +1,296 @@
+---
+source: skills/dev-methodology/runtime.md
+source_version: 1.0.0
+translation_version: 1.0.0
+status: current
+---
+
+# Methodology Runtime 指南
+
+> **語言**: [English](../../../../skills/dev-methodology/runtime.md) | 繁體中文
+
+> [!WARNING]
+> **實驗性功能 / Experimental Feature**
+>
+> 此功能正在積極開發中，可能在 v4.0 中有重大變更。
+> This feature is under active development and may change significantly in v4.0.
+
+**版本**: 1.0.0
+**最後更新**: 2026-01-12
+
+---
+
+## 總覽
+
+本文件定義 AI 助理在某個開發 methodology 啟用時應有的行為。它提供 phase 追蹤、checkpoint 處理及使用者互動的指引。
+
+---
+
+## AI 行為規格
+
+### 1. Context 感知
+
+當某個 methodology 啟用時，AI 應該：
+
+- **始終知道目前的 phase**
+- **在回應中顯示 phase 指示器**
+- **建議符合該 phase 的動作**
+
+#### Phase 狀態顯示
+
+在相關回應的開頭加入 methodology 狀態：
+
+```
+┌────────────────────────────────────────────────┐
+│ 📋 Methodology: TDD                             │
+│ 📍 Phase: 🔴 RED (writing failing test)         │
+│ ⏱️  Duration: 3 minutes                         │
+└────────────────────────────────────────────────┘
+```
+
+### 2. 主動指引
+
+根據目前的 phase 提供符合 context 的建議：
+
+```markdown
+**Current Phase: 🔴 RED (TDD)**
+
+You're writing a failing test for: user login validation
+
+**Next step**: Write a test that describes the expected behavior.
+
+Would you like me to:
+1. Generate a test skeleton
+2. Show TDD best practices for this scenario
+3. Continue with your manual approach
+```
+
+### 3. Phase 轉換偵測
+
+監控那些代表 phase 轉換的條件：
+
+| Signal | Transition |
+|--------|------------|
+| Test 執行失敗 | RED → ready for GREEN |
+| 所有 test 通過 | GREEN → ready for REFACTOR |
+| 使用者確認 refactor 完成 | REFACTOR → next cycle or DONE |
+| 時間超過 phase duration | 顯示提醒 |
+| 偵測到 Git commit | 重置 phase 計時器 |
+
+### 4. Checkpoint 行為
+
+當 checkpoint 條件觸發時，顯示 checkpoint 通知：
+
+```
+┌────────────────────────────────────────────────┐
+│ 🔔 Methodology Checkpoint                       │
+├────────────────────────────────────────────────┤
+│ GREEN phase completed                          │
+│                                                │
+│ Checklist Status:                              │
+│   ✅ Minimum code written                      │
+│   ✅ Test passes                               │
+│   ✅ All other tests pass                      │
+│   ⬜ (Optional) Consider edge cases            │
+│                                                │
+│ Change Statistics:                             │
+│   - Files: 3                                   │
+│   - Added: 45 lines                            │
+│   - Deleted: 2 lines                           │
+│                                                │
+│ Suggested commit:                              │
+│   test(auth): add email validation test        │
+│   feat(auth): implement email validation       │
+│                                                │
+│ Options:                                       │
+│   [1] Commit now (show git commands)           │
+│   [2] Continue to REFACTOR phase               │
+│   [3] View detailed changes                    │
+└────────────────────────────────────────────────┘
+```
+
+### 5. Skip 追蹤
+
+追蹤連續的 skip 並適當地警告：
+
+| Skip Count | Action |
+|------------|--------|
+| 1-2 | 不採取動作，記錄 skip |
+| 3 | 警告通知 |
+| 4+ | 強烈警告，建議 commit |
+
+#### Skip 警告顯示
+
+```
+┌────────────────────────────────────────────────┐
+│ ⚠️ Skip Warning                                 │
+├────────────────────────────────────────────────┤
+│ You have skipped check-in 3 times consecutively│
+│                                                │
+│ Current accumulated changes:                   │
+│   - Files: 8                                   │
+│   - Added: 320 lines                           │
+│   - Deleted: 45 lines                          │
+│                                                │
+│ Recommendation: Commit your changes now to     │
+│ avoid losing work and maintain atomic commits. │
+│                                                │
+│ [1] Commit now  [2] Skip anyway  [3] View diff │
+└────────────────────────────────────────────────┘
+```
+
+---
+
+## Methodology 偵測
+
+### 自動偵測
+
+AI 應從以下來源偵測 methodology context：
+
+1. **Manifest 配置**
+   ```json
+   // .standards/manifest.json
+   { "methodology": { "active": "tdd" } }
+   ```
+
+2. **關鍵字偵測**
+   - "Let's use TDD for this"
+   - "Write a failing test first"
+   - "Given-When-Then"
+   - "Create a spec for this change"
+
+3. **命令呼叫**
+   - `/tdd`, `/bdd`, `/sdd`, `/atdd`
+   - `/methodology switch <id>`
+
+### 載入 Methodology 定義
+
+```
+Methodology Loading Priority:
+1. Custom: .standards/methodologies/{id}.methodology.yaml
+2. Built-in: methodologies/{id}.methodology.yaml
+3. Fallback: Generic phase-less workflow
+```
+
+---
+
+## Checklist 管理
+
+### 顯示格式
+
+```markdown
+### Phase Checklist
+
+**Required:**
+- [ ] Test describes expected behavior
+- [x] Test name is clear
+- [ ] Test follows AAA pattern
+
+**Optional:**
+- [ ] Consider edge cases
+```
+
+### 追蹤
+
+- 根據使用者動作與程式碼分析更新 checklist 項目
+- 若 required 項目未完成則阻擋 phase 轉換（strict mode）
+- 記錄完成狀態以供稽核軌跡使用
+
+---
+
+## 整合點
+
+### 與 Git 整合
+
+- 偵測 commit 以重置 phase 計時器
+- 根據 methodology 建議 commit message
+- 自動納入 spec/story 參照
+
+### 與 Test Runner 整合
+
+- 偵測 test 通過/失敗以觸發 phase 轉換
+- 回報與目前 phase 相關的 test 覆蓋率
+
+### 與 Code Review 整合
+
+- 加入 methodology 專屬的 review 檢查
+- 在 PR 描述中參照啟用中的 methodology
+
+---
+
+## 錯誤處理
+
+### 找不到 Methodology
+
+```
+⚠️ Methodology 'custom-workflow' not found.
+
+Available methodologies:
+- tdd (built-in)
+- bdd (built-in)
+- sdd (built-in)
+- atdd (built-in)
+
+Use `/methodology list` to see all options.
+```
+
+### 無效的 Phase 轉換
+
+```
+⚠️ Cannot transition from RED to REFACTOR.
+
+TDD requires: RED → GREEN → REFACTOR
+
+Current phase: RED
+Valid next phases: GREEN
+
+Complete the RED phase checklist first.
+```
+
+---
+
+## 效能考量
+
+- 首次載入後快取 methodology 定義
+- 僅在 manifest 變更時才重新載入
+- 最小化 checkpoint 頻率以避免打斷
+- 批次執行 git status 檢查
+
+---
+
+## 在地化（Localization）
+
+所有面向使用者的文字都應使用適當的語言欄位：
+
+```yaml
+# If user's locale is zh-TW
+name: nameZh || name
+description: descriptionZh || description
+prompt: promptZh || prompt
+```
+
+---
+
+## 6. Prerequisite 檢查 / Prerequisite Checking
+
+在執行任何 slash 命令之前，請遵循定義於
+[`prerequisite-check.md`](../../../../skills/dev-methodology/prerequisite-check.md) 的 prerequisite 檢查協議。
+
+**Priority**: 此檢查會在 phase 追蹤與 methodology 偵測之前執行。
+
+**與 Phase 追蹤的整合**：
+- 若使用者處於啟用中的 methodology session，使用該 methodology 的 phase
+  序列作為主要的 prerequisite 來源
+- 若無啟用中的 methodology，使用 [`workflow-prerequisites.yaml`](../../../../methodologies/workflow-prerequisites.yaml) 作為 fallback
+- 若多個 workflow 都包含該命令，只需滿足其中一個即可
+
+**Reference**: 完整的演算法、evidence 偵測規則及使用者提示模板，請參閱 [`prerequisite-check.md`](../../../../skills/dev-methodology/prerequisite-check.md)。
+
+---
+
+## 版本歷史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.1.0 | 2026-02-12 | 新增 §6 Prerequisite Checking 整合 |
+| 1.0.0 | 2026-01-12 | Initial runtime specification |

package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md

@@ -34,7 +34,7 @@ V. Release ──► VI. Documentation ──► VII. Standards ──► VIII.
 | **I. 規劃與設計** | `/brainstorm` `/requirement` `/sdd` `/reverse` `/api-design` `/database` | Requirements, specs, API/DB design | 需求、規格、API/DB 設計 |
 | **II. 測試驅動開發** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` `/ac-coverage` | Design tests before code | 先寫測試再寫程式 |
 | **III. 實作** | `/refactor` `/reverse` `/migrate` `/durable` | Write, improve, and migrate code | 撰寫、改善與遷移程式碼 |
-| **IV. 品質關卡** | `/checkin` `/review` `/security` `/scan` `/incident` | Quality, security, incident response | 品質、安全、事故回應 |
+| **IV. 品質關卡** | `/checkin` `/code-review` `/security` `/scan` `/incident` | Quality, security, incident response | 品質、安全、事故回應 |
 | **V. 發布與提交** | `/commit` `/changelog` `/release` `/pr` `/ci-cd` | Version, commit, PR, CI/CD | 版本、提交、PR、CI/CD |
 | **VI. 文件** | `/docs` `/docgen` | Docs and project structure | 文件與專案結構 |
 | **VII. 工具與標準** | `/discover` `/guide` `/metrics` `/audit` | Reference guides, metrics, audit | 參考指南、指標、審計 |
@@ -162,7 +162,7 @@ API 設計與實作的推薦流程：
 2. **階段參數**：顯示該階段的詳細指引，包含所有相關指令與範例
 3. **場景參數**：顯示該場景的推薦逐步工作流程
 
-此技能會從 [workflow-phases.md](./workflow-phases.md) 讀取詳細的階段資訊。
+此技能會從 [workflow-phases.md](../../../../skills/dev-workflow-guide/workflow-phases.md) 讀取詳細的階段資訊。
 
 ## 下一步引導
 
@@ -179,10 +179,10 @@ API 設計與實作的推薦流程：
 
 ## 參考
 
-- [詳細階段指引](./workflow-phases.md) - 完整的逐階段參考
+- [詳細階段指引](../../../../skills/dev-workflow-guide/workflow-phases.md) - 完整的逐階段參考
 - [每日工作流程指南](../../adoption/DAILY-WORKFLOW-GUIDE.md) - 完整的每日工作流程指南
-- [功能開發工作流程](../workflows/feature-dev.yaml) - 自動化功能開發工作流程
-- [整合流程工作流程](../workflows/integrated-flow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
+- [功能開發工作流程](../../../../skills/workflows/feature-dev.workflow.yaml) - 自動化功能開發工作流程
+- [整合流程工作流程](../../../../skills/workflows/integrated-flow.workflow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程
 
 ---
 

package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md

@@ -78,7 +78,7 @@ language: [en, zh-TW]
 > **文件已產生。建議下一步：**
 > - 審查產生的文件內容是否完整
 > - 執行 `/commit` 提交文件變更
-> - 執行 `/review` 審查文件品質
+> - 執行 `/code-review` 審查文件品質
 
 ## 參考
 

package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md

@@ -82,4 +82,4 @@ description: "[UDS] 從 BDD 場景生成 E2E 測試骨架，支援框架偵測
 
 ## AI 代理行為
 
-> 完整的 AI 行為定義請參閱對應的命令文件：[`/e2e`](../../commands/e2e.md#ai-agent-behavior--ai-代理行為)
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/e2e`](../../../../skills/commands/e2e.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md

@@ -139,7 +139,7 @@ docs/incidents/
 
 > **事故回應指引已提供。建議下一步：**
 > - 執行 `/commit` 建立修復提交 ⭐ **推薦**
-> - 執行 `/review` 審查修復變更
+> - 執行 `/code-review` 審查修復變更
 > - 執行 `/docs` 更新文件
 > - 執行 `/security` 檢查安全影響
 > - 執行 `/retrospective`（SEV-1/SEV-2 建議）— 團隊回顧
@@ -148,4 +148,4 @@ docs/incidents/
 ## 參考
 
 - 核心規範：[deployment-standards.md](../../../../core/deployment-standards.md)
-- 核心規範：[logging.md](../../../../core/logging.md)
+- 核心規範：[logging.md](../../../../core/logging-standards.md)

package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md

@@ -2,9 +2,10 @@
 name: logging
 description: "[UDS] 實作結構化日誌，包含正確的日誌層級和敏感資料處理"
 source: ../../../../skills/logging-guide/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-08
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-07-08
+source_hash: cf114de1df86
 status: current
 ---
 
@@ -12,8 +13,8 @@ status: current
 
 > **語言**: [English](../../../../skills/logging-guide/SKILL.md) | 繁體中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-30
+**版本**: 1.4.0
+**最後更新**: 2026-06-19
 **適用範圍**: Claude Code Skills
 
 ---
@@ -56,6 +57,28 @@ status: current
 | **ERROR** | 失敗的操作、捕獲的例外、整合失敗 |
 | **FATAL** | 無法恢復的錯誤、啟動失敗、失去關鍵資源 |
 
+## 強制事件
+
+把每則日誌格式化得再完美，但**在真正關鍵的時刻卻從不觸發**，比什麼都沒有還糟——它會在事故當下給人虛假的安心感。核心標準定義了**9 個必須產生日誌記錄的標準事件**。若日誌設定遵守層級／欄位規則卻遺漏這些事件，就是「規範上合格、實質上沉默」。務必全部實作這 9 項：
+
+| 事件 id | 時機 | 層級 | 核心必要欄位 | 不可記錄 |
+|----------|------|-------|----------------------|--------------|
+| `application_startup` | 開機後、**接受請求前** | INFO | app_name, version, git_sha, environment, hostname, pid, listening_endpoints | secrets、完整連線字串 |
+| `request_received` | Middleware 首次看到請求時 | INFO / DEBUG | method, path, source_ip, request_id | request body、auth headers |
+| `validation_failure` | schema / ModelState / DTO 驗證拒絕時 | WARN | request_id, path, missing_fields[], payload_shape（僅 keys） | 欄位**值**、PII |
+| `authentication_failure` | 登入 / token 驗證失敗時 | WARN | uid（嘗試值）, source_ip, failure_reason | password、token 值 |
+| `outbound_call_start` | 發起對外 HTTP/RPC 呼叫時 | INFO | target_url（host+path）, 傳遞的 request_id, timeout_ms | credentials、bearer tokens |
+| `outbound_call_complete` | 外部呼叫返回或失敗時 | INFO / WARN / ERROR | status_code **或** failure_phase（dns/tcp/tls/http）, elapsed_ms, retries | 含 PII 的 response body |
+| `business_event` | 具狀態改變的業務操作完成時 | INFO | operation_name, actor, target ids, outcome | 完整 record payload、PII |
+| `heartbeat` | 長期執行的背景服務，≥ 1 次 / 60 秒 | INFO | service_name, queue_depth, items_processed_since_last_heartbeat | — |
+| `shutdown` | 行程結束時（正常或致命錯誤） | INFO / ERROR | app_name, signal/reason, uptime_seconds, pending_work_count | — |
+
+**為何是這些事件**——每一項都補上一個真實的事故盲區：靜默的 `validation_failure` 會隱藏未記錄的 payload；`authentication_failure` 若缺 `uid`／`source_ip` 就無法調查；缺少 `heartbeat` 代表 0-byte 的日誌檔不會被察覺；沒有 `outbound_call_*` 會讓「送出失敗」變成一場找不到任何呼叫痕跡、耗時 2 天的追查。
+
+> 背景服務若在 60 秒內未寫入任何 INFO/WARN/ERROR，**必須**發出一則 `heartbeat`；若連續 ≥ 2 倍間隔（≥ 120 秒）都沒有出現，沉默偵測器**必須**告警。
+
+完整目錄（每個事件的 `when`／`must_log`／`must_NOT_log`／`rationale` 及合規範例），請參閱核心[日誌標準](../../core/logging-standards.md#強制事件-mandatory-events)的**強制事件**章節。
+
 ## 結構化日誌
 
 ### 必要欄位
@@ -205,6 +228,21 @@ logger.error('處理訂單失敗', {
 - 聚合指標而非個別日誌
 - 使用獨立的日誌串流
 
+## 日誌檔案輪替
+
+基於檔案的 log sink **必須**同時設定兩種輪替觸發器——時間輪替**與**大小輪替。常見函式庫的預設大小上限（Serilog 1 GB、log4j/Winston/Python `RotatingFileHandler` 無上限）在正式環境中會造成靜默資料遺失。
+
+```
+✓ rollingInterval: Day                    # 時間輪替
+✓ fileSizeLimitBytes: 104857600 (100 MB)  # 大小輪替
+✓ rollOnFileSizeLimit: true               # 輪替，不要丟棄
+✓ retainedFileCountLimit: ≥ N*7           # N = 每日最大輪替次數
+```
+
+當日誌檔案在預期的每日結束時達到 **`fileSizeLimitBytes` 的 ≥ 90%**，**調查噪音根因**（嘈雜的重試迴圈 / 不受限制的 debug 日誌 / stack trace 洪流），不要只提高上限。
+
+> 含各語言設定範例（.NET Serilog / Python / Java log4j2 / Node Winston）及真實事故失敗模式參考的完整規格：請參閱核心標準的[日誌檔案輪替政策](../../core/logging-standards.md#日誌檔案輪替政策)。
+
 ## 檢查清單
 
 ### 必要欄位
@@ -223,6 +261,13 @@ logger.error('處理訂單失敗', {
 - [ ] 信用卡從不記錄
 - [ ] 保留政策已設定
 
+### 輪替
+
+- [ ] 已設定時間輪替（`rollingInterval: Day` 或等效設定）
+- [ ] 已設定大小輪替（`fileSizeLimitBytes` + `rollOnFileSizeLimit: true`）
+- [ ] `retainedFileCountLimit` ≥ N×7（N = 每日最大輪替次數）
+- [ ] 已定義 90% 大小 SOP（調查噪音，勿只提高上限）
+
 ---
 
 ## 設定偵測
@@ -271,6 +316,8 @@ logger.error('處理訂單失敗', {
 
 | 版本 | 日期 | 變更 |
 |------|------|------|
+| 1.4.0 | 2026-06-19 | 新增：強制事件章節（9 個標準事件），消弭技能與核心標準之間的內容漂移；版號與核心日誌標準 v1.4.0 對齊（XSPEC-070 Phase 2） |
+| 1.1.0 | 2026-05-26 | 新增：日誌檔案輪替章節及指向核心標準輪替政策的交叉連結；輪替清單（XSPEC-232） |
 | 1.0.0 | 2025-12-30 | 初始發布 |
 
 ---
@@ -291,25 +338,3 @@ After `/logging` completes, the AI assistant should suggest:
 > - 執行 `/errors` 設計錯誤碼以配合日誌系統 — 讓錯誤追蹤更有效率 / Make error tracking more efficient
 > - 執行 `/sdd` 將可觀測性需求納入規格 — 確保日誌需求在規格中有定義 / Ensure logging requirements are defined in specs
 
----
-
-## Related Standards
-
-- [Logging Standards](../../core/logging-standards.md)
-- [Error Code Standards](../../core/error-code-standards.md)
-
----
-
-## Version History
-
-| Version | Date | Changes |
-|---------|------|---------|
-| 1.0.0 | 2025-12-30 | Initial release |
-
----
-
-## License
-
-This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
-
-**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md

@@ -185,7 +185,7 @@ AI: Migration Assessment: Vue 2 → Vue 3
 
 ## AI 代理行為
 
-> 完整的 AI 行為定義請參閱對應的命令文件：[`/migrate`](../commands/migrate.md#ai-agent-behavior--ai-代理行為)
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/migrate`](../../../../skills/commands/migrate.md#ai-agent-behavior--ai-代理行為)
 
 ## 授權
 

package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md

@@ -12,6 +12,8 @@ description: "[UDS] 引導 Pull Request 建立、審查自動化和合併策略"
 
 > **語言**: [English](../../../../skills/pr-automation-assistant/SKILL.md) | 繁體中文
 
+> ⚠️ **狀態：參考用（非可執行流程）** — PR 生命週期協調（5 步驟 CREATE→REVIEW→APPROVE→MERGE→CLEANUP、>400 行 size gate、CI gate、squash/merge 策略、gh CLI 整合）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 PR 描述模板、合併策略決策矩陣、auto-review 觸發規則供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
+
 簡化從建立到合併的 Pull Request 生命週期。
 
 ## PR 建立檢查清單
@@ -77,7 +79,7 @@ CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
 `/pr` 完成後，AI 助手應建議：
 
 > **PR 操作完成。建議下一步：**
-> - 執行 `/review` 進行詳細程式碼審查
+> - 執行 `/code-review` 進行詳細程式碼審查
 > - 執行 `/commit` 修正審查發現的問題
 > - 執行 `/changelog` 更新變更日誌
 > - 檢查 CI 狀態 → `gh pr checks`

package/bundled/locales/zh-TW/skills/project-discovery/guide.md

@@ -305,9 +305,9 @@ routes → controllers → services → repositories → database
 - 根據現況評估發現撰寫新功能規格
 - 在風險評估區段引用現況評估報告
 
-### 搭配 /review（程式碼審查）
+### 搭配 /code-review（程式碼審查）
 
-步驟 0.4 的快照是 `/review` 的輕量版。在以下情況使用完整的 `/review`：
+步驟 0.4 的快照是 `/code-review` 的輕量版。在以下情況使用完整的 `/code-review`：
 - 現況評估發現重大品質疑慮
 - 規劃變更前需要更深入的稽核
 

package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md

@@ -127,4 +127,4 @@ description: "[UDS] 系統考古——跨邏輯、資料、執行環境三維度
 
 ## AI 代理行為
 
-> 完整的 AI 行為定義請參閱對應的命令文件：[`/reverse`](../commands/reverse.md#ai-agent-behavior--ai-代理行為)
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/reverse`](../../../../skills/commands/reverse.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md

@@ -68,7 +68,7 @@ SCOPE ──► SCAN ──► ANALYZE ──► REPORT
 
 > **安全審查完成。建議下一步：**
 > - 執行 `/checkin` 確認修復符合提交規範
-> - 執行 `/review` 進行程式碼審查
+> - 執行 `/code-review` 進行程式碼審查
 > - 執行 `/commit` 提交安全修復
 > - 檢查相依套件更新 → `npm audit` 或 `pip audit`
 

package/bundled/locales/zh-TW/skills/spec-derivation/guide.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/spec-derivation/guide.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: 218670e49db0
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-06-10
+source_hash: 3470ae083c12
 status: current
 scope: partial
 description: |
@@ -101,7 +101,7 @@ Scenario: User login with valid credentials
 
 ### 3. 推演標籤（Derivation Tags，來自統一標籤系統）
 
-此 skill 使用 **推演標籤（Derivation Tags）** 從規格生成新內容。完整的標籤參考請見 [Anti-Hallucination Standards](../../core/anti-hallucination.md#certainty-classification-tags)。
+此 skill 使用 **推演標籤（Derivation Tags）** 從規格生成新內容。完整的標籤參考請見 [Anti-Hallucination Standards](../../../../core/anti-hallucination.md#certainty-classification-tags)。
 
 | 標籤 | 使用時機 | 範例 |
 |-----|----------|---------|
@@ -220,18 +220,17 @@ Scenario: Login shows error for invalid credentials
 # Generator: /derive-bdd v1.0.0
 # Generated at: 2026-01-19T10:00:00Z
 
-@SPEC-001
 Feature: User Authentication
   [Source] From SPEC-001 Summary
 
-  @AC-1 @happy-path
+  @SPEC-001 @AC-1 @happy-path
   Scenario: User login with valid credentials
     # [Source] From SPEC-001 AC-1
     Given a registered user with valid credentials
     When the user submits login form
     Then the user is redirected to dashboard
 
-  @AC-2 @error-handling
+  @SPEC-001 @AC-2 @error-handling
   Scenario: Login fails with invalid credentials
     # [Source] From SPEC-001 AC-2
     Given a user with invalid credentials

package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md

@@ -213,6 +213,6 @@ The system SHALL [behavior description].
 
 ## AI Agent Behavior | AI 代理行為
 
-> 完整的 AI 行為定義請參閱對應的命令文件：[`/sdd`](../commands/sdd.md#ai-agent-behavior--ai-代理行為)
+> 完整的 AI 行為定義請參閱對應的命令文件：[`/sdd`](../../../../skills/commands/sdd.md#ai-agent-behavior--ai-代理行為)
 >
-> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](../commands/sdd.md#ai-agent-behavior--ai-代理行為)
+> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](../../../../skills/commands/sdd.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-TW/skills/sweep/SKILL.md

@@ -123,7 +123,7 @@ sweep:
 `/sweep` 完成後建議：
 
 > - 執行 `/checkin` 在提交前驗證整體程式碼品質
-> - 執行 `/review` 審查清理後的變更
+> - 執行 `/code-review` 審查清理後的變更
 > - 執行 `/commit` 提交修正
 
 ---

package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md

@@ -12,6 +12,8 @@ description: "[UDS] 引導測試驅動開發（TDD）流程：紅-綠-重構"
 
 > **語言**: [English](../../../../skills/tdd-assistant/SKILL.md) | 繁體中文
 
+> ⚠️ **狀態：參考用（非可執行流程）** — TDD 流程協調（RED→GREEN→REFACTOR 循環、測試執行 gates）已於 2026-04-28 移至 **adoption layer（XSPEC-095）**。此處保留 TDD 原則、FIRST 規則、AAA 格式、語言範例、流程指南供參考；需要強制執行的流程請改用你的 adoption layer 工具鏈。
+
 引導測試驅動開發（TDD）流程：紅-綠-重構。
 
 ## TDD 循環
@@ -65,7 +67,7 @@ description: "[UDS] 引導測試驅動開發（TDD）流程：紅-綠-重構"
 > **TDD 循環完成。建議下一步：**
 > - 執行 `/checkin` 通過品質關卡
 > - 執行 `/coverage` 確認測試覆蓋率
-> - 執行 `/review` 自我審查程式碼
+> - 執行 `/code-review` 自我審查程式碼
 
 ## 參考
 

package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md

@@ -98,7 +98,7 @@ UDS 提供 6 個與測試相關的 Skill。請使用以下決策樹找到合適
 - [測試標準](../../core/testing-standards.md) - 可執行的規則
 - [測試理論](./testing-theory.md) - 教學知識庫
 - [測試金字塔](./testing-pyramid.md) - 詳細的金字塔比例
-- [測試骨架範本](./test-skeleton-templates.md) - UT/IT/ST/Perf/Contract 的多語言骨架
+- [測試骨架範本](../../../../skills/testing-guide/test-skeleton-templates.md) - UT/IT/ST/Perf/Contract 的多語言骨架
 
 ### AI 優化格式（Token 高效）
 
@@ -115,7 +115,7 @@ UDS 提供 6 個與測試相關的 Skill。請使用以下決策樹找到合適
   - 安全測試：`ai/options/testing/security-testing.ai.yaml`
   - 效能測試：`ai/options/testing/performance-testing.ai.yaml`
   - 合約測試：`ai/options/testing/contract-testing.ai.yaml`
-- 骨架範本（所有層級、多語言）：[test-skeleton-templates.md](./test-skeleton-templates.md)
+- 骨架範本（所有層級、多語言）：[test-skeleton-templates.md](../../../../skills/testing-guide/test-skeleton-templates.md)
 
 ## 命名慣例