前言¶

接口相关的重复操作大多有现成的界面路径：切换环境、拉个分支、跑一遍测试场景、把数据导出给别的团队。鼠标点下来一轮也就几分钟，但要在 CI 里重复、在同事之间交接时，界面操作就不可复制了。命令行的价值在于这条链路可以写成脚本、进版本库、被人审阅。

下面介绍 Apifox CLI 这个 Skill，它把 Apifox 的服务端能力拆成按需加载的命令模块，用来在命令行里完成接口设计、环境与 Mock、分支协作、用例与场景、自动化测试、导入导出以及排查问题。

这是什么¶

一句话定位：Apifox CLI 是 Apifox 的全功能命令行入口，把网页版里分散在多个页面的操作集中到一套命令里。

• Skill 名称：Apifox CLI
• 坐标：@indiv-artislong/apifox-cli
• 版本：1.0.1
• 来源：community（社区发布）
• 分类：dev-programming
• 标签：requires_api_key=true，即需要提供 Apifox 的 API Key 才能使用
• 官方地址：https://api.skillhub.cn/indiv-artislong/apifox-cli

它解决的是「界面操作无法脚本化」这个问题。涉及的接口生命周期环节，从登录与项目管理一直到问题排查，都在同一套命令体系里，不需要在界面和第三方脚本之间来回切换。

核心功能¶

官方资料列出的能力范围如下，按功能域划分：

• 登录与项目管理：账号登录、项目切换与管理。
• API 设计：接口的创建与结构维护。
• 环境与 Mock：多环境配置、Mock 服务。
• 分支协作：接口文档的分支管理与协作。
• 测试用例：单接口用例的组织与执行。
• 测试场景：多接口串起来的测试场景。
• 自动化测试与 CI：把测试接进持续集成。
• 导入与导出：数据在 Apifox 与外部格式之间流转。
• API 生命周期工作流：覆盖接口从设计到下线的流程。
• 问题排查：定位使用过程中的异常。

一个结构上的特点：命令模块按需加载。也就是说，只用到其中一两个功能域时，不必把全部模块拉进来。这样做的好处是加载更快、无关命令更少；代价是第一次使用某个功能域时会有一次额外的模块加载。

安装与启用¶

安装命令在本次抓取到的资料里没有出现，SkillHub 页面两次抓取均失败，因此这里不写未经核实的命令。可确认的入口信息如下：

坐标：@indiv-artislong/apifox-cli
版本：1.0.1
来源：community
官方地址：https://api.skillhub.cn/indiv-artislong/apifox-cli

拿到坐标后，在支持 SkillHub 的 Agent 环境里按坐标安装即可，具体参数以 SkillHub 页面和该环境的安装说明为准。

启用前需要准备的东西只有一项：Apifox 的 API Key。这是该 Skill 明确标注的前置条件，没有 Key 时后续命令都无法执行。Key 的申请入口在 Apifox 的账号设置里，拿到之后在环境里配置，具体字段名以 Skill 自身的说明为准。

Cursor、Codex CLI、Claude Code 三种环境的差异，资料里没有分别说明，这里不做区分描述。这类 Skill 基于通用 SKILL.md 格式，理论上在支持该格式的环境里用法一致，但需要以实际加载结果为准。

典型用法¶

资料里没有给出逐条命令示例，下面的用法按官方列出的能力顺序组织，说明每一类工作对应哪个功能域。

1、先做登录与项目管理。首次使用时先登录、确认当前项目。后续每次执行命令前，确认自己在正确的项目上下文里，避免把测试数据写进生产项目。

2、再做 API 设计。接口结构、字段、示例数据在这一层维护。设计与环境配置分开，接口定义本身不绑定某个具体环境。

3、配置环境与 Mock。多环境参数与 Mock 服务在这一层。环境切换是命令行场景里最容易出错的一步，建议在脚本里显式指定环境，而不是依赖默认值。

4、分支协作。需要多人同时改接口时，先切分支再改。这样主分支上的接口定义保持稳定，评审时能看清变更范围。

5、测试用例与测试场景。单接口用例验证单个接口的行为，测试场景把多个接口串起来验证整条链路。写场景时注意前置数据的准备，否则场景容易在别人机器上跑不通。

6、自动化测试与 CI。把用例和场景的执行接进持续集成，这一步是命令行相比界面的主要收益：执行过程可记录、结果可回溯、失败可重跑。

7、导入导出。需要把接口数据交给其他系统，或者从外部格式迁进 Apifox 时使用。批量操作前先在小规模数据上试一次。

8、问题排查。命令报错、结果与预期不符时，用排查类命令定位，而不是靠猜。

适用场景与注意¶

适合这几类情况：

• 要把接口测试放进 CI，需要一条可脚本化的执行链路。
• 需要在多环境之间反复切换，手动操作容易错。
• 团队用分支管理接口变更，希望命令行和界面走同一套分支模型。
• 要做接口数据的批量导入导出，界面操作不适合重复执行。

限制与坑：

• 必须有 API Key，且 Key 的权限范围决定了能做哪些操作。建议用权限受限的 Key 跑测试，不要用管理权限的 Key 跑日常脚本。
• 命令模块按需加载，首次使用某个功能域会有额外加载过程。
• 本项目为社区来源（community），不是官方仓库发布，升级与维护节奏取决于维护者。
• 官方资料没有提供完整的命令清单和参数说明，具体命令写法需要在安装后查看 Skill 自身文档确认。
• SkillHub 页面显示的评分与下载量为页面实时数值，会随时间变化，不作为长期稳定的质量指标。

结尾¶

Apifox CLI 的价值不在命令数量，而在把接口生命周期里那些原本只能靠界面点点点的操作，变成可以写进脚本、接进 CI、交给版本库管理的命令。需要覆盖的环节比较全，从设计、环境、Mock、分支到测试、导入导出和排查都有对应模块，而且按需加载，不会一次拉进全部命令。

前置条件只有一项：准备好 Apifox 的 API Key。

官方地址：https://api.skillhub.cn/indiv-artislong/apifox-cli