universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-TW/ai/options/changelog/auto-generated.ai.yaml

@@ -0,0 +1,76 @@
+# 自動產生變更日誌 - AI 優化選項
+# 父項: changelog
+
+id: auto-generated
+meta:
+  parent: changelog
+  version: "1.0.0"
+  description: 從提交歷史產生變更日誌
+  language: zh-TW
+
+best_for:
+  - 使用約定式提交的專案
+  - CI/CD 自動化發布
+  - 頻繁發布週期
+  - 偏好自動化而非手動編輯的團隊
+
+tools:
+  - name: conventional-changelog
+    platform: Node.js
+    command: npx conventional-changelog -p angular -i CHANGELOG.md -s
+    config: .changelogrc
+
+  - name: semantic-release
+    platform: Node.js
+    command: npx semantic-release
+    config: .releaserc
+
+  - name: git-cliff
+    platform: Rust
+    command: git cliff -o CHANGELOG.md
+    config: cliff.toml
+
+  - name: release-please
+    platform: GitHub Action
+    description: Google 的發布自動化工具
+
+prerequisites:
+  - 約定式提交格式
+  - 一致的提交訊息結構
+  - CI/CD 管線整合
+
+commit_to_changelog_mapping:
+  columns: [提交類型, 變更日誌區段]
+  rows:
+    - [feat, 新增]
+    - [fix, 修復]
+    - [perf, 變更]
+    - [refactor, 變更]
+    - [docs, 文件]
+    - [chore, 維護]
+    - ["BREAKING CHANGE", 重大變更]
+
+rules:
+  - id: conventional-commits
+    trigger: 撰寫提交訊息時
+    instruction: 使用約定式提交格式以正確產生變更日誌
+    priority: required
+
+  - id: scope-for-grouping
+    trigger: 撰寫提交訊息時
+    instruction: 使用範圍來分組相關變更
+    priority: recommended
+
+  - id: breaking-change-footer
+    trigger: 引入重大變更時
+    instruction: 在提交主體中新增 "BREAKING CHANGE:" 頁腳
+    priority: required
+
+comparison_with_manual:
+  columns: [面向, 自動產生, 手動 (Keep a Changelog)]
+  rows:
+    - [工作量, 低（自動化）, 高（手動撰寫）]
+    - [一致性, 高（範本式）, 視情況（人工撰寫）]
+    - [詳細程度, 提交級別, 功能級別（策劃過的）]
+    - [前提條件, 約定式提交, 無]
+    - [適用場景, 頻繁發布, 里程碑發布]

package/bundled/locales/zh-TW/ai/options/changelog/keep-a-changelog.ai.yaml

@@ -0,0 +1,99 @@
+# Keep a Changelog 格式 - AI 優化選項
+# 父項: changelog
+# 參考: https://keepachangelog.com/
+
+id: keep-a-changelog
+meta:
+  parent: changelog
+  version: "1.0.0"
+  description: 標準 Keep a Changelog 格式
+  source: "https://keepachangelog.com/zh-TW/1.0.0/"
+  language: zh-TW
+
+best_for:
+  - 開源專案
+  - 需要人類可讀的變更日誌的專案
+  - 遵循語意化版本的專案
+  - 手動發布管理
+
+format:
+  filename: CHANGELOG.md
+  structure: |
+    # 變更日誌
+
+    此專案的所有重要變更都將記錄在此檔案中。
+
+    格式基於 [Keep a Changelog](https://keepachangelog.com/zh-TW/1.0.0/)，
+    且此專案遵循 [語意化版本](https://semver.org/lang/zh-TW/)。
+
+    ## [未發布]
+
+    ## [X.Y.Z] - YYYY-MM-DD
+
+change_types:
+  - name: 新增
+    english: Added
+    order: 1
+    description: 新功能
+  - name: 變更
+    english: Changed
+    order: 2
+    description: 現有功能的變更
+  - name: 棄用
+    english: Deprecated
+    order: 3
+    description: 即將移除的功能
+  - name: 移除
+    english: Removed
+    order: 4
+    description: 已移除的功能
+  - name: 修復
+    english: Fixed
+    order: 5
+    description: 錯誤修復
+  - name: 安全性
+    english: Security
+    order: 6
+    description: 安全漏洞修復
+
+rules:
+  - id: use-unreleased
+    trigger: 開發期間進行變更時
+    instruction: 將條目新增到 [未發布] 區段
+    priority: required
+
+  - id: move-on-release
+    trigger: 發布新版本時
+    instruction: 將 [未發布] 條目移至帶有日期的版本區段
+    priority: required
+
+  - id: reverse-chronological
+    trigger: 排序條目時
+    instruction: 最新版本在最上方
+    priority: required
+
+  - id: link-versions
+    trigger: 新增版本時
+    instruction: 在檔案底部新增差異比較連結
+    priority: recommended
+
+  - id: iso-date
+    trigger: 標註發布日期時
+    instruction: 使用 YYYY-MM-DD 格式
+    priority: required
+
+example: |
+  ## [1.2.0] - 2025-01-15
+
+  ### 新增
+  - 支援 OAuth2 的使用者驗證 (#123)
+  - 深色模式主題選項 (#145)
+
+  ### 變更
+  - 更新 API 回應格式以保持一致性
+
+  ### 修復
+  - 修復網路緩慢時的登入逾時問題 (#156)
+
+  [未發布]: https://github.com/user/repo/compare/v1.2.0...HEAD
+  [1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0

package/bundled/locales/zh-TW/ai/options/code-review/automated-review.ai.yaml

@@ -0,0 +1,120 @@
+# 自動化程式碼審查 - AI 優化選項
+# 父項: code-review
+
+id: automated-review
+meta:
+  parent: code-review
+  version: "1.0.0"
+  description: 自動化程式碼分析和審查工具
+  language: zh-TW
+
+best_for:
+  - 及早發現常見問題
+  - 強制執行程式碼標準
+  - 減輕審查者負擔
+  - CI/CD 整合
+  - 大型程式碼庫
+
+tool_categories:
+  static_analysis:
+    name: 靜態分析
+    description: 不執行程式碼進行分析
+    tools:
+      - name: ESLint
+        languages: [JavaScript, TypeScript]
+        focus: 程式碼品質、風格
+      - name: Pylint
+        languages: [Python]
+        focus: 程式碼品質、錯誤
+      - name: SonarQube
+        languages: [多語言]
+        focus: 程式碼品質、安全性
+
+  security_scanning:
+    name: 安全掃描
+    description: 尋找安全漏洞
+    tools:
+      - name: Snyk
+        focus: 相依性漏洞
+      - name: CodeQL
+        focus: 語意程式碼分析
+      - name: Semgrep
+        focus: 自訂安全規則
+
+  formatting:
+    name: 格式化
+    description: 程式碼風格強制
+    tools:
+      - name: Prettier
+        languages: [JavaScript, TypeScript, CSS, HTML]
+      - name: Black
+        languages: [Python]
+      - name: gofmt
+        languages: [Go]
+
+  type_checking:
+    name: 型別檢查
+    description: 型別安全驗證
+    tools:
+      - name: TypeScript
+        languages: [TypeScript, JavaScript]
+      - name: mypy
+        languages: [Python]
+
+  ai_review:
+    name: AI 審查
+    description: AI 驅動的程式碼審查
+    tools:
+      - name: GitHub Copilot
+        description: AI 建議和審查
+      - name: CodeRabbit
+        description: AI PR 審查評論
+
+rules:
+  - id: fail-on-errors
+    trigger: 自動檢查失敗時
+    instruction: 在修復關鍵問題前阻止合併
+    priority: required
+
+  - id: warnings-as-suggestions
+    trigger: 自動檢查警告時
+    instruction: 將警告視為非阻擋性建議
+    priority: recommended
+
+  - id: config-in-repo
+    trigger: 設定自動化時
+    instruction: 將工具設定存放在儲存庫中
+    priority: required
+
+  - id: pre-commit-hooks
+    trigger: 提交程式碼時
+    instruction: 在提交前執行格式化和 linter
+    priority: recommended
+
+recommended_setup:
+  minimum:
+    - 主要語言的 Linter
+    - 格式化工具（啟用自動修復）
+    - 相依性漏洞掃描器
+
+  recommended:
+    - 所有最小工具
+    - 型別檢查器（如適用）
+    - 安全掃描器
+    - 程式碼覆蓋率檢查
+
+  comprehensive:
+    - 所有推薦工具
+    - AI 程式碼審查
+    - 專案自訂規則
+    - 指標追蹤
+
+comparison_with_manual:
+  columns: [面向, 自動化, 人工審查]
+  rows:
+    - [速度, 即時, 數小時/數天]
+    - [一致性, 100%, 視情況]
+    - [情境理解, 有限, 高]
+    - [商業邏輯, 無法檢查, 可驗證]
+    - [風格強制, 優秀, 不一致]
+    - [基本安全, 良好, 可能遺漏]

package/bundled/locales/zh-TW/ai/options/code-review/pair-programming.ai.yaml

@@ -0,0 +1,109 @@
+# 結對程式設計審查 - AI 優化選項
+# 父項: code-review
+
+id: pair-programming
+meta:
+  parent: code-review
+  version: "1.0.0"
+  description: 即時協作程式碼審查
+  language: zh-TW
+
+best_for:
+  - 複雜功能
+  - 知識傳承
+  - 新成員入職
+  - 關鍵程式碼路徑
+  - 同地辦公團隊
+
+roles:
+  driver:
+    name: 駕駛者
+    description: 撰寫程式碼
+    responsibilities:
+      - 實作解決方案
+      - 解釋思考過程
+      - 接受導航者的建議
+
+  navigator:
+    name: 導航者
+    description: 審查和引導
+    responsibilities:
+      - 即時審查程式碼
+      - 思考整體架構
+      - 建議改進
+      - 及早發現錯誤
+
+patterns:
+  - name: 乒乓模式
+    description: 每個測試後交換角色
+    best_for: TDD 工作流程
+    workflow:
+      - 駕駛者撰寫失敗的測試
+      - 交換角色
+      - 新駕駛者讓測試通過
+      - 交換並重複
+
+  - name: 強風格模式
+    description: 導航者必須口頭表達所有想法
+    rule: "想法要從你的腦中到電腦，必須經過別人的手"
+    best_for: 知識傳承
+
+  - name: 駕駛-導航模式
+    description: 傳統結對
+    workflow:
+      - 駕駛者專注於戰術性編碼
+      - 導航者進行策略性思考
+      - 每 25-30 分鐘交換
+
+session_guidelines:
+  preparation:
+    - 定義會議目標
+    - 設定共享環境
+    - 同意結對模式
+
+  during_session:
+    - 每 45-60 分鐘休息
+    - 定期交換角色
+    - 持續溝通
+
+  after_session:
+    - 簡短回顧
+    - 記錄做出的決定
+    - 提交程式碼
+
+tools:
+  remote_pairing:
+    - VS Code Live Share
+    - JetBrains Code With Me
+    - Tuple
+    - 螢幕分享（備用）
+
+  local_pairing:
+    - 單台電腦，兩個鍵盤
+    - 投影機/大螢幕
+
+rules:
+  - id: regular-switching
+    trigger: 結對會議時
+    instruction: 每 25-30 分鐘交換角色
+    priority: required
+
+  - id: verbal-communication
+    trigger: 導航時
+    instruction: 在建議變更前解釋理由
+    priority: required
+
+  - id: respect-driver
+    trigger: 導航時
+    instruction: 不要搶鍵盤；用口頭引導
+    priority: required
+
+comparison_with_pr:
+  columns: [面向, 結對程式設計, PR 審查]
+  rows:
+    - [時機, 即時, 非同步]
+    - [回饋, 立即, 延遲]
+    - [知識分享, 高, 中]
+    - [文件記錄, 較低, 較高（PR 評論）]
+    - [擴展性, 有限, 高]
+    - [遠端友善, 挑戰性, 容易]

package/bundled/locales/zh-TW/ai/options/code-review/pr-review.ai.yaml

@@ -0,0 +1,104 @@
+# Pull Request 審查 - AI 優化選項
+# 父項: code-review
+
+id: pr-review
+meta:
+  parent: code-review
+  version: "1.0.0"
+  description: 傳統的 Pull Request 程式碼審查流程
+  language: zh-TW
+
+best_for:
+  - 分散式團隊
+  - 非同步工作流程
+  - 需要審計紀錄
+  - 開源專案
+
+workflow:
+  steps:
+    - name: 建立 PR
+      actor: 作者
+      actions:
+        - 撰寫清楚的描述
+        - 連結相關 issue
+        - 請求審查者
+
+    - name: 審查
+      actor: 審查者
+      actions:
+        - 檢查功能性
+        - 審查程式碼品質
+        - 驗證安全性
+        - 如有需要在本地執行測試
+
+    - name: 回應
+      actor: 作者
+      actions:
+        - 處理回饋
+        - 推送修復
+        - 請求重新審查
+
+    - name: 核准與合併
+      actor: 審查者
+      actions:
+        - 最終核准
+        - 合併或等待 CI
+
+review_checklist:
+  functionality:
+    - 程式碼是否正確運作？
+    - 是否處理邊界情況？
+    - 錯誤處理是否適當？
+
+  code_quality:
+    - 程式碼是否可讀？
+    - 函式是否專注（單一職責）？
+    - 是否有重複的程式碼？
+
+  security:
+    - 是否有注入漏洞？
+    - 是否驗證輸入？
+    - 是否暴露憑證？
+
+  testing:
+    - 是否有足夠的測試？
+    - 測試是否涵蓋邊界情況？
+
+comment_conventions:
+  prefixes:
+    - prefix: "[必要]"
+      meaning: 合併前必須修復
+      blocking: true
+    - prefix: "[建議]"
+      meaning: 考慮修改
+      blocking: false
+    - prefix: "[問題]"
+      meaning: 需要釐清
+      blocking: false
+    - prefix: "[小問題]"
+      meaning: 次要風格問題
+      blocking: false
+    - prefix: "[讚]"
+      meaning: 做得好
+      blocking: false
+
+rules:
+  - id: timely-review
+    trigger: PR 被指派時
+    instruction: 在 24 小時內完成審查
+    priority: recommended
+
+  - id: constructive-feedback
+    trigger: 撰寫評論時
+    instruction: 解釋為什麼，而不只是什麼
+    priority: required
+
+  - id: test-before-approve
+    trigger: 核准 PR 時
+    instruction: 確保所有測試通過
+    priority: required
+
+  - id: minimum-reviewers
+    trigger: 合併 PR 時
+    instruction: 至少需要一個核准
+    priority: required

package/bundled/locales/zh-TW/ai/options/commit-message/bilingual.ai.yaml

@@ -0,0 +1,105 @@
+# 雙語提交格式 - AI 優化選項
+# 父項: commit-message
+
+id: bilingual
+meta:
+  parent: commit-message
+  version: "1.0.0"
+  description: 混合團隊的雙語格式
+  language: zh-TW
+
+best_for:
+  - 有本地重點的混合團隊
+  - 國際協作專案
+  - 維持工具相容性同時支援中文讀者
+
+format:
+  template: |
+    <type>(<scope>): <English subject>. <Chinese subject>.
+
+    <English body>
+
+    <Chinese body>
+
+    <footer>
+  note: 類型和範圍使用英文以確保工具相容性
+
+types:
+  - type: feat
+    description_en: New feature
+    description_zh: 新功能
+
+  - type: fix
+    description_en: Bug fix
+    description_zh: 錯誤修正
+
+  - type: refactor
+    description_en: Code refactoring
+    description_zh: 程式碼重構
+
+  - type: docs
+    description_en: Documentation
+    description_zh: 文件更新
+
+  - type: style
+    description_en: Formatting
+    description_zh: 格式調整
+
+  - type: test
+    description_en: Tests
+    description_zh: 測試
+
+  - type: perf
+    description_en: Performance
+    description_zh: 效能改善
+
+  - type: build
+    description_en: Build system
+    description_zh: 建置系統
+
+  - type: ci
+    description_en: CI/CD
+    description_zh: 持續整合
+
+  - type: chore
+    description_en: Maintenance
+    description_zh: 維護任務
+
+  - type: security
+    description_en: Security fix
+    description_zh: 安全修正
+
+rules:
+  - id: english-type-scope
+    trigger: 撰寫提交標頭時
+    instruction: 類型和範圍使用英文（工具相容性）
+    priority: required
+
+  - id: bilingual-subject
+    trigger: 撰寫主旨時
+    instruction: 包含英文和中文主旨，以句號分隔
+    priority: required
+
+  - id: bilingual-body
+    trigger: 撰寫內文時
+    instruction: 以雙語撰寫內文，英文優先
+    priority: recommended
+
+examples:
+  simple: "feat(auth): Add login form. 新增登入表單."
+  with_body: |
+    feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援.
+
+    Implement Google OAuth2 authentication flow for user login.
+
+    - Add Google OAuth2 SDK integration
+    - Create callback endpoint for OAuth flow
+    - Store refresh tokens securely
+
+    實作 Google OAuth2 認證流程供使用者登入。
+
+    - 整合 Google OAuth2 SDK
+    - 建立 OAuth 流程回呼端點
+    - 安全儲存更新權杖
+
+    Closes #123

package/bundled/locales/zh-TW/ai/options/commit-message/english.ai.yaml

@@ -0,0 +1,79 @@
+# 英文提交格式 - AI 優化選項
+# 父項: commit-message
+
+id: english
+meta:
+  parent: commit-message
+  version: "1.0.0"
+  description: 標準英文提交訊息格式
+  language: zh-TW
+
+best_for:
+  - 國際團隊
+  - 開源專案
+  - 工具相容性最佳
+
+format:
+  template: "<type>(<scope>): <subject>"
+  note: 類型和範圍使用英文
+
+types:
+  - type: feat
+    description: 新功能
+  - type: fix
+    description: 錯誤修正
+  - type: refactor
+    description: 程式碼重構
+  - type: docs
+    description: 文件更新
+  - type: style
+    description: 格式調整
+  - type: test
+    description: 測試相關
+  - type: perf
+    description: 效能改善
+  - type: build
+    description: 建置系統
+  - type: ci
+    description: 持續整合
+  - type: chore
+    description: 維護任務
+  - type: security
+    description: 安全修正
+
+rules:
+  - id: english-type
+    trigger: 撰寫提交標頭時
+    instruction: 使用英文類型（feat, fix, refactor 等）
+    priority: required
+
+  - id: english-subject
+    trigger: 撰寫主旨時
+    instruction: 以英文撰寫主旨
+    priority: required
+
+  - id: imperative-mood
+    trigger: 撰寫主旨時
+    instruction: 使用祈使語氣（Add 而非 Added）
+    priority: required
+
+examples:
+  simple: "feat(auth): Add OAuth2 login support"
+  with_body: |
+    feat(auth): Add OAuth2 Google login support
+
+    Implement Google OAuth2 authentication flow for user login.
+
+    - Add Google OAuth2 SDK integration
+    - Create callback endpoint for OAuth flow
+    - Store refresh tokens securely
+
+    Closes #123
+  breaking: |
+    feat(api)!: Change response format to JSON
+
+    BREAKING CHANGE: API response format changed from XML to JSON
+
+    Migration guide:
+    1. Update API clients to remove .data wrapper
+    2. Use created_at instead of createdAt