用途:根据规范 API 契约生成或刷新 API 客户端,使调用方使用类型化、经过校验的调用,与契约保持同步,不再手写请求逻辑。
输入:规范 API 契约来源;目标语言或框架;仓库配置(推荐路径 <repo>/REPO_PROFILE.json)。
输出:生成的客户端代码,或按仓库标准更新的手写客户端封装;若仓库策略允许,提交重新生成的产物。
非目标:不改变 API 行为,不编写 UI 或领域逻辑,不手动编辑生成代码。
工作流:1) 确定契约来源与生成器/工具;2) 确定性地重新生成客户端;3) 按需更新导入路径或版本锁定;4) 验证调用方能否编译/通过类型检查。
检查项:生成的客户端可编译;生成产物内无手动修改;调用方通过类型检查。
失败模式:生成器输出不稳定时,锁定版本或对输出做快照;契约无效时,阻断并返回 api/contract-update。
遥测记录:skill: api/client-generation、languages、artifacts_written、outcome。
限制:资料未提供具体生成器、支持语言清单、安装命令与收费信息。