技能介绍

要解决的问题

在 DHG 平台里，一次接口集成往往不只是写一个 HTTP 调用。开发者需要同时处理请求方式、认证、字段映射、回调标识、定时触发、SSO 跳转，以及最终可导入的 JSON 结构。如果全靠手工拼接，很容易出现 sendType 与 sendMode 不匹配、blockSendId 指向错误、共享 token 依赖缺失，或者把第三方字段直接拼进 SQL 的风险。

技能如何工作

这个技能把集成拆成明确的路由：先识别是普通出站接口、人员/组织同步、工作流 OA 推送、定时执行、表单触发、SSO、HTTP 代码块执行，还是已有配置排查。接着按场景读取 references/ 下的规范，先解析用户提供的 API 或 SSO 文档，再生成声明式参数和映射。

简单查询参数用 HTTP URL参数（sendType=22） + GET（sendMode=1）；声明式 JSON 用 HTTP JSON发送（sendType=21） + POST（sendMode=2）；签名、加密、XML/multipart、嵌套过深或多次调用才用 代码块发送（sendType=30）。
只有签名、转换、SQL、token 组装、自定义发送、回调、过滤或调度需要时，才追加 Groovy，并生成 发送代码块（type=14） 且让 blockSendId 指向它。
人员/组织/公司/岗位同步会产出按 businessType 区分的参数和映射；工作流待办与已办 OA 推送则按事件分别生成配置，业务类型 5/6/7/8/10/20 走 flow_wfitem。
定时执行被拆成普通 worker 接口加独立 定时代码块（type=22），按分页查询范围逐行调用，避免一次拖全表。

适用边界与注意点

不需要 DHG MCP 也能完成文档分析、架构方案、静态 JSON/Groovy 草稿、已有产物评审。但真实工作区字段检查、配置 ID 分配、SQL/Groovy 执行、导入保存、接口执行和日志读取，必须在 MCP 可用后进行；离线草稿要明确标注占位 ID、未验证映射、未测 Groovy 和不可用的运行结果。

默认不查询现有 DHG 配置，只有用户要求复用、对比、排查或修复时才做有限查找。回调写入前要校验响应结构和业务标识，更新走带范围和参数的 API，不要把第三方值直接拼进 SQL。导入前的 ID 必须通过 MCP 分配并按字符串保留；执行前还要求非空 resourceMap、idempotencyKey、明确确认和测试/沙箱目标。日常生成阶段不会运行 executeInterfaceByCode，dryRun=true 也只证明接口代码存在，不证明业务成功。