用途:该技能用于在 Apidog 中端到端交付 API 资产,从需求出发完成 API 设计、Schema、环境、Mock、测试用例、文档导出与发布,以及分支合并准备。适用于根据需求创建或更新一组 API、导入 OpenAPI/Postman 后整理资源、从代码或 PRD 生成并导入 API 规范、为 API 添加 Mock 与测试用例、在 AI 分支上完成变更并准备合并等场景。
主要能力与顺序:先确认项目/分支,若从代码或文档导入则生成规范并运行质量门禁;随后设计 endpoint 与 schema,配置环境与变量,配置 Mock,创建 API 测试用例,运行测试并检查报告,最后导出/发布文档、合并或创建 MR。
使用要点:开始前阅读 ../apidog-cli/SKILL.md,并视需要阅读 apidog-branch、apidog-import-export、apidog-test-case;复杂测试流程读 apidog-test-scenario,执行与 CI 读 apidog-test-automation。应以 help/schema -> get -> validate -> write -> run/report 的循环工作,而不是凭旧文档或记忆编写。
关键规则:不得跳过项目/分支确认;不得直接写入受保护的 main 分支;不得在未验证保存结构时创建 endpoint;不得创建空壳测试用例;测试失败不等于 API 创建失败,需分别诊断 API 定义、环境、测试用例与执行报告。区分 endpoint 与 test-case,可复用资源应先创建再被引用,环境变量不写入公共参数。测试运行与 CI 交付应显式传入 --environment。报告问题先区分本地报告、云端上传与下载摘要,客户端显示问题改用 apidog-cli-checkup,合并需求改用 apidog-branch。