前言¶

接口相關的重複操作大多有現成的界面路徑：切換環境、拉個分支、跑一遍測試場景、把數據導出給別的團隊。鼠標點下來一輪也就幾分鐘，但要在 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