ccg-ros2-workflow 2.2.2 → 3.0.0

package/templates/skills/domains/devops/testing.md

@@ -0,0 +1,283 @@
+---
+name: testing
+description: 软件测试。单元测试、集成测试、TDD、测试框架。当用户提到测试、单元测试、pytest、Jest、mock、TDD时使用。
+---
+
+# 🔧 炼器秘典 · 软件测试
+
+
+## 测试金字塔
+
+```
+        /\
+       /  \     E2E 测试 (少)
+      /----\
+     /      \   集成测试 (中)
+    /--------\
+   /          \ 单元测试 (多)
+  --------------
+```
+
+## Python (pytest)
+
+```python
+import pytest
+from myapp import calculate, UserService
+
+# 基础测试
+def test_add():
+    assert calculate.add(1, 2) == 3
+
+# 参数化
+@pytest.mark.parametrize("a,b,expected", [
+    (1, 2, 3),
+    (0, 0, 0),
+    (-1, 1, 0),
+])
+def test_add_params(a, b, expected):
+    assert calculate.add(a, b) == expected
+
+# Fixture
+@pytest.fixture
+def user_service():
+    service = UserService()
+    yield service
+    service.cleanup()
+
+def test_create_user(user_service):
+    user = user_service.create("test")
+    assert user.name == "test"
+
+# Mock
+from unittest.mock import Mock, patch
+
+@patch('myapp.requests.get')
+def test_fetch(mock_get):
+    mock_get.return_value.json.return_value = {"id": 1}
+    result = fetch_user(1)
+    assert result["id"] == 1
+
+# 异步测试
+@pytest.mark.asyncio
+async def test_async_fetch():
+    result = await async_fetch()
+    assert result is not None
+```
+
+### 运行命令
+```bash
+pytest                      # 运行所有
+pytest test_file.py         # 指定文件
+pytest -k "test_add"        # 匹配名称
+pytest -v                   # 详细输出
+pytest --cov=myapp          # 覆盖率
+pytest -x                   # 失败即停
+```
+
+## JavaScript (Jest/Vitest)
+
+```javascript
+import { describe, it, expect, vi } from 'vitest';
+
+// 基础测试
+describe('add', () => {
+  it('should add two numbers', () => {
+    expect(add(1, 2)).toBe(3);
+  });
+
+  it.each([
+    [1, 2, 3],
+    [0, 0, 0],
+    [-1, 1, 0],
+  ])('add(%i, %i) = %i', (a, b, expected) => {
+    expect(add(a, b)).toBe(expected);
+  });
+});
+
+// Mock
+vi.mock('./api', () => ({
+  getUser: vi.fn().mockResolvedValue({ id: 1, name: 'test' })
+}));
+
+it('should fetch user', async () => {
+  const user = await fetchUser(1);
+  expect(user.name).toBe('test');
+});
+
+// Spy
+const spy = vi.spyOn(console, 'log');
+doSomething();
+expect(spy).toHaveBeenCalledWith('message');
+```
+
+## Go (testing)
+
+```go
+package main
+
+import (
+    "testing"
+    "github.com/stretchr/testify/assert"
+)
+
+func TestAdd(t *testing.T) {
+    result := Add(1, 2)
+    assert.Equal(t, 3, result)
+}
+
+// 表驱动测试
+func TestAddTable(t *testing.T) {
+    tests := []struct {
+        name     string
+        a, b     int
+        expected int
+    }{
+        {"positive", 1, 2, 3},
+        {"zero", 0, 0, 0},
+        {"negative", -1, 1, 0},
+    }
+
+    for _, tt := range tests {
+        t.Run(tt.name, func(t *testing.T) {
+            assert.Equal(t, tt.expected, Add(tt.a, tt.b))
+        })
+    }
+}
+
+// Benchmark
+func BenchmarkAdd(b *testing.B) {
+    for i := 0; i < b.N; i++ {
+        Add(1, 2)
+    }
+}
+```
+
+## 测试原则
+
+```yaml
+FIRST:
+  - Fast: 快速执行
+  - Independent: 相互独立
+  - Repeatable: 可重复
+  - Self-validating: 自验证
+  - Timely: 及时编写
+
+AAA:
+  - Arrange: 准备数据
+  - Act: 执行操作
+  - Assert: 验证结果
+
+原则:
+  - 每个测试只验证一件事
+  - 测试边界条件
+  - 测试异常情况
+  - 避免测试实现细节
+```
+
+## TDD 流程
+
+```
+红 → 绿 → 重构
+
+1. 红: 写一个失败的测试
+2. 绿: 写最少代码让测试通过
+3. 重构: 优化代码，保持测试通过
+```
+
+---
+
+## 测试策略（源自 testing-strategy）
+
+### 测试金字塔比例
+
+| 层级 | 占比 | 执行时间 | 成本 |
+|------|------|----------|------|
+| 单元测试 | 70% | <1s | 低 |
+| 集成测试 | 20% | 1-10s | 中 |
+| E2E测试 | 10% | 10s-5m | 高 |
+
+### 测试左移 Checklist
+
+```yaml
+需求阶段: 可测试性评审、验收标准定义、测试用例设计
+开发阶段: TDD、单元测试同步编写、代码审查包含测试
+提交阶段: Pre-commit Hook、本地测试必过、静态分析
+CI阶段: 自动化测试、覆盖率门禁、性能基准测试
+```
+
+### 契约测试要点
+
+- 消费者驱动契约 (CDC)：Consumer 定义期望 → Provider 验证契约
+- 工具：Pact（多语言）、Spring Cloud Contract（Java）
+- 核心：Provider API <-> Contract <-> Consumer，双方独立验证
+
+### 覆盖率策略
+
+```yaml
+类型: 行覆盖率、分支覆盖率、函数覆盖率、语句覆盖率
+门禁: 全局 ≥80%，核心模块 ≥90%
+排除: tests/、migrations/、__init__.py、config 文件
+```
+
+### 变异测试
+
+- 修改源码（变异体）验证测试是否能捕获
+- 工具：Stryker (JS)、Pitest (Java)
+- 阈值：high 80% / low 60% / break 50%
+
+### 测试最佳实践
+
+- AAA 模式：Arrange → Act → Assert
+- 命名：`should [预期行为] when [条件]`
+- 单一职责：每个测试只验证一件事
+- 数据隔离：Fixture/Factory 模式，每测试独立实例
+- 并行执行：Jest `maxWorkers: '50%'`、pytest `-n auto`
+
+---
+
+## E2E 测试（源自 e2e-testing）
+
+### Playwright vs Cypress
+
+| 特性 | Playwright | Cypress |
+|------|-----------|---------|
+| 多浏览器 | Chromium/Firefox/WebKit | Chromium/Firefox/Edge |
+| 多标签页/iframe | 原生支持 | 有限 |
+| 并行执行 | 原生支持 | 需付费 |
+| 调试体验 | 一般 | 优秀 |
+
+### 选择器优先级
+
+```
+1. data-testid (推荐)
+2. role + accessible name
+3. 稳定的 class/id
+4. 文本内容 (谨慎)
+5. CSS/XPath (避免)
+```
+
+### E2E Checklist
+
+```yaml
+架构:
+  - 页面对象模式 (POM) 封装页面操作
+  - 测试独立性：通过 API 准备数据，不依赖其他测试
+  - 智能等待：waitForSelector/waitForResponse，禁止 waitForTimeout
+
+网络:
+  - Mock API：page.route() / cy.intercept() 隔离底层控制
+  - 等待响应：waitForResponse 确认数据加载
+
+可视化回归:
+  - Playwright: toHaveScreenshot() + mask 动态内容
+  - Percy/Chromatic: 云端截图对比
+
+认证:
+  - Playwright: storageState 复用登录态
+  - Cypress: cy.session() 缓存会话
+
+CI集成:
+  - retries: CI 环境 2 次重试
+  - artifacts: 失败时保存截图/视频/trace
+```
+

package/templates/skills/domains/infrastructure/SKILL.md

@@ -0,0 +1,200 @@
+---
+name: infrastructure
+description: 云原生基础设施。Kubernetes、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK。当用户提到 K8s、Helm、GitOps、IaC 时路由到此。
+license: MIT
+user-invocable: false
+disable-model-invocation: false
+---
+
+# 云原生基础设施 · Infrastructure
+
+## 域概览
+
+```
+                    GitOps 控制平面
+                          |
+        +-----------------+-----------------+
+        |                 |                 |
+    ArgoCD/Flux      Kubernetes         IaC 层
+        |                 |                 |
+   Git Repo ------> Helm/Kustomize --> Terraform/Pulumi
+        |                 |                 |
+    声明式配置        容器编排          云资源管理
+```
+
+---
+
+## Kubernetes 容器编排
+
+### Helm Chart 开发
+
+标准结构：`Chart.yaml` + `values.yaml` + `templates/` + `charts/`
+
+核心要点：
+- Chart.yaml：`apiVersion: v2`, dependencies 声明子 Chart（condition 控制启用）
+- values.yaml 设计：image / replicaCount / resources / autoscaling / service / ingress / probes / env / persistence
+- Deployment 模板：使用 `_helpers.tpl` 定义 `fullname` / `labels` / `selectorLabels`
+- 配置校验：`checksum/config: {{ include ... | sha256sum }}` 触发滚动更新
+- 安全上下文：`runAsNonRoot: true, runAsUser: 1000`
+
+关键命令：
+- `helm lint` / `helm template --debug` 验证
+- `helm install -f values-prod.yaml` 部署
+- `helm upgrade --reuse-values` 升级
+- `helm rollback <release> <revision>` 回滚
+- `helm push <chart>.tgz oci://registry` 推送 OCI
+
+### Kustomize 配置管理
+
+目录结构：`base/` + `overlays/{dev,staging,production}/`
+
+核心能力：
+- base/kustomization.yaml：resources / commonLabels / images / configMapGenerator / secretGenerator
+- overlay：namespace / patchesStrategicMerge / patchesJson6902 / replicas / images / configMapGenerator(behavior: merge)
+- 命令：`kubectl apply -k overlays/production` / `kubectl diff -k`
+
+### Operator 模式
+
+- CRD 定义：openAPIV3Schema 声明 spec/status，subresources(status/scale)
+- Controller 核心循环：Get CR → 构建期望状态 → Create/Update 子资源 → 更新 Status
+- OwnerReferences：子资源关联 CR，级联删除
+- 初始化：`operator-sdk init` → `create api` → `make manifests` → `make install`
+
+### 部署策略
+
+| 策略 | 实现方式 | 适用场景 |
+|------|----------|----------|
+| 滚动更新 | `strategy.rollingUpdate` maxSurge/maxUnavailable | 默认策略 |
+| 蓝绿部署 | 两个 Deployment + Service selector 切换 | 零停机切换 |
+| 金丝雀 | stable(9) + canary(1) 共享 Service | 渐进式验证 |
+| Flagger | `Canary` CRD + 自动分析指标 | 自动化金丝雀 |
+
+### K8s Checklist
+
+- [ ] 健康检查：livenessProbe + readinessProbe 必配
+- [ ] 资源限制：requests + limits 防止资源耗尽
+- [ ] HPA：CPU/Memory/自定义指标自动扩缩容
+- [ ] PDB：`minAvailable` 防止滚动更新中断
+- [ ] ResourceQuota + LimitRange：命名空间资源配额
+- [ ] 镜像使用 Digest 确保一致性
+- [ ] Pod 反亲和性分散到不同节点
+- [ ] 密钥外部化：External Secrets Operator
+
+---
+
+## GitOps 持续部署
+
+### ArgoCD vs Flux
+
+| 特性 | ArgoCD | Flux |
+|------|--------|------|
+| Web UI | 功能强大 | 无（可用 Weave GitOps） |
+| 多租户 | Projects + RBAC | 需额外配置 |
+| 多集群 | 原生支持 | 原生支持 |
+| 镜像自动更新 | 需 Image Updater | 原生支持 |
+| 渐进式交付 | Argo Rollouts | Flagger |
+| CNCF | Graduated | Graduated |
+
+### ArgoCD 核心模式
+
+- Application：source(repoURL/path/targetRevision) + destination(server/namespace)
+- syncPolicy：`automated(prune: true, selfHeal: true)` + retry
+- ignoreDifferences：忽略 HPA 修改的 `/spec/replicas`
+- ApplicationSet：Git 目录生成器，一套模板管理多环境
+- 多集群：`argocd cluster add` 注册集群
+- Notifications：ConfigMap 配置 Slack/Email 通知模板
+- Rollouts：`Canary` CRD + steps(setWeight/pause) + AnalysisTemplate(Prometheus 查询)
+
+### Flux 核心模式
+
+- GitRepository：`interval: 1m`, ref branch, secretRef
+- Kustomization：path + prune + healthChecks + postBuild substitute
+- HelmRepository + HelmRelease：chart + values + install/upgrade remediation
+- ImageRepository + ImagePolicy + ImageUpdateAutomation：自动检测新镜像并提交 Git
+
+### 多环境管理
+
+```
+fleet-infra/
+├── clusters/{dev,staging,production}/  # 每集群入口
+├── infrastructure/base + overlays/     # 基础组件
+└── apps/base + overlays/              # 应用配置
+```
+
+### 密钥管理
+
+- Sealed Secrets：`kubeseal` 加密 → 提交 Git → Controller 解密
+- External Secrets Operator：SecretStore(AWS SM) + ExternalSecret → 自动同步
+
+### GitOps Checklist
+
+- [ ] Git 为唯一真相源，所有变更通过 PR
+- [ ] 自动同步 + 自愈（selfHeal）
+- [ ] 密钥加密存储（Sealed Secrets / External Secrets）
+- [ ] 渐进式交付（Rollouts / Flagger）
+- [ ] 多环境目录隔离
+- [ ] 回滚策略：保留历史版本
+
+---
+
+## 基础设施即代码 (IaC)
+
+### 工具对比
+
+| 工具 | 语言 | 状态管理 | 云支持 | 学习曲线 |
+|------|------|----------|--------|----------|
+| Terraform | HCL | 显式(S3/TF Cloud) | 全平台 | 中等 |
+| Pulumi | Python/TS/Go | 自动(Pulumi Cloud) | 全平台 | 较低 |
+| AWS CDK | Python/TS | CloudFormation | AWS | 中等 |
+
+### Terraform 核心模式
+
+项目结构：`modules/{vpc,eks,rds}/` + `environments/{dev,staging,prod}/`
+
+- Provider：版本锁定 `required_providers` + `default_tags`
+- Backend：S3 + DynamoDB 锁 + KMS 加密
+- 模块化：`variable` → `resource` → `output`，环境通过 `module` 引用
+- 远程状态：`data "terraform_remote_state"` 跨模块引用
+- 命令流：`init` → `validate` → `fmt` → `plan -out=tfplan` → `apply tfplan`
+- 状态管理：`state list/show/mv/rm` / `import` 导入现有资源
+- Workspace：`workspace new/select` 多环境隔离
+
+### Pulumi 核心模式
+
+- ComponentResource：自定义资源组（VPC/EKS 封装为类）
+- Config：`pulumi.Config()` 读取 stack 配置
+- Outputs：`pulumi.export()` 导出值
+- 命令：`preview` → `up` → `stack output` / `destroy`
+
+### AWS CDK 核心模式
+
+- Stack：继承 `Stack`，使用 L2 Constructs（`ec2.Vpc` / `eks.Cluster`）
+- 跨 Stack 引用：通过构造函数参数传递
+- 命令：`synth` → `diff` → `deploy --all` / `bootstrap`
+
+### IaC Checklist
+
+- [ ] 模块化：可复用组件抽象为模块
+- [ ] 环境隔离：不同环境不同 State
+- [ ] 远程状态 + 状态锁定
+- [ ] Provider 版本锁定
+- [ ] 密钥管理：Secrets Manager / SSM
+- [ ] 统一资源标签
+- [ ] Plan 后人工审查再 Apply
+- [ ] CI/CD 集成自动化
+
+---
+
+## 最佳实践
+
+| 层级 | 工具选择 | 原则 |
+|------|----------|------|
+| 应用部署 | Helm + Kustomize | 模板化 + 环境差异 |
+| 持续交付 | ArgoCD / Flux | Git 为唯一真相源 |
+| 基础设施 | Terraform / Pulumi | 声明式 + 状态管理 |
+| 配置管理 | External Secrets | 密钥外部化 |
+| 可观测性 | Prometheus + Grafana | 指标 + 可视化 |
+
+## 触发词
+
+Kubernetes、K8s、Helm、Kustomize、Operator、CRD、GitOps、ArgoCD、Flux、IaC、Terraform、Pulumi、CDK、基础设施即代码

package/templates/skills/domains/mobile/SKILL.md

@@ -0,0 +1,224 @@
+---
+name: mobile
+description: 移动开发。iOS、Android、SwiftUI、Jetpack Compose、React Native、Flutter、跨平台。当用户提到移动开发、iOS、Android、跨平台时路由到此。
+license: MIT
+user-invocable: false
+disable-model-invocation: false
+---
+
+# 移动开发域 · Mobile Development
+
+## 域概览
+
+```
+原生开发                    跨平台开发
+├── iOS (SwiftUI/UIKit)     ├── React Native (JS/TS)
+├── Android (Compose/Kotlin) └── Flutter (Dart)
+└── 共通：MVVM / 网络层 / 持久化 / 测试
+```
+
+---
+
+## iOS 开发
+
+### SwiftUI 核心模式
+
+- View 组件：`struct MyView: View { var body: some View { ... } }`
+- State 管理：
+  - `@State` — 本地状态
+  - `@Binding` — 父子双向绑定
+  - `@StateObject` — 拥有 ObservableObject
+  - `@ObservedObject` — 引用 ObservableObject
+  - `@EnvironmentObject` / `@Environment` — 全局注入
+- ObservableObject：`@Published` 属性自动触发 UI 更新
+- Custom ViewModifier：`struct CardModifier: ViewModifier` + `extension View { func cardStyle() }`
+- 生命周期：`.task { await ... }` / `.onAppear` / `.onDisappear`
+
+### UIKit 集成
+
+- UIViewControllerRepresentable：包装 UIViewController 到 SwiftUI
+- UIViewRepresentable：包装 UIView 到 SwiftUI
+- Coordinator 模式：处理 delegate 回调
+- Auto Layout：`NSLayoutConstraint.activate([...])` + `translatesAutoresizingMaskIntoConstraints = false`
+
+### Combine 响应式
+
+- Publisher：`URLSession.shared.dataTaskPublisher` → `map` → `decode` → `eraseToAnyPublisher`
+- 订阅：`.sink(receiveCompletion:receiveValue:)` + `.store(in: &cancellables)`
+- 常用 Operators：`debounce` / `removeDuplicates` / `combineLatest` / `flatMap`
+- Subject：`PassthroughSubject`（无初始值）/ `CurrentValueSubject`（有初始值）
+
+### iOS 架构
+
+MVVM（推荐）：
+- Model：`Codable` 数据结构
+- Repository：`protocol` + `async throws` 方法
+- ViewModel：`@MainActor class VM: ObservableObject` + `@Published` 属性
+- View：`@StateObject private var viewModel = VM()`
+
+VIPER（复杂场景）：
+- View ←→ Presenter ←→ Interactor → Entity
+- Router 处理导航
+
+### 网络层
+
+- APIClient：泛型 `func get<T: Decodable>(_ path:) async throws -> T`
+- Token 管理：`request.setValue("Bearer \(token)", forHTTPHeaderField: "Authorization")`
+- 错误处理：`enum APIError: Error { case invalidURL, invalidResponse, httpError(Int) }`
+
+### 数据持久化
+
+- UserDefaults：`@propertyWrapper struct UserDefault<T>` 简化访问
+- Keychain：`SecItemAdd` / `SecItemCopyMatching` 存储敏感数据
+- Core Data：`NSPersistentContainer` + `NSManagedObjectContext`
+- SwiftData（iOS 17+）：`@Model` 宏简化持久化
+
+### iOS Checklist
+
+- [ ] SwiftUI 优先，UIKit 按需集成
+- [ ] `@MainActor` 确保 UI 线程安全
+- [ ] async/await 替代回调
+- [ ] 依赖注入提升可测试性
+- [ ] LazyVStack/LazyHStack 优化大列表
+- [ ] 图片缓存（NSCache）减少内存压力
+- [ ] Keychain 存储敏感数据（非 UserDefaults）
+- [ ] 单元测试覆盖 ViewModel + Mock Repository
+
+---
+
+## Android 开发
+
+### Jetpack Compose 核心模式
+
+- Composable：`@Composable fun MyScreen() { ... }`
+- State 管理：
+  - `remember { mutableStateOf(value) }` — 本地状态
+  - `rememberSaveable` — 跨配置变更保存
+  - `derivedStateOf` — 派生状态避免重组
+- LazyColumn：`items(list, key = { it.id })` 提供稳定 key
+- Side Effects：
+  - `LaunchedEffect(key)` — 启动协程
+  - `DisposableEffect(key)` — 清理资源（onDispose）
+  - `SideEffect` — 同步状态到外部
+  - `snapshotFlow { state }` — 监听状态变化转 Flow
+- Navigation：`NavHost` + `composable(route)` + `navController.navigate()`
+- Custom Modifier：`fun Modifier.myModifier(): Modifier = composed { ... }`
+
+### ViewModel + StateFlow
+
+- StateFlow（推荐替代 LiveData）：
+  - `MutableStateFlow(UiState())` + `.asStateFlow()`
+  - `_uiState.update { it.copy(isLoading = true) }`
+  - Compose 中：`val uiState by viewModel.uiState.collectAsState()`
+- UiState data class：封装 loading / error / data
+
+### Kotlin Coroutines & Flow
+
+- 协程：`viewModelScope.launch { withContext(Dispatchers.IO) { ... } }`
+- 并发：`coroutineScope { val a = async { ... }; val b = async { ... } }`
+- Flow：`flow { emit(value) }` + `.flowOn(Dispatchers.IO)`
+- StateFlow：`.stateIn(scope, SharingStarted.WhileSubscribed(5000), initial)`
+- 搜索防抖：`searchQuery.debounce(300).filter { it.isNotEmpty() }.flatMapLatest { ... }`
+- Channel：`Channel<Event>(BUFFERED)` + `.receiveAsFlow()` 一次性事件
+
+### 依赖注入 (Hilt)
+
+- `@HiltAndroidApp` Application + `@AndroidEntryPoint` Activity
+- `@Module @InstallIn(SingletonComponent::class)` 提供依赖
+- `@Provides @Singleton` 提供实例 / `@Binds` 绑定接口
+- ViewModel：`@HiltViewModel class VM @Inject constructor(repo)` + `hiltViewModel()`
+
+### Room 数据库
+
+- Entity：`@Entity(tableName)` + `@PrimaryKey` + `@ColumnInfo`
+- DAO：`@Query` / `@Insert(onConflict = REPLACE)` / `@Delete` + 返回 `Flow<List<T>>`
+- Database：`@Database(entities, version)` + `Room.databaseBuilder`
+
+### 网络层 (Retrofit)
+
+- ApiService：`@GET` / `@POST` / `@Path` / `@Query` / `@Body` / `@Multipart`
+- Interceptor：AuthInterceptor 注入 Bearer Token
+- OkHttpClient：`addInterceptor` + `connectTimeout`
+
+### Android Checklist
+
+- [ ] Compose 优先，View 系统按需使用
+- [ ] StateFlow 替代 LiveData
+- [ ] Hilt 依赖注入
+- [ ] Room 本地持久化
+- [ ] `key` 参数优化 LazyColumn
+- [ ] `remember` / `derivedStateOf` 避免过度重组
+- [ ] Coil 图片加载 + 缓存策略
+- [ ] 单元测试覆盖 ViewModel（runTest + advanceUntilIdle）
+
+---
+
+## 跨平台开发
+
+### React Native vs Flutter
+
+| 维度 | React Native | Flutter |
+|------|--------------|---------|
+| 语言 | TypeScript | Dart |
+| 渲染 | 原生组件(桥接) | 自绘引擎(Skia) |
+| 性能 | 接近原生 | 接近原生 |
+| 热重载 | Fast Refresh | Hot Reload |
+| 生态 | npm（成熟） | pub.dev（快速增长） |
+| UI 一致性 | 跟随系统 | 完全一致 |
+| 包体积 | ~7MB | ~15MB |
+
+### React Native 核心模式
+
+- 组件：函数组件 + Hooks（useState / useEffect / useCallback / useMemo）
+- 列表：`FlatList` + `keyExtractor` + `initialNumToRender` + `windowSize`
+- Navigation：`@react-navigation/native` + `createNativeStackNavigator`
+- 状态管理：Redux Toolkit（`createSlice` + `createAsyncThunk`）/ Zustand
+- 原生桥接：`NativeModules` 调用 iOS(Swift) / Android(Kotlin) 原生代码
+- 性能：`React.memo` / Hermes 引擎 / 新架构 JSI（无桥接序列化）
+
+### Flutter 核心模式
+
+- Widget：StatelessWidget / StatefulWidget + `setState`
+- 状态管理：
+  - Provider：`ChangeNotifier` + `Consumer` / `context.watch`
+  - Riverpod（推荐）：`FutureProvider` / `StateNotifierProvider` + `ref.watch`
+- Navigation：go_router（`GoRoute` + `context.go/push/pop`）
+- 原生桥接：`MethodChannel` + Platform Channels（iOS Swift / Android Kotlin）
+- 性能：`const` 构造函数 / `ListView.builder` / `RepaintBoundary` / `ValueKey`
+
+### 选型建议
+
+| 场景 | 推荐 | 理由 |
+|------|------|------|
+| 团队有 Web 背景 | React Native | 学习成本低 |
+| 追求极致性能/动画 | Flutter | 自绘引擎 60fps |
+| UI 高度定制 | Flutter | 完全控制渲染 |
+| 大量原生交互 | React Native | 桥接生态成熟 |
+| 需要原生极致体验 | 原生开发 | 无桥接开销 |
+
+### 跨平台 Checklist
+
+- [ ] 选型匹配团队技术栈和业务需求
+- [ ] 列表优化：FlatList(RN) / ListView.builder(Flutter) + key
+- [ ] 状态管理：Redux Toolkit(RN) / Riverpod(Flutter)
+- [ ] 原生模块桥接方案验证
+- [ ] 包体积优化：ProGuard(Android) / tree-shake-icons(Flutter)
+- [ ] 性能基线：冷启动 < 1.5s / 渲染 > 55fps
+
+---
+
+## 通用最佳实践
+
+| 实践 | 说明 |
+|------|------|
+| MVVM 架构 | 分离 UI / 业务逻辑 / 数据层 |
+| 依赖注入 | Hilt(Android) / Protocol(iOS) / Context(RN) |
+| 响应式状态 | StateFlow / Combine / Hooks / Riverpod |
+| 网络层封装 | 统一错误处理 + Token 管理 + 重试 |
+| 本地持久化 | Room / Core Data / AsyncStorage / Hive |
+| 列表优化 | 懒加载 + 稳定 key + 缓存 |
+| 测试覆盖 | ViewModel 单元测试 + UI 测试关键流程 |
+
+## 触发词
+
+iOS、SwiftUI、UIKit、Combine、Android、Jetpack Compose、Kotlin、React Native、Flutter、跨平台、移动开发、MVVM