apifox-import-export
Installation
SKILL.md
导入导出与质量门禁
前置条件:先阅读
../apifox-cli/SKILL.md。若旧总入口与本 skill 的领域规则冲突,以当前 CLI help 和本 skill 为准。
具体命令参数以当前 CLI help 为准。导入前重点检查文件格式、OpenAPI 质量门禁、路由骨架风险、tags 分组、原生格式模块策略、ignoreCount 和是否需要干净项目验证。Agent 导入后必须按 agentHints、list/get 和必要的 run/report 做结果确认,不要只依据导入命令返回成功判断完成。
何时使用
- 从代码库、PRD、需求文档、测试文档、讨论记录生成 API spec 并导入 Apifox。
- 导入 OpenAPI、Postman、HAR、Apifox 原生格式等项目数据。
- 配置自动导入。
- 导出 OpenAPI、Markdown、HTML、Postman 或 Apifox 原生格式。
- 需要判断生成的 spec 是否只是“路由骨架”。
- 迁移、备份或复制 Apifox 项目,尤其是需要控制模块复用或新建时。
不应使用
- 把已有 endpoint、test-case 或 test-scenario step 导入/复制到测试场景:转
apifox-test-scenario,使用test-scenario import-steps或test-scenario add-ref。 - 精细维护测试场景步骤、变量、断言或处理器:转
apifox-test-scenario。