用途:在文档流水线的第 8 层,将 REQ(第 7 层)中的接口规格与数据模式自动转换为 CTR(数据契约)文档,作为下游 SPEC、TSPEC、TASKS 的输入。
主要能力:Phase 0 读取 REQ 文档并依据章节中的 REST/SSE/Webhook/A2A 等外部接口特征,判断各模块是否需要 CTR,输出需求矩阵并请求确认;Phase 1 从需要的 REQ 中抽取接口规范、数据模式与错误处理;Phase 2 检查 REQ 是否达到 SPEC-Ready 与 CTR-Ready 分值要求;Phase 3 生成 CTR-NN.md 与 CTR-NN.yaml 双文件,并加 7 类累积溯源标签;Phase 4 用 doc-ctr-validator 校验 OpenAPI 与 SPEC-Ready 分值;Phase 5 进入 doc-ctr-reviewer 与 doc-ctr-fixer 的评审修复循环,直到分值达标或触发人工复核。
使用方式:支持 --ref <path>、--prompt "<text>"、--iplan <path|IPLAN-NNN> 三种输入模式,优先级为 --iplan > --ref > --prompt。可直接输入 CTR-NN 进入评审模式,或输入 REQ-NN 在缺失时生成对应 CTR。文件统一放在 docs/08_CTR/CTR-NN_{slug}/ 嵌套目录。
限制:仅处理带外部 API 或对外契约的模块,纯内部协议、仅 /metrics、前端消费方等不生成 CTR;目标分值与最大迭代次数等默认值来自资料,未提供价格、平台与具体安装方式。