用途：integration-builder 是 PagoKit 的“组合算法”，负责根据所选支付服务商的目录条目解析能力片段，输出一份结构化的文件计划，实际写文件由 integration-specialist 执行。它本身不写入用户项目。
主要能力：按维度选择片段——回调认证方式对应 webhook.verification_family，商户获知支付结果的方式对应 notification_model，支付创建方式对应 checkout_spec.pattern，一次性/订阅/委托/计量对应 billing_mode 与 recurring.rails，框架、ORM、部署目标分别对应 templates/_stack-adapters、_db-adapters、_deploy-targets。integration_level 为 build 的服务商还有手写模板与 overrides 备注，且服务商专属材料优先于通用族片段。
使用方式：输入包含 provider、integration_level、stack、orm、deploy_target、billing_mode、frontend_style、required_methods、use_cases_detected、language、示例金额与币种。算法依次读取服务商完整 JSON、recipes/default.json 或用例覆盖层，检查证据门；若 webhook.evidence.confidence 非 high，则不得生成签名校验器，改为重取路径、事件 ID 去重并标注 TODO。随后按配方顺序评估 skip_if 并解析片段，叠加服务商专属材料，最后输出带 ```json 围栏的计划，含 files_to_create、commands_to_run、frontend_style_chosen、post_install_hint 与 warnings。
适用场景：需要为不同支付服务商生成可审计的集成计划，尤其是多服务商共存、订阅、非 webhook 通知模型、退款不可用等情形。
限制与注意：integration_level 为 advise 时应停止并输出研究清单与文档链接，声明 PagoKit 不会编写该集成。不得在证据门失败时生成签名校验器；payload_authoritative 为 false 时须先重取；金额按 currencies.json 的指数处理；weak_crypto 须按文档算法实现并给出警告。webhook 路由固定命名空间 /api/webhook/<provider>，需固定 SDK 版本，幂等行使用 crypto.randomUUID()，不得覆盖已有表或路由，安全相关行需带 // Rule N 标签，且必须生成 PAGOKIT_INTEGRATION.md。不得记录完整事件负载，不得将卡数据发往商户服务器。