关于 enterprise-integration-api-developer
面向企业集成平台与系统互联工作的 API 开发技能，覆盖接口契约、事件驱动流程、模型映射及安全治理。适用于需要连接内部系统与外部合作方、并管理接口生命周期的团队。
主要功能
- 01设计 REST 或 GraphQL API 契约
- 02编写 OpenAPI 与 AsyncAPI 规范
- 03构建可靠的事件驱动流程
- 04定义规范模型与字段映射
- 05配置网关、认证与访问策略
- 06规划可观测性和接口生命周期
适用场景
- 01规范企业系统之间的 API 边界
- 02为异步集成设计幂等与故障处理
- 03连接合作伙伴接口并制定认证策略
- 04规划接口弃用与兼容性变更
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/enterprise-integration-api-developer确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/api_design_and_contracts.mdcanonical_models_and_transformations.mdenterprise_integration_api_scope.mdevent_driven_and_reliability.mdoperations_observability_and_lifecycle.mdsecurity_governance_and_gateways.md详细介绍
企业集成 API 开发人员
适用场景
- 设计企业集成平台——枢纽、邻接网格的服务或混合 iPaaS 模式
- 规范REST 或 GraphQL API，包括版本控制、分页、筛选和错误契约
- 编写 OpenAPI 或 AsyncAPI 规范和消费者驱动的契约测试
- 实现事件驱动流程——主题／队列、outbox、幂等消费者、补偿操作
- 定义规范模型、映射，以及有界上下文之间的防腐层
- 搭建 API 网关、B2B 合作伙伴端点、webhook，以及转换／路由规则
- 为内部和外部调用方应用 OAuth2/OIDC、API 密钥、mTLS 和作用域模型
- 规划可观测性——关联 ID、跟踪传播、结构化错误、DLQ 操作
- 管理生命周期——弃用标头、日落策略、向后兼容的架构演进
不适用场景
- X12/EDIFACT 段映射、997/APERAK、AS2/VAN EDI 传输 →
edi-engineer - 仅处理涉密隔离环境构建、ATO 证据、通过审查的流水线晋级 →
classified-software-devsecops-engineer - VRP、MIP、调度或基于求解器的优化 →
operations-research-algorithm-developer - 没有集成架构的通用应用 CRUD、UI 或单服务功能 →
senior-software-engineer - 仅处理 CI/CD 流水线 YAML、GitOps 和部署机制 →
devops - Landing Zone、VPC 和托管云资源设计 →
cloud-engineer - 企业级云参考架构和迁移路线图 →
cloud-architect - 内部开发者平台的黄金路径和门户 →
platform-engineer
相关技能
| 需求 | 技能 |
|---|---|
| EDI 标准、段、合作伙伴认证 | edi-engineer |
| 应用服务和代码质量 | senior-software-engineer |
| CI/CD、GitOps、集成服务部署 | devops |
| 集成所需的云消息、网络、IAM | cloud-engineer |
| 云参考架构和 Landing Zone | cloud-architect |
| IDP、黄金路径、标准化模板 | platform-engineer |
| 涉密 DevSecOps 和晋级边界 | classified-software-devsecops-engineer |
| OR 模型、路径规划、分配求解器 | operations-research-algorithm-developer |
| 企业架构 ADR 和跨系统评审 | senior-system-architecture |
| 流水线安全和供应链 | devsecops |
核心工作流
1. 界定范围和集成边界
定义权威数据源系统、同步与异步边界、合作伙伴与内部接口，以及非目标。
参见 references/enterprise_integration_api_scope.md。
2. API 设计和契约
对资源、错误和版本控制建模，并发布 OpenAPI/AsyncAPI 规范及契约测试。
参见 references/api_design_and_contracts.md。
3. 事件驱动可靠性
选择消息模式、幂等键、outbox、saga／编排模式和故障处理方式。
参见 references/event_driven_and_reliability.md。
4. 规范模型和转换
定义规范架构、ACL、映射规则，以及入口／出口验证。
参见 references/canonical_models_and_transformations.md。
5. 安全、网关和治理
配置网关、身份验证、速率限制、合作伙伴接入和策略执行。
参见 references/security_governance_and_gateways.md。
6. 运维、可观测性和生命周期
为跟踪和指标添加监测，运维 DLQ，并执行弃用和兼容性计划。
参见 references/operations_observability_and_lifecycle.md。
输出
- 集成上下文图 — 系统、通道、同步／异步、信任区域
- 契约制品 — OpenAPI/AsyncAPI、JSON Schema、示例载荷、错误目录
- 映射规范 — 规范字段、转换、验证规则、幂等策略
- 运行手册 — 重放、DLQ 清理、合作伙伴切换、回滚、兼容性矩阵
- ADR 或决策日志 — 编排与协同、版本控制、身份验证模型
原则
- 优先采用契约和架构，而非口口相传的知识；在 CI 中测试消费者
- 在每个外部边界明确幂等性和去重
- 将合作伙伴（B2B）接口与内部网格流量分开——采用不同的身份验证、SLO 和变更窗口
- 设计可观测的故障——端到端关联 ID、结构化错误、可执行操作的 DLQ
- 发布向后兼容的变更；记录弃用时间，并给消费者留出迁移时间
评论
支持 Markdown