universal-dev-standards 5.4.0 → 5.6.0

package/bundled/locales/zh-CN/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-CN/skills/process-automation/SKILL.md

@@ -1,143 +0,0 @@
----
-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-CN 语系 |
-
-## 工作流程
-
-### 步骤 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-CN 语系版本
-- 项目 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-CN 语系文件已创建
-- [ ] 废弃：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)

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

@@ -1,195 +0,0 @@
----
-name: ac-coverage-assistant
-source: ../../../../skills/ac-coverage-assistant/SKILL.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-03-26
-status: current
-description: "[UDS] 分析 AC 與測試的追蹤關係及覆蓋率"
----
-
-# AC 覆蓋率助手
-
-> **語言**: [English](../../../../skills/ac-coverage-assistant/SKILL.md) | 繁體中文
-
-分析驗收條件（AC）與測試之間的追蹤關係，並產生覆蓋率報告。
-
-## 與 `/coverage` 的區別
-
-| 面向 | `/coverage` | `/ac-coverage` |
-|------|-------------|----------------|
-| **範圍** | 程式碼層級（行/分支/函式） | 需求層級（AC 對測試） |
-| **輸入** | 原始碼 + 測試執行器 | SPEC 檔案 + 測試標註 |
-| **問題** | 「有多少程式碼被測試？」 | 「哪些 AC 有測試？」 |
-| **輸出** | 覆蓋率百分比 | 追蹤矩陣 + 缺口報告 |
-
-## 工作流程
-
-1. **解析 SPEC** — 從規格檔案中擷取 AC 定義（AC-1、AC-2、...）
-2. **掃描測試** — 使用標準連結慣例搜尋測試檔案中的 `@AC` 和 `@SPEC` 標註
-3. **建立矩陣** — 將每個 AC 對應到其測試參考（檔案、測試名稱、行號）
-4. **分類狀態** — 將每個 AC 標記為 ✅ 已覆蓋、⚠️ 部分覆蓋 或 ❌ 未覆蓋
-5. **計算覆蓋率** — 套用公式：`覆蓋率 % = (已覆蓋 + 部分 × 0.5) / 總計 × 100`
-6. **產生報告** — 輸出標準化 Markdown 報告
-
-## 標註慣例
-
-測試必須使用標準標註來參考其來源 AC：
-
-```typescript
-// TypeScript/JavaScript
-describe('AC-1: 使用有效憑證登入', () => {
-  // @AC AC-1
-  // @SPEC SPEC-001
-  it('成功登入後應重導至儀表板', () => { ... });
-});
-```
-
-```python
-# Python
-class TestAC1_UserLogin:
-    """AC-1: 使用有效憑證登入
-    @AC AC-1
-    @SPEC SPEC-001
-    """
-    def test_redirect_to_dashboard(self): ...
-```
-
-```gherkin
-# BDD Feature
-@SPEC-001 @AC-1
-Scenario: 使用有效憑證登入
-```
-
-## 覆蓋率門檻
-
-| 門檻 | 預設值 | 強制執行 |
-|------|--------|----------|
-| **提交時** | 80% | 功能分支合併必要條件 |
-| **發布時** | 100% | 正式發布必要條件 |
-| **警告** | 60% | 觸發覆蓋率警告 |
-
-門檻可透過 `--threshold` 參數或專案設定進行配置。
-
-## 四層追溯（`--full` 模式）
-
-使用 `--full` 標記將追溯從 2 層（AC→Test）擴展為 4 層。
-
-### 追溯層次
-
-```
-第 0 層：需求 / 使用者故事（REQ）
-    ↓ (定義)
-第 1 層：驗收條件（AC）
-    ↓ (@AC 標註)
-第 2 層：測試案例
-    ↓ (覆蓋)
-第 3 層：原始碼（@implements）
-```
-
-### 各層標註慣例
-
-```typescript
-// 第 3→1 層：程式碼參考 AC
-// @implements AC-1, AC-2
-function authenticate(user: string, pass: string) { ... }
-```
-
-```markdown
-<!-- 第 0→1 層：SPEC 中的需求 -->
-## 需求
-### REQ-1: 使用者驗證
-- AC-1: 給定有效憑證，當登入時，則通過驗證
-- AC-2: 給定無效憑證，當登入時，則拒絕登入
-```
-
-### 完整追溯報告
-
-```markdown
-## 四層追溯矩陣
-
-| 需求 | AC | 測試 | 程式碼 | 狀態 |
-|------|-----|------|--------|------|
-| REQ-1 | AC-1 | auth.test.ts:15 | auth.ts:42 | ✅ 完整 |
-| REQ-1 | AC-2 | auth.test.ts:30 | auth.ts:58 | ✅ 完整 |
-| REQ-2 | AC-3 | — | dashboard.ts:10 | ⚠️ 無測試 |
-| REQ-3 | AC-4 | export.test.ts:5 | — | ⚠️ 無程式碼 |
-
-### 缺口摘要
-- 第 0→1 層：2 個需求缺少 AC
-- 第 1→2 層：1 個 AC 缺少測試
-- 第 2→3 層：0 個測試缺少程式碼對應
-- 第 3→1 層：3 個程式碼檔案缺少 AC 對應
-```
-
-### 反向追溯
-
-使用 `--trace-code <path>` 從程式碼反向追溯到需求。
-
-```bash
-/ac-coverage --trace-code src/auth.ts
-# 輸出：
-# src/auth.ts:42 → @implements AC-1 → REQ-1 (SPEC-AUTH-001)
-# src/auth.ts:58 → @implements AC-2 → REQ-1 (SPEC-AUTH-001)
-```
-
-## 報告格式
-
-產生的報告遵循 `core/acceptance-criteria-traceability.md` 中的標準格式：
-
-```markdown
-# AC 覆蓋率報告
-
-**規格**: SPEC-001 — 功能名稱
-**產生日期**: 2026-03-26
-**覆蓋率**: 75% (6/8 AC)
-
-## 摘要
-
-| 狀態 | 數量 | 百分比 |
-|------|------|--------|
-| ✅ 已覆蓋 | 5 | 62.5% |
-| ⚠️ 部分覆蓋 | 2 | 25.0% |
-| ❌ 未覆蓋 | 1 | 12.5% |
-
-## 追蹤矩陣
-
-| AC-ID | 描述 | 狀態 | 測試參考 |
-|-------|------|------|----------|
-| AC-1 | 使用有效憑證登入 | ✅ | auth.test.ts:15 |
-| AC-2 | 拒絕無效憑證 | ✅ | auth.test.ts:32 |
-| ...   | ...            | ... | ... |
-
-## 缺口
-
-- **AC-8**: 社群登入 — 受 OAuth 沙盒環境限制
-
-## 待辦事項
-
-1. [ ] AC-8: 建立 OAuth 沙盒環境（預計完成：待定）
-```
-
-## 使用方式
-
-- `/ac-coverage` - 分析當前專案的 AC 覆蓋率
-- `/ac-coverage path/to/SPEC.md` - 分析特定規格檔案的 AC 覆蓋率
-- `/ac-coverage --full` - 執行四層完整追溯分析
-- `/ac-coverage --trace-code <path>` - 從程式碼反向追溯到需求
-
-## 下一步引導
-
-`/ac-coverage` 完成後，AI 助手應建議：
-
-> **AC 覆蓋率分析完成。建議下一步：**
-> - 覆蓋率達標 → 執行 `/checkin` 通過品質關卡
-> - 有未覆蓋 AC → 執行 `/derive-tdd` 補齊測試 ⭐ **推薦**
-> - 有部分覆蓋 AC → 檢查缺少的邊界情況
-> - 需要完整追溯 → 執行 `/ac-coverage --full`
-> - 反向追溯 → 執行 `/ac-coverage --trace-code <path>`
-
-## 參考
-
-- 核心規範：[acceptance-criteria-traceability.md](../../../../core/acceptance-criteria-traceability.md)
-- SPEC：[SPEC-AC-COVERAGE.md](../../../../docs/specs/skills/SPEC-AC-COVERAGE.md)
-- 相關：[test-coverage-assistant](../test-coverage-assistant/SKILL.md)（程式碼層級覆蓋率）
-- 相關：[checkin-assistant](../checkin-assistant/SKILL.md)（品質關卡）