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

package/bundled/locales/zh-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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-CN/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-CN
+
+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