前言¶
后端改完路由或 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
