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

package/bundled/locales/zh-CN/ai/options/testing/performance-testing.ai.yaml

@@ -0,0 +1,272 @@
+# 效能测试 - AI 优化选项
+# 父层: testing
+
+id: performance-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 效能测试标准与实踐
+  references:
+    - "ISTQB Performance Testing"
+    - "Google SRE Book"
+
+best_for:
+  - 高流量应用程序
+  - 即时系统
+  - 電子商务平台
+  - API 与微服务
+  - 数据庫密集型应用
+
+testing_types:
+  load_testing:
+    name: 負载测试
+    description: 测试系统在预期負载下的行为
+    purpose: 验证系统能处理正常流量
+    metrics:
+      - 响应时间 (P50, P95, P99)
+      - 吞吐量 (TPS/RPS)
+      - 错误率
+    tools:
+      - name: k6
+        type: 開源
+        language: JavaScript
+      - name: JMeter
+        type: 開源
+        language: Java/XML
+      - name: Gatling
+        type: 開源
+        language: Scala
+      - name: Locust
+        type: 開源
+        language: Python
+
+  stress_testing:
+    name: 壓力测试
+    description: 测试系统超出正常負载的行为
+    purpose: 找出系统極限与故障模式
+    metrics:
+      - 最大容量
+      - 效能衰退曲线
+      - 恢復时间
+    approach:
+      - 逐步增加負载
+      - 監控错误与延遲
+      - 識别瓶頸
+      - 记录故障閾值
+
+  spike_testing:
+    name: 尖峰测试
+    description: 测试流量突然增加的情况
+    purpose: 验证系统处理流量尖峰的能力
+    scenarios:
+      - 限时搶購
+      - 病毒式传播内容
+      - 行销活动
+      - 定时事件
+
+  soak_testing:
+    name: 耐久测试
+    abbreviation: 穩定性测试
+    description: 测试系统長时间运行的穩定性
+    purpose: 發現记忆体洩漏和效能衰退
+    duration: 數小时至數天
+    watch_for:
+      - 记忆体洩漏
+      - 連线池耗盡
+      - 日誌文件增長
+      - 漸进式效能衰退
+
+  capacity_testing:
+    name: 容量测试
+    description: 确定系统最大容量
+    purpose: 規划擴展和基礎设施
+    output:
+      - 使用者容量上限
+      - 資源需求
+      - 擴展閾值
+
+key_metrics:
+  latency:
+    name: 延遲
+    description: 响应请求所需时间
+    percentiles:
+      - name: P50
+        description: 中位數响应时间
+        target: 基准值
+      - name: P95
+        description: 第 95 百分位
+        target: 基准值的 2-3 倍
+      - name: P99
+        description: 第 99 百分位
+        target: 最大不超過基准值 5 倍
+    note: "P99 对使用者体驗的影響通常比平均值更重要"
+
+  throughput:
+    name: 吞吐量
+    description: 单位时间处理的请求數
+    measurements:
+      - TPS (每秒交易數)
+      - RPS (每秒请求數)
+      - QPS (每秒查詢數)
+    considerations:
+      - 尖峰 vs 持續負载
+      - 併發使用者 vs 请求數
+
+  error_rate:
+    name: 错误率
+    description: 失败请求的百分比
+    targets:
+      acceptable: "<0.1%"
+      degraded: "<1%"
+      critical: ">1%"
+
+  resource_utilization:
+    name: 資源使用率
+    description: 系统資源消耗
+    measurements:
+      - CPU 使用率
+      - 记忆体使用率
+      - 网络 I/O
+      - 磁碟 I/O
+      - 連线池使用率
+
+service_level_objectives:
+  name: 服务等级目標
+  description: 定義可量测的效能目標
+  template:
+    latency_slo: "P99 延遲 < 200ms"
+    availability_slo: "99.9% 可用性"
+    throughput_slo: "持續 1000 RPS"
+    error_slo: "错误率 < 0.1%"
+  note: "SLO 应基于使用者需求，而非系统能力"
+
+rules:
+  - id: baseline-first
+    trigger: 開始效能测试
+    instruction: 在优化前先建立基准指標
+    priority: required
+
+  - id: realistic-data
+    trigger: 设置测试環境
+    instruction: 使用接近生产環境的数据量和模式
+    priority: required
+
+  - id: isolate-environment
+    trigger: 执行效能测试
+    instruction: 使用隔離環境避免干擾
+    priority: required
+
+  - id: gradual-load
+    trigger: 执行負载测试
+    instruction: 逐步增加負载以識别閾值
+    priority: recommended
+
+  - id: monitor-resources
+    trigger: 测试执行期间
+    instruction: 監控所有系统資源 (CPU、记忆体、I/O)
+    priority: required
+
+  - id: percentile-focus
+    trigger: 分析結果
+    instruction: 关注 P95/P99 延遲，而非平均值
+    priority: required
+
+  - id: regression-testing
+    trigger: 程序码变更後
+    instruction: 在 CI/CD 中包含效能回歸测试
+    priority: recommended
+
+test_phases:
+  phase_1_baseline:
+    name: 第一阶段：基准测试
+    description: 建立當前效能基准
+    activities:
+      - 以最小負载执行测试
+      - 记录當前指標
+      - 識别現有問題
+    duration: 1-2 天
+
+  phase_2_load:
+    name: 第二阶段：負载测试
+    description: 正常負载测试
+    activities:
+      - 模擬预期流量
+      - 验证 SLO 合規性
+      - 監控資源使用
+    duration: 2-3 天
+
+  phase_3_stress:
+    name: 第三阶段：壓力测试
+    description: 超出正常容量测试
+    activities:
+      - 增加負载直到故障
+      - 记录故障点
+      - 测试恢復程序
+    duration: 1-2 天
+
+  phase_4_soak:
+    name: 第四阶段：耐久测试
+    description: 長时间测试
+    activities:
+      - 运行 24-72 小时
+      - 監控效能衰退
+      - 检查记忆体洩漏
+    duration: 1-3 天
+
+ci_integration:
+  approach: 在 CI 中执行輕量级效能测试
+  example_k6: |
+    import http from 'k6/http';
+    import { check, sleep } from 'k6';
+
+    export const options = {
+      stages: [
+        { duration: '30s', target: 10 },
+        { duration: '1m', target: 10 },
+        { duration: '30s', target: 0 },
+      ],
+      thresholds: {
+        http_req_duration: ['p(95)<500'],
+        http_req_failed: ['rate<0.01'],
+      },
+    };
+
+    export default function () {
+      const res = http.get('https://api.example.com/health');
+      check(res, { 'status 200': (r) => r.status === 200 });
+      sleep(1);
+    }
+
+  github_actions: |
+    name: Performance Test
+    on:
+      pull_request:
+        branches: [main]
+    jobs:
+      k6:
+        runs-on: ubuntu-latest
+        steps:
+          - uses: actions/checkout@v4
+          - name: Run k6 test
+            uses: grafana/k6-action@v0.3.1
+            with:
+              filename: tests/performance/load-test.js
+
+quick_reference:
+  test_types:
+    columns: [类型, 目的, 时長, 时机]
+    rows:
+      - [負载测试, 正常流量, 分鐘, 每次發布]
+      - [壓力测试, 找出極限, 小时, 主要發布]
+      - [尖峰测试, 突發流量, 分鐘, 视需求]
+      - [耐久测试, 長期穩定性, 天, 每季]
+      - [容量测试, 最大容量, 小时, 規划时]
+
+  key_metrics:
+    columns: [指標, 测量内容, 目標]
+    rows:
+      - [P50 延遲, 中位數响应, 基准值]
+      - [P95 延遲, 典型最差情况, "基准值 2-3 倍"]
+      - [P99 延遲, 極端情况, "最大基准值 5 倍"]
+      - [吞吐量, 每秒请求數, SLO 定義]
+      - [错误率, 失败请求, "<0.1%"]

package/bundled/locales/zh-CN/ai/options/testing/security-testing.ai.yaml

@@ -0,0 +1,160 @@
+# 安全测试 - AI 优化选项
+# 父项: testing
+
+id: security-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 安全测试标准和实踐
+  language: zh-CN
+  references:
+    - "OWASP 测试指南"
+    - "NIST SP 800-115"
+
+best_for:
+  - 处理敏感数据的应用程序
+  - 金融服务
+  - 醫療应用程序
+  - 電子商务平台
+  - 任何面向公眾的应用程序
+
+testing_types:
+  static_analysis:
+    abbreviation: SAST
+    full_name: 静态应用程序安全测试
+    description: 不执行程序码分析原始码
+    when_to_use: 开发早期、CI/CD 管线
+    tools:
+      - name: SonarQube
+        languages: 多语言
+      - name: Semgrep
+        languages: 多语言
+      - name: CodeQL
+        languages: 多语言
+      - name: Bandit
+        languages: Python
+
+  dynamic_analysis:
+    abbreviation: DAST
+    full_name: 动态应用程序安全测试
+    description: 测试执行中的应用程序以找出漏洞
+    when_to_use: 预备環境、正式上线前
+    tools:
+      - name: OWASP ZAP
+        type: 開源
+      - name: Burp Suite
+        type: 商业
+      - name: Nuclei
+        type: 開源
+
+  dependency_scanning:
+    abbreviation: SCA
+    full_name: 软体組成分析
+    description: 检查相依套件的已知漏洞
+    when_to_use: 每次建置、持續監控
+    tools:
+      - name: Snyk
+        type: SaaS/CLI
+      - name: Dependabot
+        type: GitHub 集成
+      - name: npm audit
+        type: CLI
+      - name: OWASP Dependency-Check
+        type: 開源
+
+  penetration_testing:
+    abbreviation: Pentest
+    full_name: 滲透测试
+    description: 由安全專业人員进行的模擬攻擊
+    when_to_use: 重大版本發布前、每年
+    types:
+      - 黑箱（無事先知識）
+      - 白箱（完整存取）
+      - 灰箱（部分知識）
+
+  secret_scanning:
+    full_name: 机密掃描
+    description: 偵测暴露的憑证和机密
+    tools:
+      - name: GitLeaks
+        type: 開源
+      - name: TruffleHog
+        type: 開源
+      - name: GitHub Secret Scanning
+        type: GitHub 集成
+
+owasp_top_10:
+  description: OWASP 十大网络应用程序安全風險
+  version: "2021"
+  risks:
+    - id: A01
+      name: 存取控制失效
+      test_focus: 授权检查、权限提升
+    - id: A02
+      name: 加密失效
+      test_focus: 加密、金鑰管理、数据暴露
+    - id: A03
+      name: 注入攻擊
+      test_focus: SQL、NoSQL、OS、LDAP 注入
+    - id: A04
+      name: 不安全的设计
+      test_focus: 安全需求、威脅建模
+    - id: A05
+      name: 安全设置错误
+      test_focus: 预设设置、不必要的功能
+    - id: A06
+      name: 易受攻擊的元件
+      test_focus: 過时的相依套件、已知 CVE
+    - id: A07
+      name: 身分验证失效
+      test_focus: 会話管理、憑证填充
+    - id: A08
+      name: 软体和数据完整性失效
+      test_focus: CI/CD 管线安全、序列化
+    - id: A09
+      name: 安全日誌和監控失效
+      test_focus: 稽核日誌、警报
+    - id: A10
+      name: 服务器端请求偽造
+      test_focus: URL 验证、网络隔離
+
+rules:
+  - id: sast-in-ci
+    trigger: 设置 CI/CD 时
+    instruction: 在每个建置管线中包含 SAST
+    priority: required
+
+  - id: dependency-scanning
+    trigger: 新增相依套件时
+    instruction: 掃描所有相依套件的漏洞
+    priority: required
+
+  - id: secret-scanning
+    trigger: 提交程序码时
+    instruction: 推送前掃描暴露的机密
+    priority: required
+
+  - id: dast-staging
+    trigger: 部署到预备環境时
+    instruction: 对预备環境执行 DAST
+    priority: recommended
+
+  - id: pentest-annually
+    trigger: 年度安全审查时
+    instruction: 每年至少进行一次滲透测试
+    priority: recommended
+
+  - id: owasp-checklist
+    trigger: 安全测试規划时
+    instruction: 测试计画涵蓋所有 OWASP 十大風險
+    priority: required
+
+quick_reference:
+  testing_types:
+    columns: [类型, 縮写, 时机, 工具]
+    rows:
+      - [静态分析, SAST, CI/CD, SonarQube/Semgrep]
+      - [动态分析, DAST, 预备環境, OWASP ZAP/Burp]
+      - [相依套件掃描, SCA, 每次建置, Snyk/Dependabot]
+      - [滲透测试, Pentest, 每年, 人工/專业]
+      - [机密掃描, -, 提交前, GitLeaks/TruffleHog]

package/bundled/locales/zh-CN/ai/options/testing/system-testing.ai.yaml

@@ -0,0 +1,101 @@
+# 系统测试 - AI 优化选项
+# 父项: testing
+
+id: system-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 测试完整系统作为黑盒
+  language: zh-CN
+
+characteristics:
+  scope: 完整系统
+  speed: "<10 秒每个测试"
+  isolation: 最小（类正式環境）
+  pyramid_percentage: 7%
+
+rules:
+  - id: production-like-environment
+    trigger: 设置系统测试时
+    instruction: 使用盡可能接近正式環境的设置
+    priority: required
+
+  - id: test-complete-flows
+    trigger: 设计系统测试时
+    instruction: 测试完整的业务流程，而非个别元件
+    priority: required
+
+  - id: external-service-stubs
+    trigger: 处理外部服务时
+    instruction: 只对無法控制的外部服务使用 stub
+    priority: recommended
+
+  - id: data-cleanup
+    trigger: 测试执行後
+    instruction: 确保测试数据在测试後清理
+    priority: required
+
+when_to_write:
+  - 测试完整业务工作流程
+  - 测试系统行为
+  - 测试元件互动
+  - 验证配置
+  - 测试非功能需求
+
+environment_setup:
+  - name: Docker Compose
+    description: 编排所有服务
+    example: |
+      # docker-compose.test.yml
+      services:
+        app:
+          build: .
+        db:
+          image: postgres:15
+        redis:
+          image: redis:7
+
+  - name: Testcontainers
+    description: 程序化容器管理
+    example: |
+      const postgres = await new PostgreSqlContainer().start();
+      const redis = await new GenericContainer('redis:7').start();
+
+test_patterns:
+  - name: API 契約测试
+    description: 验证 API 行为符合契約
+    example: |
+      describe('User API Contract', () => {
+        it('POST /users returns 201 with valid data', async () => {
+          const res = await api.post('/users').send(validUser);
+          expect(res.status).toBe(201);
+          expect(res.body).toMatchSchema(userSchema);
+        });
+      });
+
+  - name: 工作流程测试
+    description: 测试完整业务流程
+    example: |
+      describe('Order Workflow', () => {
+        it('completes purchase flow', async () => {
+          await createUser();
+          await addToCart(product);
+          await checkout();
+          await verifyOrder();
+        });
+      });
+
+tools:
+  orchestration:
+    - Docker Compose
+    - Kubernetes (minikube)
+    - Testcontainers
+  api_testing:
+    - Postman/Newman
+    - REST Assured
+    - Supertest
+  contract_testing:
+    - Pact
+    - Spring Cloud Contract
+
+coverage_target: "关鍵业务工作流程"

package/bundled/locales/zh-CN/ai/options/testing/unit-testing.ai.yaml

@@ -0,0 +1,82 @@
+# 单元测试 - AI 优化选项
+# 父项: testing
+
+id: unit-testing
+meta:
+  parent: testing
+  version: "1.0.0"
+  description: 隔離测试个别函式和方法
+  language: zh-CN
+
+characteristics:
+  scope: 单一函式或方法
+  speed: "<100ms 每个测试"
+  isolation: 完全隔離（無外部相依性）
+  pyramid_percentage: 70%
+
+rules:
+  - id: test-one-thing
+    trigger: 撰写单元测试时
+    instruction: 每个测试应只验证一个行为
+    priority: required
+
+  - id: isolate-dependencies
+    trigger: 测试有相依性时
+    instruction: 对外部相依性使用 stub/mock
+    priority: required
+
+  - id: fast-execution
+    trigger: 撰写单元测试时
+    instruction: 单元测试必須在 100ms 內执行完成
+    priority: required
+
+  - id: naming-convention
+    trigger: 命名单元测试时
+    instruction: 使用模式 methodName_scenario_expectedResult
+    priority: recommended
+    examples:
+      good:
+        - "calculateTotal_withEmptyCart_returnsZero"
+        - "validateEmail_withInvalidFormat_returnsFalse"
+      bad:
+        - "test1"
+        - "testCalculate"
+
+  - id: arrange-act-assert
+    trigger: 組織测试结构时
+    instruction: 在测试內文中遵循 AAA 模式
+    priority: required
+
+structure:
+  pattern: "Arrange-Act-Assert"
+  example: |
+    // Arrange - 准备
+    const calculator = new Calculator();
+    const input = 5;
+
+    // Act - 执行
+    const result = calculator.square(input);
+
+    // Assert - 验证
+    expect(result).toBe(25);
+
+when_to_write:
+  - 测试純函式
+  - 测试商业邏辑
+  - 测试数据转换
+  - 测试验证規則
+  - 测试邊緣案例和邊界
+
+when_not_to_write:
+  - 测试框架程序码
+  - 测试簡单的 getter/setter
+  - 测试第三方函式庫
+
+coverage_target: "商业邏辑的 80%"
+
+tools:
+  javascript: [Jest, Vitest, Mocha]
+  python: [pytest, unittest]
+  java: [JUnit, TestNG]
+  csharp: [xUnit, NUnit, MSTest]
+  go: [testing package, testify]