告别Spec-First，迎接Skill-First新时代

随着AI Agent的崛起，API开发的底层逻辑正在经历一次静悄悄的转向。过去的十年，我们一直在讲“Spec-First”（规范优先）——先定好契约，再去实现。这当然是对的。但现在，Agent开始加入这场协作，开发流程中间出现了一个新的变量。文章想说的是：我们正在进入一个“Skill-First”的时代。

Spec-First 时代

多年来，许多开发团队的协作流程都是 Spec-First（规范优先）。这套模式已经足够成熟，核心内容可以概括成表格里这样：

核心内容

价值所在

说到底，在人类驱动的 API 开发里，Spec-First 是正确的方法。

新的消费者：AI Agent

AI Coding 的出现带来了一个关键变化：API 资产的消费者不再只有人类。现在，Agent 也开始消费这些资产了。

Agent 需要什么

在这种背景下，Apifox 中的 API 文档、测试用例和测试场景不再仅仅是供人类阅读的协作材料——它们是 Agent 的确定性可调用资产。

资产转型

资产从“可读”转变为“可调用”。

Skill-First 的定义

在 Spec-First 的基础上构建：

新增项：

可以用一句话概括：Skill-First = Spec-First + Agent 执行层。

系统架构

每一层都有其特定的角色。

它们如何协同工作

用户: "为退款 API 生成测试并运行验证"↓Agent: 理解任务类型 (SKILL 辅助)↓Agent: 调用 CLI 读取端点 (CLI 执行)↓Agent: 生成测试用例 (Agent 创建)↓CLI: 校验结构 (cli-schema 校验)↓Agent: 写入测试用例 (CLI 执行)↓CLI: 返回 agentHints (CLI 引导)↓Agent: 回读并调整 (Agent 遵循 hints)↓Agent: 运行测试 (CLI 执行)↓CLI: 返回报告 (CLI 提供反馈)↓Agent: 向用户总结 (Agent 完成)

工作流转型

Spec-First 工作流（人类驱动）

人类设计规范↓人类编写文档↓人类创建 Mock↓人类进行调试↓人类编写测试↓人类发布

特征：

Skill-First 工作流（Agent 辅助）

人类指定目标↓Agent 读取现有资产↓Agent 生成变更↓CLI 进行校验↓Agent 写入↓CLI 引导后续步骤↓Agent 进行验证↓人类评审结果

特征：

团队应该做什么

立即采取的步骤

第一个 Agent 任务示例

使用 Apifox CLI 帮我在 Apifox 中创建我的第一个 API 端点。首先，检查我的 Apifox CLI 设置并列出我可以访问的项目。询问我要使用哪个项目。在我确认后，创建一个简单的 GET /health端点，命名为 Health Check，并包含一个 200 响应示例。在写入之前验证任何结构化输入，然后回读该端点并总结创建的内容。

这将带来：

入门命令

# 安装 Apifox CLInpm install -g apifox-cli@latest# 安装配套 SKILLapifox skill install# 检查版本 (需要 2.2.5+)apifox -v# 身份验证apifox auth login# 列出项目apifox project list

未来展望

未来是 Agent 辅助的 API 开发时代。

全系列总结

我们已经完成了整个旅程：

最终原则

Spec-First 是为了人类协作。Skill-First 是为了 Agent 执行。

资产变得可调用。工作流变得可执行。质量变得可验证。

欢迎来到 Skill-First 时代。

关键要点

• Spec-First 适用于人类驱动的开发。
• Agent 现在是 API 资产的消费者。
• 资产从可读转变为可调用。
• Skill-First = Spec-First + Agent 执行。
• 系统构成：Apifox (资产) → CLI (执行) → SKILL (判断) → Agents (行动)。
• 人类指定目标，Agent 执行，CLI 校验。
• 从小处着手，学习模式，逐步扩大范围。

下载 Apifox，在一个工作空间内完成 API 的 设计、Mock、测试 和 文档。了解更多关于用于命令行 API 测试、CI 自动化和 AI Agent 工作流的 Apifox CLI 的信息。