CI-001 · Core ↔ Intelligence API / MCP 契约清单
优先级:P1 · 前置依赖 Owner:CEO(建议)
协作:ChatGPT 整理;小景核对 Core 契约;ECS 执行人回传部署与工具证据
现有 Handbook 记录了工具名和链路,但没有完整的当前 schema、权限和独立回读证据。若把接口说明当成已可用接口,外围开发可能错写核心事实或重复提交。
分解层级
- L1:跨系统合同基线;本轮只定义与核验,不实现接口。
- L2:产品提交、核心只读、内容提交、外围生成与发布四组合同。
- L3:每条合同的字段映射、权限、错误、幂等与证据。
具体解决 / 核验步骤
- 从 Handbook 第 08、12、13、14 节建立合同索引,先区分“资料记录接口”“待核验”“需求提案”;不凭工具名推断支持全部动作。
- 先核对 Product Package → validate → create_draft → PIM 人工发布合同;字段实验只引用 Product Record,避免另建平行实验结论。产品包上传接收接口如尚缺,建 Core 依赖,不在本项目实现。
- 为产品/用户/会员/订单/履约/已发布目录建立最小必要的只读需求;写明 coreId、允许字段、用途、分页、时间格式、数据时间戳与权限。只有 schema 与证据到位才标现有。
- 为内容批准后注册 CMS、媒体签发/登记、Content API 建立规划合同;本轮不做 feed、会员播放授权或小程序页面。
- 补齐 WeChat 草稿、Video health/TTS/Seedance 查询与缓存合同。公众号草稿成功、Core 目录发布、渠道正式发布是不同结果,分别回读。
- 每条合同记录 input/output schema、字段路径、认证主体、可读/可写/付费属性、版本、错误、超时与查询入口。对于 MCP 公开入口,核对实际认证与允许动作;用户/订单敏感读取不能因历史 No authentication 约定直接放开。
- 写入超时或结果不明时保留 request/task ID,先查询结果;无去重/幂等证据不自动重试。先定义测试样例,本轮不执行创建草稿、媒体上传或付费生成。
- 按责任拆分缺口:Core 业务接口给小景,Adapter 映射给外围;双向确认版本与兼容规则。
验收标准
- 四组合同逐条列明权威来源、方向、Owner、动作属性和存在性状态;未知 endpoint/schema 留空并解释。
- 每条拟作为下一轮前置条件的接口,须有当前 schema、脱敏样例与回读/错误证据;未获得证据的接口保持待核验,写明阻塞对象和补证负责人。
- 价格、会员有效性、订单及目录发布态没有外围权威副本;CRM 线索与 Core 用户关联规则明确。
- 只读可在后续采证中测试;写与付费动作仅给样例与验收计划。合同“定义完成”与“接口验证通过”分别标记。
证据清单
- E-CI001-01:带采集时间与版本的 OpenAPI / MCP tools/list schema。
- E-CI001-02:脱敏请求、响应、错误与独立回读样例;无真实执行则标未采集。
- E-CI001-03:Product Record 第 12 节映射版本/记录引用,不复制价格字段实验结论。
- E-CI001-04:Core / 外围责任确认、缺失接口依赖卡和对应 Core 需求 ID(待关联)。
依赖
- 依赖 CI-002 提供当前路由、服务与版本证据;可先用资料建立索引。
- 依赖小景确认 Core schema、可用 endpoint、权限和依赖需求编号;不得自行编造编号。
交付物:一份版本化合同矩阵 + 接口缺口与 Core 依赖表。