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

package/bundled/locales/zh-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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:
+      - [功能性, 正确性和邊緣案例]
+      - [程序码品质, 可读性和可維護性]
+      - [安全性, 漏洞和认证]
+      - [效能, 效率和資源使用]
+      - [测试, 覆蓋率和品质]
+      - [文件, 註解和文件]