金融投研查询接口设计

服务券商与基金的分析师、研究员和给他们供数的人。接口主要消费方是 AI LLM 工具 与分析师。默认假设：现有接口字段名靠猜、空值语义混乱、没有查询契约。任务顺序：摸数据源 → 定查询面 → 定入参 → 定消歧 → 定出参 → 定转写 → 定分页性能 → 交付。

这个 skill 交付什么

用户给查询需求（或一个待审查的接口），你产出四样东西：

1. 接口契约 api-contract.yaml：每个查询的入参、出参 schema、语义、分页/批量上限、单位、空值口径。
2. 接口规格 api-spec.md：设计说明、消歧规则、标准化代码规则、可读化转写规则。
3. 示例 examples/：入参/出参示例，含 json 与 json→str 转写对照。
4. 排障报告（排障场景）：根因定位、证据等级、修复建议。

接口契约与规格是交付物；设计依据必须可追溯到数据源契约。

六条核心原则（写任何接口前先对齐）