universal-dev-standards 4.2.0 → 5.0.0-beta.10

package/bundled/locales/zh-TW/docs/CLI-FLOW.md

@@ -0,0 +1,239 @@
+# CLI 指令流程
+
+> **Language**: [English](../../../docs/CLI-FLOW.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CLI-FLOW.md)
+
+本文件呈現 Universal Development Standards (UDS) CLI 指令的互動流程圖。
+
+## 1. 初始化指令 (`uds init`)
+
+初始化流程用於在從未初始化的專案中設定標準。
+
+```mermaid
+flowchart TD
+    Start([uds init]) --> CheckInit{已初始化?}
+    CheckInit -- 是 --> WarnAndExit([結束])
+    CheckInit -- 否 --> DetectProject[偵測專案技術與 AI 工具]
+    DetectProject --> Step1[Q1: 選擇顯示語言]
+    
+    Step1 --> Step2[Q2: 選擇 AI 工具]
+    Step2 --> CheckAITools{已選擇 AI 工具?}
+    CheckAITools -- 否 --> ExitNoTools([結束])
+    CheckAITools -- 是 --> CheckSkillsSupport{支援 Skills?}
+    
+    %% Skills & Commands Flow
+    CheckSkillsSupport -- 否 --> Step6
+    CheckSkillsSupport -- 是 --> Step4[Q3: Skills 安裝位置]
+    Step4 --> CheckMarketplace{Marketplace?}
+    CheckMarketplace -- 是 --> Step6
+    CheckMarketplace -- 否 --> Step5[Q4: 斜線命令安裝位置]
+    
+    Step5 --> Step6[Q5: 標準安裝範圍]
+    
+    %% Standards Configuration
+    Step6 --> Step7[Q6: 採用等級]
+    Step7 --> Step8[Q7: 標準格式]
+    Step8 --> Step9[Q8: 標準選項]
+    
+    %% Standard Options (Multi-select)
+    Step9 -- 若選 Git 工作流程 --> Q_Git[Git 工作流程策略]
+    Step9 -- 若選合併策略 --> Q_Merge[合併策略]
+    Step9 -- 若選 Commit 語言 --> Q_Commit[Commit 語言]
+    Step9 -- 若選測試層級 --> Q_Test[測試層級]
+    
+    Q_Git --> Step10
+    Q_Merge --> Step10
+    Q_Commit --> Step10
+    Q_Test --> Step10
+    Step9 -- 無 --> Step10
+    
+    %% Extensions
+    Step10[Q9: 語言擴充] --> Step11[Q10: 框架擴充]
+    
+    %% Integration Configuration
+    Step11 --> Step12[Q11: 整合設定]
+    Step12 -- 預設 --> Step13
+    Step12 -- 合併 --> Step13
+    Step12 -- 自訂 --> CustomConfig[選擇類別 / 規則 / 排除]
+    CustomConfig --> Step13
+    
+    Step13[Q12: 內容模式]
+    
+    %% Final
+    Step13 --> DisplaySummary[顯示設定摘要]
+    DisplaySummary --> Confirm{繼續?}
+    Confirm -- 否 --> Cancelled([已取消])
+    Confirm -- 是 --> Install[安裝檔案]
+    Install --> Finish([完成])
+
+    %% Styling
+    style Start fill:#f9f,stroke:#333,stroke-width:2px
+    style Finish fill:#9f9,stroke:#333,stroke-width:2px
+    style Step12 fill:#ff9,stroke:#333,stroke-width:2px
+    style CustomConfig fill:#ff9,stroke:#333,stroke-width:2px,stroke-dasharray: 5 5
+```
+
+## 2. 更新指令 (`uds update`)
+
+更新流程用於保持標準與整合檔案同步。
+
+```mermaid
+flowchart TD
+    Start([uds update]) --> CheckInit{已初始化?}
+    CheckInit -- 否 --> Error([錯誤：未初始化])
+    
+    CheckInit -- 是 --> CheckCLI[檢查 CLI 更新]
+    CheckCLI --> UpdateAvail{CLI 有更新?}
+    UpdateAvail -- 是 --> PromptCLI{先更新 CLI?}
+    PromptCLI -- 是 --> RunNpmUpdate([npm update -g])
+    PromptCLI -- 否 --> CheckStandards
+    UpdateAvail -- 否 --> CheckStandards
+    
+    CheckStandards[檢查標準版本] --> UpdateStandards[更新 .standards/ 檔案]
+    UpdateStandards --> CheckIntegrations[檢查整合檔案]
+    
+    CheckIntegrations --> Regenerate{需要重新產生?}
+    Regenerate -- 是 --> GenIntegrations[重新產生設定檔]
+    Regenerate -- 否 --> SyncRefs
+    
+    GenIntegrations --> SyncRefs[同步參考]
+    
+    SyncRefs --> CheckSkills[檢查 Skills 更新]
+    CheckSkills --> SkillsAvail{Skills 有更新?}
+    SkillsAvail -- 是 --> PromptSkills[提示：更新 Skills?]
+    PromptSkills -- 是 --> InstallSkills[安裝/更新 Skills]
+    PromptSkills -- 否 --> Finish
+    SkillsAvail -- 否 --> Finish
+    
+    InstallSkills --> Finish([完成])
+
+    style Start fill:#f9f,stroke:#333,stroke-width:2px
+    style Finish fill:#9f9,stroke:#333,stroke-width:2px
+```
+
+## 3. 檢查指令 (`uds check`)
+
+檢查流程用於驗證檔案完整性與採用狀態。
+
+```mermaid
+flowchart TD
+    Start([uds check]) --> CheckInit{已初始化?}
+    CheckInit -- 否 --> Error([錯誤：未初始化])
+    
+    CheckInit -- 是 --> VerifyManifest[驗證 Manifest]
+    VerifyManifest --> CheckHash{Hash 檢查}
+    
+    CheckHash -->|相符| Pass([通過])
+    CheckHash -->|不符| DetectChanges[偵測 已修改/遺失]
+    
+    DetectChanges --> Interactive{互動模式?}
+    Interactive -- 否 --> Report[報告問題]
+    Report --> Fail([結束並顯示問題])
+    
+    Interactive -- 是 --> LoopFiles[迴圈處理每個檔案]
+    LoopFiles --> PromptAction[提示：動作?]
+    
+    PromptAction -- 檢視 --> ShowDiff[顯示差異]
+    ShowDiff --> PromptAction
+    
+    PromptAction -- 還原 --> RestoreFile[還原原始檔]
+    PromptAction -- 保留 --> UpdateHash[更新 Hash (接受變更)]
+    PromptAction -- 跳過 --> SkipFile[跳過]
+    
+    RestoreFile --> NextFile{還有檔案?}
+    UpdateHash --> NextFile
+    SkipFile --> NextFile
+    
+    NextFile -- 是 --> LoopFiles
+    NextFile -- 否 --> Finish([完成])
+
+    style Start fill:#f9f,stroke:#333,stroke-width:2px
+    style Finish fill:#9f9,stroke:#333,stroke-width:2px
+    style Fail fill:#f99,stroke:#333,stroke-width:2px
+```
+
+## 4. 設定指令 (`uds configure`)
+
+設定流程允許修改現有的設定。
+
+```mermaid
+flowchart TD
+    Start([uds configure]) --> CheckInit{已初始化?}
+    CheckInit -- 否 --> Error([錯誤：未初始化])
+    
+    CheckInit -- 是 --> SelectCategory[選擇設定類別]
+    
+    SelectCategory -- AI 工具 --> ConfigTools[新增/移除 AI 工具]
+    SelectCategory -- 等級 --> ConfigLevel[變更採用等級]
+    SelectCategory -- 格式 --> ConfigFormat[變更格式]
+    SelectCategory -- 內容模式 --> ConfigMode[變更內容模式]
+    SelectCategory -- 方法論 --> ConfigMethod[變更方法論]
+    
+    ConfigTools --> UpdateManifest[更新 Manifest]
+    ConfigLevel --> AddStandards[複製新標準]
+    ConfigFormat --> UpdateManifest
+    ConfigMode --> UpdateManifest
+    ConfigMethod --> UpdateManifest
+    
+    AddStandards --> UpdateManifest
+    
+    UpdateManifest --> Regenerate{重新產生整合檔?}
+    Regenerate -- 是 --> GenFiles[重新產生設定檔]
+    Regenerate -- 否 --> Finish
+    
+    GenFiles --> Finish([完成])
+
+    style Start fill:#f9f,stroke:#333,stroke-width:2px
+    style Finish fill:#9f9,stroke:#333,stroke-width:2px
+```
+
+## 5. 未來架構 (SPEC-009)
+
+提議簡化流程，以規則選擇取代採用等級。
+
+```mermaid
+flowchart TD
+    Start([uds init]) --> DetectProject[偵測專案技術與 AI 工具]
+    DetectProject --> Step1[Q1: 選擇顯示語言]
+
+    Step1 --> Step2[Q2: 選擇 AI 工具]
+    Step2 --> CheckAITools{已選擇 AI 工具?}
+    CheckAITools -- 否 --> ExitNoTools([結束])
+    CheckAITools -- 是 --> CheckSkillsSupport{支援 Skills?}
+
+    %% Skills & Commands Flow (不變)
+    CheckSkillsSupport -- 否 --> Step6
+    CheckSkillsSupport -- 是 --> Step4[Q3: Skills 安裝位置]
+    Step4 --> CheckMarketplace{Marketplace?}
+    CheckMarketplace -- 是 --> Step6
+    CheckMarketplace -- 否 --> Step5[Q4: 斜線命令安裝位置]
+
+    %% 新核心：規則選擇（取代等級）
+    Step5 --> Step6[Q5: 選擇標準規則]
+    Step6 --> RuleConfig{檢查已選規則}
+
+    %% 動態規則設定
+    RuleConfig -- 已選 Git 工作流程 --> Q_Git[Q6a: Git 策略]
+    RuleConfig -- 已選測試 --> Q_Test[Q6b: 測試層級]
+    RuleConfig -- 已選 Commit 訊息 --> Q_Commit[Q6c: Commit 語言]
+    RuleConfig -- 其他 --> Q_Scope
+
+    Q_Git --> Q_Scope
+    Q_Test --> Q_Scope
+    Q_Commit --> Q_Scope
+
+    %% 簡化的產生流程
+    Q_Scope[Q7: 標準範圍] --> DisplaySummary
+
+    %% 隱式決策（對使用者隱藏）
+    DisplaySummary --> ImplicitConfig[[隱式：內容模式 = 標準]]
+    ImplicitConfig --> ImplicitInteg[[隱式：整合 = 預設]]
+
+    ImplicitInteg --> Confirm{繼續?}
+    Confirm -- 是 --> Install[安裝檔案並產生設定]
+    Install --> Finish([完成])
+
+    %% Styling
+    style Step6 fill:#f96,stroke:#333,stroke-width:2px
+    style ImplicitConfig fill:#ddd,stroke:#999,stroke-dasharray: 5 5
+    style ImplicitInteg fill:#ddd,stroke:#999,stroke-dasharray: 5 5
+```

package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md

@@ -0,0 +1,320 @@
+# UDS 功能參考手冊
+
+> Universal Development Standards - 完整功能文件
+> Auto-generated | Last updated: 2026-02-10
+
+**Language**: [English](../../../docs/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
+
+---
+
+## 目錄
+
+1. [CLI 指令](#cli-commands) (9)
+2. [斜線命令](#slash-commands) (30)
+3. [技能](#skills) (26)
+4. [代理](#agents) (5)
+5. [工作流程](#workflows) (5)
+6. [核心規範](#core-standards) (32)
+7. [腳本](#scripts) (31)
+
+**Total Features: 138**
+
+---
+
+## CLI 指令
+
+### `uds list`
+
+**說明**: List available standards
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `-l, --level` | Filter by adoption level (1, 2, or 3) |
+| `-c, --category` | Filter by category (skill, reference, extension, integration, template) |
+
+### `uds init`
+
+**說明**: Initialize standards in current project
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `-m, --mode` | Installation mode (skills, full) |
+| `-l, --level` | Adoption level (1=Essential, 2=Recommended, 3=Enterprise) |
+| `-f, --format` | Standards format (ai, human, both) |
+| `--workflow` | Git workflow (github-flow, gitflow, trunk-based) |
+| `--merge-strategy` | Merge strategy (squash, merge-commit, rebase-ff) |
+| `--commit-lang` | Commit message language (english, traditional-chinese, bilingual) |
+| `--test-levels` | Test levels, comma-separated (unit-testing,integration-testing,...) |
+| `--lang` | Language extension (csharp, php) |
+| `--framework` | Framework extension (fat-free) |
+| `--locale` | Locale extension (zh-tw) |
+| `--skills-location` | Skills location (marketplace, user, project, none) [default: marketplace] |
+| `--content-mode` | Content mode for integration files (minimal, index, full) [default: index] |
+| `-y, --yes` | Use defaults, skip interactive prompts |
+| `-E, --experimental` | Enable experimental features (methodology) |
+
+### `uds configure`
+
+**說明**: Modify options for initialized project
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `-t, --type` | Option type to configure (format, workflow, merge_strategy, commit_language, test_levels, skills, commands, all) |
+| `--ai-tool` | Specific AI tool to configure (claude-code, opencode, copilot, etc.) |
+| `--skills-location` | Skills installation location (project, user) |
+| `-y, --yes` | Apply changes immediately without prompting |
+| `-E, --experimental` | Enable experimental features (methodology) |
+
+### `uds check`
+
+**說明**: Check adoption status of current project
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `-s, --standard` | Validate against a specific standard physical spec |
+| `--json` | Output result in JSON format |
+| `--summary` | Show compact status summary (for use by other commands) |
+| `--diff` | Show diff for modified files |
+| `--restore` | Restore all modified and missing files |
+| `--restore-missing` | Restore only missing files |
+| `--no-interactive` | Disable interactive mode |
+| `--migrate` | Migrate legacy manifest to hash-based tracking |
+| `--offline` | Skip npm registry check for CLI updates |
+
+### `uds update`
+
+**說明**: Update standards to latest version
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `-y, --yes` | Skip confirmation prompts |
+| `--sync-refs` | Sync integration file references with manifest standards |
+| `--integrations-only` | Only regenerate integration files (CLAUDE.md, etc.) |
+| `--standards-only` | Only update standards, skip integration files |
+| `--offline` | Skip npm registry check for CLI updates |
+| `--beta` | Check for beta version updates |
+| `--skills` | Install/update Skills for configured AI tools |
+| `--commands` | Install/update slash commands for configured AI tools |
+| `--debug` | Show debug output for Skills/Commands detection |
+
+### `uds skills`
+
+**說明**: List installed Claude Code skills
+
+### `uds agent`
+
+**說明**: Manage UDS agents (list, install, info)
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `--installed` | Show installation status for all AI tools |
+| `-t, --tool` | Target AI tool (default: claude-code) |
+| `-g, --global` | Install to user level instead of project level |
+| `-y, --yes` | Skip confirmation prompts |
+
+### `uds workflow`
+
+**說明**: Manage UDS workflows (list, install, info, execute, status)
+
+**選項**:
+| Option | 說明 |
+|--------|-------------|
+| `--installed` | Show installation status for all AI tools |
+| `-t, --tool` | Target AI tool (default: claude-code) |
+| `-g, --global` | Install to user level instead of project level |
+| `-y, --yes` | Skip confirmation prompts |
+| `-t, --tool` | Target AI tool (default: claude-code) |
+| `--resume` | Resume from saved state |
+| `--restart` | Restart from beginning (discard saved state) |
+| `-v, --verbose` | Show detailed output |
+| `--dry-run` | Show steps without executing |
+| `-y, --yes` | Skip confirmation prompts |
+
+### `uds ai-context`
+
+**說明**: Manage AI context configuration (init, validate, graph)
+
+---
+
+## 斜線命令
+
+| Command | 說明 |
+|---------|-------------|
+| `/atdd` | [UDS] Guide through Acceptance Test-Driven Development workflow |
+| `/bdd` | [UDS] Guide through Behavior-Driven Development workflow |
+| `/changelog` | "[UDS] Generate and maintain CHANGELOG.md entries" |
+| `/check` | [UDS] Verify standards adoption status |
+| `/checkin` | "[UDS] Pre-commit quality gates verification" |
+| `/commit` | [UDS] Generate commit messages following Conventional Commits standard |
+| `/config` | [UDS] Configure project development standards |
+| `/coverage` | [UDS] Analyze test coverage and provide recommendations |
+| `/derive-all` | [UDS] Derive all test structures (BDD, TDD, ATDD) from SDD specification |
+| `/derive-atdd` | [UDS] Derive ATDD acceptance tests from SDD specification |
+| `/derive-bdd` | [UDS] Derive BDD Gherkin scenarios from SDD specification |
+| `/derive-tdd` | [UDS] Derive TDD test skeletons from SDD specification |
+| `/derive` | [UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications. |
+| `/discover` | "[UDS] Assess project health, architecture, and risks before adding features" |
+| `/docgen` | "[UDS] Generate usage documentation from project sources" |
+| `/docs` | [UDS] Manage, guide, and generate documentation. |
+| `/guide` | [UDS] Access Universal Development Standards guides and references. |
+| `/init` | [UDS] Initialize development standards in current project |
+| `/methodology` | [UDS] Manage development methodology workflow |
+| `/refactor` | [UDS] Guide refactoring decisions and strategy selection |
+| `/release` | [UDS] Manage release process and changelogs. |
+| `/requirement` | [UDS] Write user stories and requirements following INVEST criteria |
+| `/reverse-bdd` | [UDS] Transform SDD acceptance criteria to BDD scenarios |
+| `/reverse-sdd` | [UDS] Reverse engineer code into SDD specification document |
+| `/reverse-tdd` | [UDS] Analyze BDD-TDD coverage gaps |
+| `/reverse` | [UDS] Reverse engineer code to Specs, BDD, or TDD coverage. |
+| `/review` | [UDS] Perform systematic code review with checklist |
+| `/sdd` | [UDS] Create or review specification documents for Spec-Driven Development |
+| `/tdd` | [UDS] Guide through Test-Driven Development workflow |
+| `/update` | [UDS] Update development standards to latest version |
+
+---
+
+## 技能
+
+| Skill | 說明 |
+|-------|-------------|
+| `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. |
+| `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, layered documentation, and semantic boundaries. |
+| `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, .cursorrules, etc.) with proper structure. |
+| `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development workflow" |
+| `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
+| `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
+| `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
+| `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
+| `commit-standards` | "[UDS] Generate commit messages following Conventional Commits standard" |
+| `docs-generator` | "[UDS] Generate usage documentation from project sources" |
+| `documentation-guide` | Guide documentation structure, content requirements, and project documentation best practices. |
+| `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. |
+| `forward-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications" |
+| `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge operations. |
+| `logging-guide` | Implement structured logging with proper log levels and sensitive data handling. |
+| `methodology-system` | "[UDS] Manage development methodology workflow" |
+| `project-discovery` | "[UDS] Assess project health, architecture, and risks before adding features" |
+| `project-structure-guide` | Guide for organizing project directories following language-specific best practices. |
+| `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
+| `release-standards` | "[UDS] Guide release process and changelogs" |
+| `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST criteria" |
+| `reverse-engineer` | "[UDS] Reverse engineer code to Specs, BDD, or TDD coverage" |
+| `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Driven Development" |
+| `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
+| `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
+| `testing-guide` | Testing pyramid and test writing standards for UT/IT/ST/E2E. |
+
+---
+
+## 代理
+
+| Agent | 角色 | 說明 |
+|-------|------|-------------|
+| `code-architect` | specialist | Software architecture specialist for system design and technical planning. |
+| `doc-writer` | specialist | Documentation specialist for technical writing, API docs, and user guides. |
+| `reviewer` | reviewer | Code review specialist for quality assessment, security analysis, and best practices enforcement. |
+| `spec-analyst` | specialist | Specification analysis specialist for requirement extraction and spec generation. |
+| `test-specialist` | specialist | Testing strategy specialist for test design, coverage analysis, and quality assurance. |
+
+---
+
+## 工作流程
+
+| Workflow | 說明 |
+|----------|-------------|
+| `code-review` | Comprehensive code review workflow for PRs and code changes. |
+| `feature-dev` | Standard feature development workflow from requirements to deployment. |
+| `integrated-flow` | Complete development workflow integrating ATDD, SDD, BDD, and TDD methodologies. |
+| `large-codebase-analysis` | RLM-enhanced workflow for analyzing large codebases with 50+ files. |
+| `release` | Complete release workflow for software projects. |
+
+---
+
+## 核心規範
+
+| Standard | 版本 | 說明 |
+|----------|---------|-------------|
+| `acceptance-test-driven-development` | 1.1.0 |  |
+| `accessibility-standards` | 1.0.0 | This standard defines comprehensive guidelines for creating accessible software  |
+| `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
+| `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
+| `ai-instruction-standards` | 1.0.0 | This standard defines best practices for creating and maintaining AI instruction |
+| `anti-hallucination` | 1.5.0 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
+| `behavior-driven-development` | 1.1.0 |  |
+| `changelog-standards` | 1.0.2 | This standard defines how to write and maintain a CHANGELOG.md file to communica |
+| `checkin-standards` | 1.4.0 | This standard defines quality gates that MUST be passed before committing code t |
+| `code-review-checklist` | 1.3.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
+| `commit-message-guide` | 1.2.3 | Standardized commit messages improve code review efficiency, facilitate automate |
+| `deployment-standards` | 1.0.0 | This standard defines guidelines for safely deploying software to production, co |
+| `developer-memory` | 1.0.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
+| `documentation-structure` | 1.3.0 | This standard defines a consistent documentation structure for software projects |
+| `documentation-writing-standards` | 1.1.0 | This standard defines documentation requirements based on project types and prov |
+| `error-code-standards` | 1.1.0 |  |
+| `forward-derivation-standards` | 1.1.0 | This standard defines the principles and workflows for Forward Derivation—automa |
+| `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
+| `logging-standards` | 1.2.0 |  |
+| `performance-standards` | 1.1.0 | This standard defines comprehensive guidelines for software performance engineer |
+| `project-context-memory` | 1.0.0 | This standard defines a structured system for capturing, retrieving, and enforci |
+| `project-structure` | 1.1.0 | This standard defines conventions for project directory structure beyond documen |
+| `refactoring-standards` | 2.1.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
+| `requirement-engineering` | 1.0.0 |  |
+| `reverse-engineering-standards` | 1.0.0 | This standard defines the principles, workflows, and best practices for reverse  |
+| `security-standards` | 1.1.0 | This standard defines comprehensive security guidelines for software development |
+| `spec-driven-development` | 2.1.0 |  |
+| `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
+| `test-driven-development` | 1.2.0 |  |
+| `testing-standards` | 3.0.0 | This standard defines actionable testing rules and conventions for AI agents and |
+| `versioning` | 1.2.0 | This standard defines how to version software releases using Semantic Versioning |
+| `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
+
+---
+
+## 腳本
+
+| Script | 說明 |
+|--------|-------------|
+| `add-industry-standards-metadata.mjs` | Add industry standards metadata to core/ |
+| `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
+| `check-ai-agent-sync.sh` | AI Agent Sync Checker |
+| `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
+| `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
+| `check-commands-sync.ps1` | Check Commands Sync |
+| `check-commands-sync.sh` | Commands Sync Checker |
+| `check-docs-sync.ps1` | Check Docs Sync |
+| `check-docs-sync.sh` | Documentation Sync Checker |
+| `check-scope-sync.ps1` | Check Scope Sync |
+| `check-scope-sync.sh` | Scope Consistency Check Script |
+| `check-spec-sync.ps1` | Core↔Skill Sync Check Script |
+| `check-spec-sync.sh` | Core↔Skill Sync Check Script |
+| `check-standards-reference-sync.ps1` | Check Standards Reference Sync |
+| `check-standards-reference-sync.sh` | check-standards-reference-sync.sh |
+| `check-standards-sync.ps1` | Check Standards Sync |
+| `check-standards-sync.sh` | Standards Consistency Checker |
+| `check-translation-sync.ps1` | Check Translation Sync |
+| `check-translation-sync.sh` | Translation Sync Checker |
+| `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerated |
+| `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
+| `check-version-sync.ps1` | Check Version Sync |
+| `check-version-sync.sh` | Version Sync Checker |
+| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
+| `fix-manifest-paths.ps1` | Fix Manifest Paths |
+| `fix-manifest-paths.sh` | Manifest Path Fixer |
+| `pre-release-check.ps1` | Pre Release Check |
+| `pre-release-check.sh` | Pre-release Check Script |
+| `pre-release.ps1` | Pre-Release Preparation Script for Universal Development Standards |
+| `pre-release.sh` | Pre-Release Preparation Script |
+| `setup-husky.mjs` | Cross-platform Husky Setup Script |
+
+---
+
+## License
+
+This documentation 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/docs/MIGRATION-V5.md

@@ -0,0 +1,71 @@
+# 遷移指南：Universal Dev Standards V5
+
+> **語言**: English | [繁體中文](MIGRATION-V5.md)
+
+**版本**: 5.0.0
+**狀態**: 重大變更（Token 使用量最佳化）
+
+## 概覽
+
+Universal Development Standards V5 引入了重大的架構變更，旨在**減少 AI Token 消耗量高達 75%**。我們將「可執行的規則」與「教育性內容」進行了分離。
+
+## 主要變更
+
+### 1. 規則 (Rules) 與指南 (Guides) 分離
+
+在 V4 中，許多標準檔案體積龐大（例如 `testing-standards.md` 高達 141KB）。在 V5 中，這些檔案已被拆分：
+
+| 組件 | 位置 | 目的 | AI 行為 |
+|------|------|------|---------|
+| **規則 (Rules)** | `core/*.md` | 可執行的規則、檢查清單、閾值 | **務必讀取** |
+| **指南 (Guides)** | `core/guides/*.md` | 詳細解釋、教學、範例 | **僅在需要時讀取** |
+| **方法論** | `methodologies/guides/*.md` | 完整的方法論指南 (TDD, BDD 等) | **僅在需要時讀取** |
+
+### 2. 檔案位置移動
+
+以下方法論檔案已從 `core/` 移至 `methodologies/guides/`：
+- `test-driven-development.md`
+- `acceptance-test-driven-development.md`
+- `spec-driven-development.md`
+- `behavior-driven-development.md`
+- `requirement-engineering.md`
+
+### 3. AI 代理指令
+
+新的 AI 工具設定（`.cursorrules`、`CLAUDE.md` 等）現在包含 **核心標準使用規則 (Core Standards Usage Rule)**，指示 AI 代理優先讀取 `core/` 中的輕量化規則以節省 Token。
+
+## 如何升級
+
+### 現有專案
+
+如果您已在專案中初始化了 UDS，請按照以下步驟操作以獲取 Token 最佳化效益：
+
+1. **更新 CLI**：
+   ```bash
+   npm install -g universal-dev-standards@alpha
+   ```
+
+2. **同步參考 (Sync References)**：
+   執行更新指令以獲取新的輕量化規則檔案與指南：
+   ```bash
+   uds update --sync-refs
+   ```
+
+3. **更新 AI 規則**：
+   重新生成或更新您的 AI 工具設定檔（例如 `.cursorrules`），以包含新的使用指令：
+   ```bash
+   uds configure
+   # 選擇您的 AI 工具並選擇 "Update"
+   ```
+
+### 向後相容性
+
+我們在原始的 `core/` 位置留下了 **Stub 檔案 (轉址檔案)**。這些是小型檔案（約 1KB），提供摘要以及指向新完整指南的連結。這確保了您文件中任何現有的硬編碼連結或參考不會失效。
+
+## 常見問題 (FAQ)
+
+### 為什麼要這樣做？
+現代 AI 模型具有上下文視窗 (Context Window) 限制以及 Token 成本。大型文件會降低 AI 效能並增加延遲。V5 使「常駐」上下文變得更小，同時保持完整知識庫可用。
+
+### 我需要修改程式碼嗎？
+不需要。此變更僅影響文件結構和 AI 代理的行為。