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

package/bundled/locales/zh-TW/ai/standards/anti-hallucination.ai.yaml

@@ -0,0 +1,145 @@
+# AI 協作防幻覺標準 - AI 優化版
+# 來源: core/anti-hallucination.md
+
+id: anti-hallucination
+meta:
+  version: "1.3.1"
+  updated: "2025-12-30"
+  source: core/anti-hallucination.md
+  description: AI 助手防止幻覺的嚴格指南
+  language: zh-TW
+
+principles:
+  evidence_based:
+    rule: 只分析和引用已明確提供或讀取的內容
+    do:
+      - 分析使用檔案讀取工具已讀取的程式碼檔案
+      - 引用已取得的文件
+      - 引用已檢查的設定檔
+    do_not:
+      - 推測未見過的 API、函式或設定
+      - 假設框架行為而不驗證
+      - 捏造需求細節
+
+  source_attribution:
+    rule: 所有引用必須包含來源類型、位置和可驗證性
+    source_types:
+      - type: "[來源: 程式碼]"
+        description: 直接從程式碼庫讀取
+        reliability: 5
+      - type: "[來源: 文件]"
+        description: README、Wiki、內嵌註解
+        reliability: 4
+      - type: "[來源: 外部]"
+        description: 官方文件附 URL
+        reliability: 4
+      - type: "[來源: 搜尋]"
+        description: 搜尋結果（含日期）
+        reliability: 3
+      - type: "[來源: 知識庫]"
+        description: AI 訓練資料（需驗證）
+        reliability: 2
+      - type: "[來源: 使用者]"
+        description: 使用者對話中的資訊
+        reliability: 3
+
+  certainty_classification:
+    rule: 明確區分已確認的事實、推論和未知項目
+    tags:
+      - tag: "[已確認]"
+        use_when: 來自程式碼/文件的直接證據
+      - tag: "[推論]"
+        use_when: 從可用證據邏輯推導
+      - tag: "[假設]"
+        use_when: 基於常見模式（需驗證）
+      - tag: "[未知]"
+        use_when: 資訊不可用
+      - tag: "[待確認]"
+        use_when: 需要使用者澄清
+
+prohibited_behaviors:
+  - id: fabricate-apis
+    description: 不要發明方法名稱、參數或回傳類型
+    correct_action: 讀取實際原始碼或詢問使用者
+
+  - id: assume-requirements
+    description: 不要猜測使用者需求或商業規則
+    correct_action: 需求不明確時詢問澄清問題
+
+  - id: speculate-unread-code
+    description: 不要描述未審閱檔案的功能
+    correct_action: 明確說明「需要讀取 [檔案] 以確認」
+
+  - id: invent-configuration
+    description: 不要假設環境變數、設定鍵或資料庫 schema
+    correct_action: 審閱實際設定檔
+
+  - id: hallucinate-errors
+    description: 不要在沒有證據的情況下宣稱程式碼有問題
+    correct_action: 分析實際程式碼並引用具體行數
+
+  - id: options-without-recommendation
+    description: 不要列出選項讓使用者選擇而不提供指引
+    correct_action: 始終包含建議選項及理由
+
+rules:
+  - id: conversation-language
+    trigger: 回應使用者時
+    instruction: 適應使用者偏好的語言；保留技術術語
+    priority: required
+
+  - id: include-recommendation
+    trigger: 提供多個選項時
+    instruction: 始終標示建議選項及理由
+    priority: required
+
+  - id: suggest-next-steps
+    trigger: 完成任務或子任務時
+    instruction: 建議邏輯性的下一步並標示最推薦的選項
+    priority: required
+
+  - id: cite-sources
+    trigger: 對程式碼做任何陳述時
+    instruction: 包含來源類型標籤和 file:line 引用
+    priority: required
+
+  - id: version-sensitivity
+    trigger: 引用函式庫或 API 時
+    instruction: 可用時始終包含版本資訊
+    priority: required
+
+  - id: ask-for-clarification
+    trigger: 需求不明確時
+    instruction: 繼續之前詢問澄清問題
+    priority: required
+
+checklist:
+  - 來源已驗證（讀取實際檔案/文件）
+  - 來源類型已標記
+  - 引用已標註（file:line 或 URL）
+  - 版本已指定（如適用）
+  - 確定性已分類
+  - AI 知識已標記驗證警告
+  - 無捏造內容
+  - 已對模糊點要求使用者澄清
+  - 提供選項時已包含建議
+
+quick_reference:
+  source_types:
+    columns: [標籤, 可靠度, 說明]
+    rows:
+      - ["[來源: 程式碼]", "⭐⭐⭐⭐⭐", 直接從程式碼庫]
+      - ["[來源: 文件]", "⭐⭐⭐⭐", README/Wiki/註解]
+      - ["[來源: 外部]", "⭐⭐⭐⭐", 官方文件附 URL]
+      - ["[來源: 搜尋]", "⭐⭐⭐", 網路搜尋結果]
+      - ["[來源: 知識庫]", "⭐⭐", AI 知識（需驗證）]
+      - ["[來源: 使用者]", "⭐⭐⭐", 使用者對話]
+
+  certainty_tags:
+    columns: [標籤, 使用時機]
+    rows:
+      - ["[已確認]", 來自程式碼/文件的直接證據]
+      - ["[推論]", 邏輯推導]
+      - ["[假設]", 常見模式（需驗證）]
+      - ["[未知]", 資訊不可用]
+      - ["[待確認]", 需要澄清]

package/bundled/locales/zh-TW/ai/standards/changelog.ai.yaml

@@ -0,0 +1,146 @@
+# 變更日誌標準 - AI 優化版
+# 來源: core/changelog-standards.md
+
+id: changelog
+meta:
+  version: "1.1.0"
+  updated: "2025-12-30"
+  source: core/changelog-standards.md
+  description: Keep a Changelog 格式規範
+  language: zh-TW
+
+options:
+  changelog_format:
+    description: 選擇變更日誌格式方法
+    multiSelect: false
+    choices:
+      - id: keep-a-changelog
+        file: options/changelog/keep-a-changelog.ai.yaml
+        best_for: 手動維護、人類可讀的變更日誌
+      - id: auto-generated
+        file: options/changelog/auto-generated.ai.yaml
+        best_for: 從 commit 自動生成
+
+format:
+  filename: CHANGELOG.md
+  structure: |
+    # 變更日誌
+
+    本專案所有重要變更都會記錄在此檔案中。
+
+    格式基於 [Keep a Changelog](https://keepachangelog.com/)。
+
+    ## [Unreleased]
+
+    ### Added
+    - 新功能
+
+    ### Changed
+    - 現有功能的變更
+
+    ### Deprecated
+    - 即將移除的功能
+
+    ### Removed
+    - 已移除的功能
+
+    ### Fixed
+    - 錯誤修正
+
+    ### Security
+    - 安全漏洞修正
+
+    ## [1.0.0] - 2025-01-01
+
+    ### Added
+    - 初始發布
+
+change_types:
+  - type: Added
+    type_zh: 新增
+    description: 新功能
+    order: 1
+
+  - type: Changed
+    type_zh: 變更
+    description: 現有功能的變更
+    order: 2
+
+  - type: Deprecated
+    type_zh: 棄用
+    description: 即將移除的功能
+    order: 3
+
+  - type: Removed
+    type_zh: 移除
+    description: 已移除的功能
+    order: 4
+
+  - type: Fixed
+    type_zh: 修正
+    description: 錯誤修正
+    order: 5
+
+  - type: Security
+    type_zh: 安全性
+    description: 安全漏洞修正
+    order: 6
+
+rules:
+  - id: unreleased-section
+    trigger: 進行變更時
+    instruction: 將項目加入 [Unreleased] 區段
+    priority: required
+
+  - id: version-on-release
+    trigger: 發布新版本時
+    instruction: 將 [Unreleased] 項目移至新版本區段並加上日期
+    priority: required
+
+  - id: semantic-versioning
+    trigger: 選擇版本號時
+    instruction: 遵循語意化版本 (MAJOR.MINOR.PATCH)
+    priority: required
+
+  - id: date-format
+    trigger: 加入發布日期時
+    instruction: 使用 ISO 格式 YYYY-MM-DD
+    validator: "^\\d{4}-\\d{2}-\\d{2}$"
+    priority: required
+
+  - id: reverse-chronological
+    trigger: 排序版本時
+    instruction: 最新版本放在最前面
+    priority: required
+
+  - id: link-versions
+    trigger: 新增版本區段時
+    instruction: 在檔案底部加入版本比較連結
+    priority: recommended
+
+examples:
+  entry: |
+    ## [1.2.0] - 2025-01-15
+
+    ### Added
+    - 使用者 OAuth2 認證 (#123)
+    - 深色模式支援 (#145)
+
+    ### Fixed
+    - 登入逾時問題 (#156)
+
+  links: |
+    [Unreleased]: 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
+    [1.1.0]: https://github.com/user/repo/releases/tag/v1.1.0
+
+quick_reference:
+  change_types:
+    columns: [類型, 說明, 範例]
+    rows:
+      - [Added (新增), 新功能, "新增登入頁面"]
+      - [Changed (變更), 功能修改, "更新 API 回應格式"]
+      - [Deprecated (棄用), 即將移除, "舊版認證端點"]
+      - [Removed (移除), 已刪除功能, "移除 v1 API"]
+      - [Fixed (修正), 錯誤修正, "修正空指標錯誤"]
+      - [Security (安全性), 漏洞修正, "修補 XSS 漏洞"]

package/bundled/locales/zh-TW/ai/standards/checkin-standards.ai.yaml

@@ -0,0 +1,170 @@
+# 程式碼簽入標準 - AI 優化版
+# 來源: core/checkin-standards.md
+
+id: checkin-standards
+meta:
+  version: "1.3.0"
+  updated: "2026-01-05"
+  source: core/checkin-standards.md
+  description: 提交程式碼前必須通過的品質關卡
+  language: zh-TW
+
+philosophy:
+  every_commit_should:
+    - 是一個完整的邏輯工作單元
+    - 讓程式碼庫保持在可運作狀態
+    - 可以回復而不破壞功能
+    - 包含自己的測試（針對新功能）
+    - 讓未來的開發者能理解
+
+checklist:
+  build_verification:
+    items:
+      - 程式碼編譯成功（零錯誤）
+      - 零建置警告（或有記錄的例外）
+      - 所有套件相依性已安裝
+      - 相依性版本已鎖定/記錄
+      - 無遺漏的 import 或模組
+
+  test_verification:
+    items:
+      - 所有既有測試通過（100% 通過率）
+      - 新程式碼有對應的測試
+      - Bug 修正包含回歸測試
+      - 邊緣案例已涵蓋
+      - 測試覆蓋率維持或提升
+
+  code_quality:
+    items:
+      - 遵循程式碼標準
+      - 方法 ≤50 行（或專案標準）
+      - 巢狀深度 ≤3 層
+      - 循環複雜度 ≤10
+      - 無重複的程式碼區塊
+      - 無硬編碼的機密
+      - 無 SQL/XSS 注入漏洞
+
+  documentation:
+    items:
+      - API 文件已更新
+      - README 已更新（如需要）
+      - CHANGELOG 已更新（使用者可見的變更加入 [Unreleased] 區段）
+
+  workflow_compliance:
+    items:
+      - 分支命名正確
+      - Commit 訊息格式正確
+      - 已與目標分支同步
+      - 無合併衝突
+
+timing:
+  appropriate:
+    - 完成功能單元（功能 + 測試 + 文件）
+    - 特定 bug 已修復（含回歸測試）
+    - 獨立重構（所有測試通過）
+    - 可運行狀態（程式碼編譯、應用程式可執行）
+
+  inappropriate:
+    - 建置失敗
+    - 測試失敗
+    - 不完整的功能
+    - 實驗性程式碼（TODO、除錯碼、註解掉的程式碼）
+
+granularity:
+  ideal_commit_size:
+    file_count: 1-10
+    lines_changed: 50-300
+    scope: 單一關注點
+
+  splitting_principles:
+    combine:
+      - 功能實作 + 對應測試
+      - 緊密相關的多檔案變更
+    separate:
+      - 功能 A + 功能 B
+      - 重構 + 新功能
+      - Bug 修正 + 順便重構
+
+trigger_points:
+  - trigger: 階段完成
+    condition: 完成一個開發階段
+    intensity: 建議
+  - trigger: 變更累積
+    condition: 檔案 ≥5 或行數 ≥200
+    intensity: 建議
+  - trigger: 連續跳過
+    condition: 連續跳過簽入 3 次
+    intensity: 警告
+  - trigger: 工作完成
+    condition: 結束前有未提交的變更
+    intensity: 強烈建議
+
+special_scenarios:
+  emergency_leave:
+    option_1:
+      name: Git Stash（推薦）
+      command: 'git stash save "WIP: 描述"'
+    option_2:
+      name: WIP 分支
+      command: 'git checkout -b wip/feature-temp'
+    prohibited: 直接在功能分支提交 WIP 程式碼
+
+  experimental:
+    - 建立實驗分支
+    - 實驗期間自由提交
+    - 成功時 - 清理歷史、squash、合併
+    - 失敗時 - 記錄教訓、刪除分支
+
+  hotfix:
+    - 從 main 建立 hotfix 分支
+    - 最小化變更（只修復問題）
+    - 快速驗證
+    - 在 commit 訊息標記緊急性
+
+rules:
+  - id: build-before-commit
+    trigger: 提交之前
+    instruction: 本地執行建置命令，確保退出碼為 0
+    priority: required
+
+  - id: test-before-commit
+    trigger: 提交之前
+    instruction: 本地執行所有測試套件，檢查覆蓋率
+    priority: required
+
+  - id: no-wip-commits
+    trigger: 撰寫 commit 訊息時
+    instruction: 避免 WIP、save work、trying stuff - 改用 git stash
+    priority: required
+
+  - id: no-commented-code
+    trigger: 檢查變更時
+    instruction: 刪除註解掉的程式碼，依賴 git 歷史
+    priority: required
+
+  - id: single-concern
+    trigger: 暫存變更時
+    instruction: 一個 commit 做一件事 - 分開不相關的變更
+    priority: required
+
+  - id: ai-wait-confirmation
+    trigger: AI 完成程式碼變更時
+    instruction: AI 不得自動執行 git add/commit/push，等待使用者明確同意
+    priority: required
+
+quick_reference:
+  checklist:
+    columns: [類別, 關鍵項目]
+    rows:
+      - [建置, "零錯誤、零警告、相依性滿足"]
+      - [測試, "全部通過、新程式碼已測試、覆蓋率維持"]
+      - [品質, "遵循標準、無機密、無漏洞"]
+      - [文件, "API 文件、README、CHANGELOG 已更新"]
+      - [工作流程, "分支命名、commit 訊息、已同步"]
+
+  commit_size:
+    columns: [指標, 建議]
+    rows:
+      - [檔案數, 1-10 個檔案]
+      - [變更行數, 50-300 行]
+      - [範圍, 單一關注點]

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

@@ -0,0 +1,148 @@
+# 程式碼審查清單 - AI 優化版
+# 來源: core/code-review-checklist.md
+
+id: code-review
+meta:
+  version: "1.2.0"
+  updated: "2026-01-05"
+  source: core/code-review-checklist.md
+  description: 系統化的程式碼品質與安全性審查清單
+  language: zh-TW
+
+options:
+  review_approach:
+    description: 選擇程式碼審查方法
+    multiSelect: true
+    choices:
+      - id: pr-review
+        file: options/code-review/pr-review.ai.yaml
+        best_for: 分散式團隊、非同步工作流程
+      - id: pair-programming
+        file: options/code-review/pair-programming.ai.yaml
+        best_for: 複雜功能、知識傳承
+      - id: automated-review
+        file: options/code-review/automated-review.ai.yaml
+        best_for: CI/CD 整合、捕捉常見問題
+
+checklist:
+  functionality:
+    - item: 程式碼執行預期的功能
+    - item: 邊緣案例已處理
+    - item: 錯誤處理適當
+    - item: 無明顯的錯誤或邏輯問題
+
+  code_quality:
+    - item: 程式碼可讀且自我說明
+    - item: 函式/方法具有單一職責
+    - item: 無程式碼重複（DRY）
+    - item: 變數/函式名稱具描述性
+    - item: 無魔術數字或硬編碼值
+
+  security:
+    - item: 無 SQL 注入漏洞
+    - item: 無 XSS 漏洞
+    - item: 輸入驗證存在
+    - item: 敏感資料未被記錄
+    - item: 認證/授權正確
+
+  performance:
+    - item: 無不必要的資料庫查詢
+    - item: 無記憶體洩漏
+    - item: 使用有效率的演算法
+    - item: 適當考慮快取
+
+  testing:
+    - item: 包含單元測試
+    - item: 測試涵蓋邊緣案例
+    - item: 測試有意義（不只是為了覆蓋率）
+
+  documentation:
+    - item: 公開 API 已記錄
+    - item: 複雜邏輯有註解
+    - item: 如需要已更新 README
+
+comment_prefixes:
+  emoji:
+    - prefix: "❗"
+      meaning: 必要變更（阻擋合併）
+    - prefix: "⚠️"
+      meaning: 建議（非阻擋）
+    - prefix: "💡"
+      meaning: 可有可無
+    - prefix: "❓"
+      meaning: 問題/釐清
+    - prefix: "📝"
+      meaning: 小問題
+    - prefix: "👍"
+      meaning: 讚賞
+
+  text:
+    - prefix: "[REQUIRED]"
+      meaning: 合併前必須修正
+    - prefix: "[SUGGESTION]"
+      meaning: 考慮變更
+    - prefix: "[QUESTION]"
+      meaning: 需要釐清
+    - prefix: "[NIT]"
+      meaning: 次要問題
+    - prefix: "[PRAISE]"
+      meaning: 做得好
+
+rules:
+  - id: review-checklist
+    trigger: 審查程式碼時
+    instruction: 系統性地檢查所有清單項目
+    priority: required
+
+  - id: constructive-feedback
+    trigger: 撰寫審查評論時
+    instruction: 建設性回饋；建議改進，而非只是批評
+    priority: required
+
+  - id: explain-why
+    trigger: 要求變更時
+    instruction: 解釋為什麼需要變更，而不只是說什麼要改
+    priority: required
+
+  - id: praise-good-code
+    trigger: 發現好的程式碼時
+    instruction: 認可並讚賞好的實作
+    priority: recommended
+
+  - id: timely-review
+    trigger: 被指派審查時
+    instruction: 在 24 小時內完成審查
+    priority: recommended
+
+examples:
+  good_comment: |
+    ❗ 這個 SQL 查詢有注入漏洞。請使用參數化查詢：
+    ```sql
+    -- 避免：
+    $"SELECT * FROM users WHERE id = {userId}"
+
+    -- 使用：
+    "SELECT * FROM users WHERE id = @userId"
+    ```
+
+  suggestion: |
+    💡 考慮將此提取為單獨的函式以便重用：
+    ```javascript
+    function validateEmail(email) {
+      return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
+    }
+    ```
+
+  praise: |
+    👍 處理這個邊緣案例做得很好！null 檢查防止了潛在的執行時錯誤。
+
+quick_reference:
+  review_areas:
+    columns: [領域, 重點]
+    rows:
+      - [功能性, 正確性和邊緣案例]
+      - [程式碼品質, 可讀性和可維護性]
+      - [安全性, 漏洞和認證]
+      - [效能, 效率和資源使用]
+      - [測試, 覆蓋率和品質]
+      - [文件, 註解和文件]