universal-dev-standards 5.3.2 → 5.5.0

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

@@ -1,279 +0,0 @@
----
-source: ../../../../skills/methodology-system/runtime.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-12
-status: experimental
----
-
-# 方法論執行時引導
-
-> **Language**: [English](../../../../skills/methodology-system/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 助手應如何行為。提供階段追蹤、檢查點處理和用戶互動的引導。
-
----
-
-## AI 行為規格
-
-### 1. 上下文感知
-
-當方法論啟用時，AI 應該：
-
-- **始終知道當前階段**
-- **在回應中顯示階段指示器**
-- **建議階段適當的行動**
-
-#### 階段狀態顯示
-
-在相關回應開頭包含方法論狀態：
-
-```
-┌────────────────────────────────────────────────┐
-│ 📋 方法論: TDD                                  │
-│ 📍 階段: 🔴 紅燈（撰寫失敗的測試）               │
-│ ⏱️  持續時間: 3 分鐘                            │
-└────────────────────────────────────────────────┘
-```
-
-### 2. 主動引導
-
-根據當前階段提供上下文適當的建議：
-
-```markdown
-**當前階段: 🔴 紅燈 (TDD)**
-
-您正在為以下功能撰寫失敗的測試：用戶登入驗證
-
-**下一步**：撰寫描述預期行為的測試。
-
-您希望我：
-1. 產生測試骨架
-2. 展示此場景的 TDD 最佳實踐
-3. 繼續您的手動方式
-```
-
-### 3. 階段轉換偵測
-
-監控表示階段轉換的條件：
-
-| 訊號 | 轉換 |
-|------|------|
-| 測試執行失敗 | 紅燈 → 準備進入綠燈 |
-| 所有測試通過 | 綠燈 → 準備重構 |
-| 用戶確認重構完成 | 重構 → 下一個週期或完成 |
-| 經過時間超過階段持續時間 | 顯示提醒 |
-| 偵測到 Git 提交 | 重置階段計時器 |
-
-### 4. 檢查點行為
-
-當檢查點條件觸發時，顯示檢查點通知：
-
-```
-┌────────────────────────────────────────────────┐
-│ 🔔 方法論檢查點                                 │
-├────────────────────────────────────────────────┤
-│ 綠燈階段完成                                    │
-│                                                │
-│ 檢查清單狀態：                                  │
-│   ✅ 撰寫最少程式碼                            │
-│   ✅ 測試通過                                   │
-│   ✅ 所有其他測試通過                           │
-│   ⬜ （選填）考慮邊界情況                       │
-│                                                │
-│ 變更統計：                                      │
-│   - 檔案: 3                                     │
-│   - 新增: 45 行                                 │
-│   - 刪除: 2 行                                  │
-│                                                │
-│ 建議提交：                                      │
-│   test(auth): 新增郵箱驗證測試                  │
-│   feat(auth): 實作郵箱驗證                      │
-│                                                │
-│ 選項：                                          │
-│   [1] 立即提交（顯示 git 命令）                 │
-│   [2] 繼續到重構階段                            │
-│   [3] 檢視詳細變更                              │
-└────────────────────────────────────────────────┘
-```
-
-### 5. 跳過追蹤
-
-追蹤連續跳過並適當警告：
-
-| 跳過次數 | 行動 |
-|----------|------|
-| 1-2 | 無行動，記錄跳過 |
-| 3 | 警告通知 |
-| 4+ | 強烈警告，建議提交 |
-
-#### 跳過警告顯示
-
-```
-┌────────────────────────────────────────────────┐
-│ ⚠️ 跳過警告                                     │
-├────────────────────────────────────────────────┤
-│ 您已連續跳過簽入 3 次                           │
-│                                                │
-│ 當前累積變更：                                  │
-│   - 檔案: 8                                     │
-│   - 新增: 320 行                                │
-│   - 刪除: 45 行                                 │
-│                                                │
-│ 建議：立即提交您的變更以避免遺失工作並維持      │
-│ 原子化提交。                                    │
-│                                                │
-│ [1] 立即提交  [2] 仍然跳過  [3] 檢視差異        │
-└────────────────────────────────────────────────┘
-```
-
----
-
-## 方法論偵測
-
-### 自動偵測
-
-AI 應從以下來源偵測方法論上下文：
-
-1. **Manifest 配置**
-   ```json
-   // .standards/manifest.json
-   { "methodology": { "active": "tdd" } }
-   ```
-
-2. **關鍵字偵測**
-   - 「讓我們用 TDD 來做這個」
-   - 「先寫一個失敗的測試」
-   - 「Given-When-Then」
-   - 「為這個變更建立規格」
-
-3. **命令調用**
-   - `/tdd`、`/bdd`、`/sdd`、`/atdd`
-   - `/methodology switch <id>`
-
-### 載入方法論定義
-
-```
-方法論載入優先順序：
-1. 自訂: .standards/methodologies/{id}.methodology.yaml
-2. 內建: methodologies/{id}.methodology.yaml
-3. 備用: 通用無階段工作流
-```
-
----
-
-## 檢查清單管理
-
-### 顯示格式
-
-```markdown
-### 階段檢查清單
-
-**必須：**
-- [ ] 測試描述預期行為
-- [x] 測試名稱清晰
-- [ ] 測試遵循 AAA 模式
-
-**選填：**
-- [ ] 考慮邊界情況
-```
-
-### 追蹤
-
-- 根據用戶行動和程式碼分析更新檢查清單項目
-- 嚴格模式下，必填項目未完成則阻止階段轉換
-- 記錄完成情況以供審計追蹤
-
----
-
-## 整合點
-
-### 與 Git
-
-- 偵測提交以重置階段計時器
-- 根據方法論建議提交訊息
-- 自動包含規格/故事參考
-
-### 與測試執行器
-
-- 偵測測試通過/失敗以觸發階段轉換
-- 報告與當前階段相關的測試覆蓋率
-
-### 與程式碼審查
-
-- 添加方法論特定的審查檢查
-- 在 PR 描述中參考啟用的方法論
-
----
-
-## 錯誤處理
-
-### 找不到方法論
-
-```
-⚠️ 找不到方法論 'custom-workflow'。
-
-可用的方法論：
-- tdd（內建）
-- bdd（內建）
-- sdd（內建）
-- atdd（內建）
-
-使用 `/methodology list` 查看所有選項。
-```
-
-### 無效的階段轉換
-
-```
-⚠️ 無法從紅燈轉換到重構。
-
-TDD 要求：紅燈 → 綠燈 → 重構
-
-當前階段：紅燈
-有效的下一個階段：綠燈
-
-請先完成紅燈階段的檢查清單。
-```
-
----
-
-## 效能考量
-
-- 首次載入後快取方法論定義
-- 僅在 manifest 變更時重新載入
-- 最小化檢查點頻率以避免中斷
-- 批次處理 git 狀態檢查
-
----
-
-## 本地化
-
-所有面向用戶的文字應使用適當的語言欄位：
-
-```yaml
-# 如果用戶的地區設定是 zh-TW
-name: nameZh || name
-description: descriptionZh || description
-prompt: promptZh || prompt
-```
-
----
-
-## 版本歷史
-
-| 版本 | 日期 | 變更 |
-|------|------|------|
-| 1.0.0 | 2026-01-12 | 初始執行時規格 |

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

@@ -1,144 +0,0 @@
----
-name: process-automation
-source: ../../../../skills/process-automation/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-10
-status: current
-description: "[UDS] 識別重複流程並以正確開發深度建立 Skill"
----
-
-# 流程轉化 Skill 助手
-
-> **語言**: [English](../../../../skills/process-automation/SKILL.md) | 繁體中文
-
-從「我一直在手動做這件事」引導你建立一個合適的 Skill，並在過程中採用恰當深度的開發流程。
-
-## 使用時機
-
-- 你已手動執行同一組多步驟流程 ≥ 3 次
-- 隊友第 3 次問「我們怎麼做 X？」
-- 你臨時建了一個 Skill，想要正式化它
-
-## 核心原則
-
-> **Skill 記錄流程知識。Memory 記錄歷史事實。**
-> 當你發現自己在重複執行相同步驟時，那就是 Skill 候選。
-
-## 決策樹
-
-```
-需要新 Skill？
-├── 修改現有 Skill？
-│     → Delta 路徑：在現有 SKILL.md 末尾附加 ## MODIFIED / ## ADDED
-│                   更新 version 欄位 → 完成
-│
-├── 回答這 4 個問題（任何一個「是」→ Complex）：
-│     1. 超過 7 個步驟？
-│     2. 步驟之間有分支邏輯（if/else）？
-│     3. 需要來自 3 個以上獨立標準/決策的知識？
-│     4. 輸出直接影響子專案的原始碼？
-│
-├── 全部「否」→ Simple 路徑
-│     → 填寫 Skill Brief（templates/SKILL-BRIEF-TEMPLATE.md）
-│     → 直接建立 SKILL.md（不需要 XSPEC）
-│
-└── 任何「是」→ Complex 路徑
-      → 先建立 XSPEC → 執行 /sdd
-      → XSPEC 核准後回到這裡
-
-廢棄 Skill？
-  → 在 SKILL.md frontmatter 加入：
-      status: deprecated
-      deprecated_at: YYYY-MM-DD
-      deprecated_reason: "..."
-      superseded_by: "/new-skill"   （如有適用）
-  → 在 SKILL-CANDIDATES.md 中標記為已歸檔
-```
-
-## 放置位置決策
-
-建立 SKILL.md 前，先決定它應放在哪裡：
-
-| 條件 | 放置位置 |
-|------|----------|
-| 步驟引用專案特定路徑（如 TECH-RADAR.md、DEC-*.md） | 專案：`{project}/.claude/skills/` |
-| 步驟通用（無專案特定路徑） | UDS：`skills/{name}/` + zh-TW 語系 |
-
-## 工作流程
-
-### 步驟 1 — 描述流程
-
-記錄重複的步驟序列：
-- 哪些步驟？按什麼順序？
-- 目前已手動執行幾次？
-- 會觸碰哪些工具或檔案？
-
-### 步驟 2 — 更新 SKILL-CANDIDATES.md
-
-開啟你專案的 `SKILL-CANDIDATES.md`（第一次使用時從 `templates/SKILL-CANDIDATES.md` 複製）：
-- 尚未記錄 → 新增一行，填入目前次數
-- 已記錄 → 更新次數
-- 次數達 3 → 標記觸發 ✅，繼續進行
-
-### 步驟 3 — 選擇路徑（Simple / Complex / Delta）
-
-回答 4 個判斷問題，決定：Simple、Complex 或 Delta。
-
-### 步驟 4a — Simple：填寫 Skill Brief
-
-使用 `templates/SKILL-BRIEF-TEMPLATE.md`：
-- 觸發情境（什麼時候會用這個？）
-- 核心步驟（3~7 個，有序）
-- 驗收條件（2~3 條）
-- 不涵蓋的部分（明確邊界）
-
-### 步驟 4b — Complex：建立 XSPEC
-
-執行 `/sdd` 建立 XSPEC。XSPEC 核准後回到步驟 5。
-
-### 步驟 4c — Delta：識別變更範圍
-
-識別現有 SKILL.md 中哪些區段需要變更。
-在末尾加入 `## MODIFIED Requirements` 或 `## ADDED Requirements`。
-
-### 步驟 5 — 建立 / 更新 SKILL.md
-
-從 Brief 或 XSPEC 產生 SKILL.md：
-- 驗證 frontmatter：`name`、`scope`、`description`、`allowed-tools`
-- UDS Skill：同時建立 zh-TW 語系版本
-- 專案 Skill：放置於 `{project}/.claude/skills/{name}/SKILL.md`
-
-### 步驟 6 — 更新 SKILL-CANDIDATES.md
-
-標記候選行：觸發 ✅，Skill 欄位填入名稱。
-
-### 步驟 7 — Commit
-
-```
-feat(skills): Add /{skill-name} skill. 新增 /{skill-name} Skill。
-
-{English description, 1-2 lines}
-
-{Chinese description, 1-2 lines}
-
-Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
-```
-
-## 輸出檢查清單
-
-完成所有步驟後，驗證：
-
-- [ ] `SKILL-CANDIDATES.md` 已更新（觸發 ✅，Skill 名稱已填入）
-- [ ] `SKILL.md` 已建立，含完整 frontmatter（`name`/`scope`/`description`/`allowed-tools`）
-- [ ] Simple 路徑：Skill Brief 已被引用或保存
-- [ ] Complex 路徑：XSPEC ID 已在 SKILL.md 標頭注釋中標註
-- [ ] UDS Skill：zh-TW 語系檔案已建立
-- [ ] 廢棄：frontmatter 中含 `status: deprecated`
-- [ ] git commit 已完成
-
-## 參考
-
-- Skill Brief 模板：[templates/SKILL-BRIEF-TEMPLATE.md](../../../../templates/SKILL-BRIEF-TEMPLATE.md)
-- 候選追蹤：[templates/SKILL-CANDIDATES.md](../../../../templates/SKILL-CANDIDATES.md)（複製到你的專案）
-- ADR 標準：[core/adr-standards.md](../../../../core/adr-standards.md)