القائمة
集成测试策略——测试范围界定、测试替身选择、数据准备、外部依赖治理、并发与稳定性。当跨模块协作、依赖数据库 / 消息队列 / 外部 API 时触发。 触发词：集成测试、integration test、contract test、test containers、外部依赖、数据库测试、mock vs real。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
用 citty + @clack/prompts 构建 Node.js CLI 的端到端工作流，覆盖命令路由、参数 schema、 终端交互、异步任务 UI 与 ESM 发布。触发词：citty、clack、prompts、CLI、命令行、子命令、 交互式、spinner、defineCommand、runMain、ESM 发布。
构建、扩展或调试 CodeMirror 6 浏览器代码编辑器，覆盖状态事务、扩展原语、 装饰、Compartment、语言包、补全诊断、主题、React 集成与 CM5→CM6 迁移。 触发词：CodeMirror 6、CM6、@codemirror/、EditorView、StateField、 Lezer、@uiw/react-codemirror。
使用 @pierre/diffs 与 @pierre/trees 构建代码审查、PR 视图、IDE 文件树、Merge Conflict 解决器。 覆盖 React/Vanilla API、虚拟化、Worker Pool、SSR、Shadow DOM 主题、CodeMirror 集成。 触发词：pierre、diff 渲染、文件树、PR 视图、merge conflict。
GitHub 仓库运营 + npm 包 tag 触发发布的一体化工作流。覆盖 issue/PR 分诊、CI 排障、 安全告警，以及 npm publish（provenance / scoped）+ 自动 GitHub Release（CHANGELOG 段落注入）。 触发词：github、gh、release、publish、tag、npm、provenance、changelog、triage、ci broken、版本发布。
为长跑 AI Coding 任务（Codex /goal、Claude Code、Cursor、Kiro autopilot）构建可审计、 不假完成、抗漂移的提示词。激活后先澄清需求、自动加载 AGENTS.md / 当前 spec / lessons.md， 再产出 5 段式 goal 与长跑健康守则。触发词：goal、写 goal、长任务、长跑、ralph。
使用 Mantine 组件库构建 React UI。涵盖核心组件选型、主题定制、Styles API、 布局模式、表单处理、日期选择器、图表、日程组件、通知系统、模态框管理、 Spotlight 搜索、文件上传、轮播、富文本编辑与 50+ hooks。 触发词：Mantine、UI 组件、主题配置、Styles API、DatePicker、Schedule、 Heatmap、通知、模态框、表单布局、Spotlight、Dropzone、Carousel、hooks。
| name | integration-test-strategy |
| type | testing-strategy |
| description | 集成测试策略——测试范围界定、测试替身选择、数据准备、外部依赖治理、并发与稳定性。当跨模块协作、依赖数据库 / 消息队列 / 外部 API 时触发。 触发词：集成测试、integration test、contract test、test containers、外部依赖、数据库测试、mock vs real。 |
| version | 1.0.0 |
| author | specforge |
集成测试的价值来自「真实依赖」，不是「更多断言」。 如果把依赖全 mock，就退化成慢版本的单元测试，失去跨边界正确性验证的意义。
本文讨论的「集成测试」指模块与外部组件交互的测试：
不包含端到端（E2E）测试——那是用户视角的黑盒流程验证。
┌─────────┐
│ E2E │ 5-10%
├─────────┤
│ 集成 │ 20-30%
├─────────┤
│ 单元 │ 60-70%
└─────────┘
| 场景 | 原因 |
|---|---|
| SQL 查询 / 索引 / 事务语义 | 单元 mock 无法发现 SQL 方言差异 |
| 消息队列的分区、顺序、重试语义 | broker 行为需真实环境 |
| 缓存的 TTL、序列化、并发冲突 | 需验证 Redis/Memcached 实际行为 |
| 第三方 API 的错误码、限流、鉴权 | contract test + wiremock 回放 |
| 迁移脚本对真实 schema 的影响 | 直接跑 migration |
| 场景 | 处理方式 |
|---|---|
| 纯业务规则 | 下沉到单元测试 |
| UI 交互、浏览器行为 | 上移到 E2E |
| 跨多个微服务的完整用户旅程 | 上移到 E2E 或契约测试 |
| 类型 | 说明 | 何时使用 |
|---|---|---|
| 真实依赖 | 容器化（Testcontainers）启动真实组件 | 默认选择，尤其是 DB / 消息队列 |
| Fake | 轻量等价实现（如内存数据库） | 真实依赖启动代价过高且行为可等价 |
| Stub | 返回预设响应 | 第三方 API 不可达、无沙箱环境 |
| Mock | 验证交互次数 / 参数 | 仅在需要断言「怎么调用」而非「调用什么」时 |
| Wiremock / MSW | 录制回放 HTTP 依赖 | 外部 API 集成测试 |
默认倾向：优先使用 Testcontainers 起真实的 PostgreSQL/Redis/Kafka，而不是内存替身。替身偏差带来的假阳性比测试慢一点的代价大得多。
真实世界的失败多样，集成测试必须覆盖：
工具：toxiproxy、wiremock fault injection、本地 chaos proxy。
Thread.sleep(1000)。--repeat-each 抽查。integration-test 任务与 CI stage，与单元测试区分。@IntegrationTest / -tags=integration / describe.concurrent）区别执行。pre-merge 门禁包含集成。| 能力 | Java | Python | Go | Node.js |
|---|---|---|---|---|
| 容器化依赖 | Testcontainers-Java | testcontainers-python | testcontainers-go | testcontainers |
| HTTP Mock | Wiremock / MockWebServer | responses / pytest-httpx | httptest / gock | MSW / nock |
| 契约测试 | Pact-JVM / Spring Cloud Contract | pact-python | pact-go | @pact-foundation/pact |
| 数据库迁移验证 | Flyway / Liquibase + Testcontainers | Alembic + testcontainers | golang-migrate + testcontainers | knex / Prisma migrate + testcontainers |
| 消息队列 | EmbeddedKafka / Kafka testcontainer | aiokafka + testcontainer | confluent-kafka-go + testcontainer | kafkajs + testcontainer |
| 反模式 | 问题 | 修正 |
|---|---|---|
| 所有依赖都 mock | 集成测试退化为慢速单元测试 | 关键依赖用真实或 testcontainer 版本 |
| 共享单一数据库不清理 | 测试互相污染，失败难复现 | 事务回滚或 schema 隔离 |
| 依赖网络到 staging 环境 | CI 不稳定，凭证外泄风险 | 本地容器化或契约测试 |
| 没有超时 / 失败路径测试 | 只有 happy path，生产事故频发 | 显式覆盖超时、5xx、限流等 |
用 sleep 等待异步结果 | 不稳定、慢 | 使用条件等待与超时组合 |
| 集成测试混杂在单元测试套件 | 本地跑测试慢，开发者跳过 | 分层、分标签、独立 CI stage |
sleep；异步验证使用条件等待。