接口到交付数据管线

解决什么问题

对接第三方系统时，脏数据往往出现在链路最前端：接口文档可能是随手写的 Markdown 表格、导出的 JSON Schema，甚至是一段没有结构的纯文本；同一个字段在不同环境里叫法不一，user_id、userName、用户ID 混用；default / system / task 三层配置互相覆盖；最后交付时还要人肉复制粘贴到 Excel。

@user_3ff3c268/api-data-pipeline 把这条链路拆成五个原子步骤，由总控技能编排执行。

核心能力与关键步骤

• 接口文档解析（parse-api-doc）：从杂乱文档中提取字段名、类型、必填属性，并生成初始字段映射。
• 字段对齐（field-aligner）：将中文、驼峰、下划线等不同命名风格一键归一为规范 key，避免同义字段散落多处。
• 配置合并（config-merge）：合并 default、system、task 三层配置，冲突自动修复，减少环境间的意外覆盖。
• 单位换算（unit-converter）：对规格参数做归一处理，覆盖 kg、cm、V、W 等常见单位，让交付数据可以直接被下游使用。
• 表格导出（tabular-exporter）：生成带样式的 Excel / CSV 报表，作为最终交付物。

使用时先加载总控技能，再根据当前阶段用 Skill 工具调用对应原子技能。前三步负责把数据理顺，最后一步完成交付。

适用边界与注意点

• 该闭环聚焦结构化字段型数据，不负责接口调试、网络请求或运行时验证，拿到的是文档解析结果而非真实接口响应。
• 原子技能可以独立使用，但如果跳过字段对齐直接导出，报表中可能出现同义字段并存的问题。
• 单位换算只覆盖 kg、cm、V、W 等常见规格，遇到冷门单位仍需自行扩展换算规则。
• 配置冲突修复遵循默认策略，极端场景下建议人工 review 合并后的配置再交付。