多语言产品需求文档 (PRD)

1. 功能概述

[功能描述，需包含所有语言版本的核心术语]

2. 多语言需求

语言	特殊要求	文化适配说明
zh-CN	需支持简体中文术语	符合中国大陆地区用语习惯
en-US	采用美式英语	避免地区性俚语
ja-JP	敬语使用规范	遵循日本商业礼仪

3. 翻译优先级

• P0: 核心功能UI文本
• P1: 帮助文档
• P2: 营销素材

#### 2. 配置工作流自动化规则
修改工作流配置文件，添加多语言支持：

```yaml
# src/bmm/workflows/2-plan-workflows/create-prd/workflow-create-prd.md
name: 多语言PRD创建工作流
steps:
  - id: step-02b-vision
    name: 定义多语言产品愿景
    description: "确定产品在不同语言市场的定位和差异化需求"
    inputs:
      - name: target_markets
        type: list
        required: true
        description: "目标市场语言列表"
      - name: cultural_considerations
        type: text
        description: "各市场的文化考量因素"
  
  - id: step-09-functional
    name: 功能需求多语言适配
    description: "确保所有功能需求考虑多语言实现"
    checks:
      - rule: "all_features_have_i18n_support"
        severity: "blocking"

3. 实施增量翻译流程

配置增量翻译触发机制：

# 设置翻译钩子，当特定目录文件变更时触发翻译
npx bmad-cli configure-hook --event "file:change" --path "src/ui/texts" --action "trigger-translation"

常见陷阱：过度依赖机器翻译会导致质量问题。建议采用"机器翻译+人工校对"的混合模式，对核心功能文本实施100%人工审核。

资源管理混乱？结构化多语言资产体系

问题引入：多语言资源的维护挑战

随着支持语言增多，资源文件管理复杂度呈指数级增长。某社交应用在支持15种语言后，资源文件数量超过300个，开发团队经常面临"找不到对应语言文件"、"翻译更新不同步"等问题，导致线上出现"语言混搭"的尴尬情况。

核心解决方案：模块化多语言资源架构

BMAD-METHOD采用"功能模块+语言"的二维资源组织方式，结合智能资源加载机制，实现高效管理：

1. 按功能模块划分资源：将UI文本、错误信息、帮助文档等按功能模块分离
2. 标准化资源文件格式：统一采用YAML格式，支持嵌套结构和变量引用
3. 智能资源加载：根据用户语言偏好和功能模块动态加载所需资源

实践指南：构建可扩展的多语言资源系统

1. 资源文件组织结构

src/
├── resources/
│   ├── common/           # 通用资源
│   │   ├── zh-CN.yaml
│   │   ├── en-US.yaml
│   │   └── ja-JP.yaml
│   ├── auth/             # 认证模块资源
│   │   ├── zh-CN.yaml
│   │   ├── en-US.yaml
│   │   └── ja-JP.yaml
│   └── checkout/         # 结账模块资源
│       ├── zh-CN.yaml
│       ├── en-US.yaml
│       └── ja-JP.yaml

2. 创建标准化资源文件

# src/resources/checkout/zh-CN.yaml
checkout:
  title: "结算"
  steps:
    shipping: "配送信息"
    payment: "支付方式"
    review: "订单确认"
  buttons:
    continue: "继续"
    back: "返回"
    submit: "提交订单"
  errors:
    address_required: "请填写收货地址"
    payment_failed: "支付失败，请重试"
  # 支持变量
  order_summary: "订单摘要 ({{item_count}} 件商品)"

3. 配置资源加载策略

// src/core/i18n/resource-loader.js
import { loadResourceBundle } from '@bmad/i18n-utils';

// 智能资源加载
export async function loadModuleResources(moduleName, lang) {
  try {
    // 加载模块特定资源
    const moduleResources = await loadResourceBundle(`resources/${moduleName}/${lang}.yaml`);
    
    // 加载通用资源
    const commonResources = await loadResourceBundle(`resources/common/${lang}.yaml`);
    
    // 合并资源并返回
    return { ...commonResources, ...moduleResources };
  } catch (error) {
    console.error(`Failed to load resources for ${moduleName} (${lang})`, error);
    // 回退到默认语言
    return loadResourceBundle(`resources/${moduleName}/en-US.yaml`);
  }
}

常见陷阱：资源文件过度拆分可能导致加载性能问题。建议根据功能关联性和加载频率合理分组，对高频访问资源实施预加载。

高级应用：多语言测试与持续优化

问题引入：多语言质量保障的复杂性

多语言测试远不止简单的文本验证，还涉及日期格式、货币显示、排版布局等多方面验证。某金融科技产品曾因未测试阿拉伯语从右到左的排版特性，导致上线后界面元素重叠，紧急回滚造成直接损失超过50万美元。

核心解决方案：全维度多语言测试体系

BMAD-METHOD构建了覆盖"语言质量-功能适配-文化合规"的三维测试框架：

1. 语言质量测试：术语一致性、翻译准确性、语法正确性
2. 功能适配测试：界面布局、文本长度、日期/货币格式
3. 文化合规测试：地区法规遵循、文化敏感性、内容适宜性

实践指南：构建自动化多语言测试流程

1. 配置多语言测试套件

// test/qa-generate-e2e-tests/multilingual-test-suite.js
const { MultiLingualTest } = require('@bmad/test-utils');

// 定义测试配置
const testConfig = {
  languages: ['zh-CN', 'en-US', 'ja-JP', 'ar-SA'],
  testScenarios: [
    {
      name: 'UI文本显示测试',
      path: '/test/scenarios/ui-texts.yaml',
      severity: 'critical'
    },
    {
      name: '日期格式测试',
      path: '/test/scenarios/date-formats.yaml',
      severity: 'high'
    },
    {
      name: 'RTL布局测试',
      path: '/test/scenarios/rtl-layout.yaml',
      languages: ['ar-SA', 'he-IL'], // 仅对RTL语言运行
      severity: 'high'
    }
  ]
};

// 执行多语言测试
const testRunner = new MultiLingualTest(testConfig);
testRunner.execute().then(results => {
  console.log(`测试完成: ${results.passed}/${results.total} 用例通过`);
  if (results.failed > 0) {
    console.error(`失败用例: ${JSON.stringify(results.failures, null, 2)}`);
    process.exit(1);
  }
});

2. 集成文化适配检查

# test/adversarial-review-tests/test-cases.yaml
- id: cultural_sensitivity_check
  name: 文化敏感性检查
  description: "验证内容是否符合目标市场文化规范"
  severity: high
  steps:
    - "加载目标市场文化规范知识库"
    - "对所有用户可见文本执行文化敏感性分析"
    - "标记可能引起文化冲突的内容"
  success_criteria: "未发现高风险文化冲突项"
  examples:
    - input: "使用红色作为成功状态指示"
      expected: "在某些东亚文化中需谨慎使用"