前言¶
後端改完路由或 Controller 後，接口文檔往往要再在 Apifox 裏手工建一遍：路徑、方法、參數、請求體要對齊代碼，既慢也容易漏。常見做法是定期全量導出 OpenAPI，或在 Apifox 與倉庫之間靠腳本對賬，但「就這一段選中代碼，立刻進 Apifox」仍然缺少順手路徑。
下面介紹 SkillHub 上的 Apifox Helper（@user_3cf79a87/apifox-helper）。它在 Agent 側約定觸發條件與操作意圖，在用戶明確要求時，協助把當前選中接口或相關 Controller、路由處理邏輯導入或同步到 Apifox。
這是什麼¶
Apifox Helper 是社區來源（community）的 Agent Skill，發佈者爲 user_3cf79a87，分類爲 dev-programming，當前版本 1.0.2。官方入口：
- API 頁：https://api.skillhub.cn/user_3cf79a87/apifox-helper
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_3cf79a87/apifox-helper
Skill 在元數據中標註 requires_api_key=true，即依賴 Apifox 相關 API 密鑰（或等價憑證）才能完成上傳與同步；具體字段名與配置方式以 Skill 包內 SKILL.md 及 Apifox 開放平臺文檔爲準，本文不展開未在公開頁面列出的配置項。
官方給出的適用說明（Use when）爲：
用戶要求把當前選中的接口上傳到 Apifox、同步當前接口到 Apifox，或將某段控制器和路由處理函數導入 Apifox。
核心功能¶
結合上述說明，已覈實的能力邊界如下：
- 上傳當前選中接口：在 IDE 中選中與某一 HTTP 接口相關的代碼或定義後，由 Agent 按 Skill 指引調用 Apifox，將對應接口寫入項目。
- 同步當前接口：在代碼已變更、文檔需對齊時，對「當前上下文中的接口」執行向 Apifox 的同步，減少手工改文檔。
- 從 Controller / 路由處理函數導入：用戶給出或選中一段控制器、路由處理函數代碼時，解析並導入爲 Apifox 中的接口描述。
Skill 不負責替代 Apifox 內的協作流程（評審、環境、Mock 策略等），聚焦「代碼側 → Apifox 項目」這一條鏈路。
安裝與啓用¶
安裝流程遵循 SkillHub 通用說明：https://skillhub.cn/install/skillhub.md
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可使用官方一鍵腳本（完整安裝含默認 Skill；僅需 CLI 時加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝 Apifox Helper 到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能無法加載。
座標與命令示例：
skillhub install @user_3cf79a87/apifox-helper --dir <你的 skills 目錄>
常用路徑（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可在對話中讓 AI 按 https://skillhub.cn/install/skillhub.md 安裝 @user_3cf79a87/apifox-helper（SkillHub 頁面提供的提示詞方式）。
3、API 密鑰¶
標籤 requires_api_key=true 表示使用前需配置 Apifox API 訪問憑證。請在安裝後閱讀 Skill 目錄內的 SKILL.md，按其中要求寫入環境變量或 Agent 認可的密鑰配置位置；未配置時上傳與同步步驟無法完成。
安裝或更新 Skill 後，若 Agent 未立即識別新技能，按你所用客戶端說明重啓或刷新 skills 加載（SkillHub 文檔提示錯誤目錄時可能需要重啓）。
典型用法¶
以下用法與官方「Use when」一致，可在 Cursor 等已啓用該 Skill 的環境中復現意圖（具體解析與 API 調用由 Skill 內步驟驅動）：
- 在項目中選中某條路由註冊代碼或單個接口處理函數，對 Agent 說：「把當前選中的接口上傳到 Apifox」 或 「同步當前接口到 Apifox」。
- 選中一整段 Controller 及關聯路由處理邏輯，說明：「把這段控制器和路由處理函數導入 Apifox」。
- 改完接口簽名或參數後，再次使用「同步當前接口到 Apifox」，使 Apifox 項目與代碼一致。
執行前確認目標 Apifox 項目、環境與 API 密鑰已按 SKILL.md 配置；Agent 應彙總將要寫入的接口信息，再執行上傳或同步。
適用場景與注意¶
適合誰
- 日常在 Cursor / Claude Code / Codex 等環境寫 API，並用 Apifox 做文檔與調試的團隊或個人。
- 希望減少「改代碼 → 開 Apifox 手工建接口」重複勞動，且能接受通過 API 密鑰訪問 Apifox 的開發者。
限制與注意
- 社區 Skill，維護節奏與 Apifox 開放平臺變更需自行關注；版本以 SkillHub 爲準（當前 1.0.2）。
- 必須提供 API 密鑰；密鑰不要提交到倉庫，按 Skill 文檔使用環境變量或本地配置。
- 複雜接口（嵌套 DTO、多版本路由、非標準框架）能否一次解析準確，取決於 Skill 實現與所選代碼範圍；必要時拆成多次導入或人工在 Apifox 內補全。
- SkillHub 統計（截至頁面抓取）：評分 100000，下載 795，安裝 24；數據隨 SkillHub 更新而變化。
結尾¶
Apifox Helper 把「選中代碼 → 寫入 Apifox」收成 Agent 可觸發的固定流程，適合在編碼會話裏做接口上傳與同步。安裝座標爲 @user_3cf79a87/apifox-helper，說明與安裝指引見：
https://www.skillhub.cn/skills/user_3cf79a87/apifox-helper
