スペック先行は時代遅れ。スキルファーストの幕開け。

これは、ApidogがAPIテストおよびAPIライフサイクル管理のためのコマンドラインツールであるApidog CLIをどのように開発したかを共有する10部構成のシリーズです。順を追って読むか、興味のある投稿に飛んでください：

AI AgentによってAPI開発は変化しています。Skill-Firstは、仕様、テスト、シナリオを実行可能で検証可能なスキルとしてパッケージ化し、Agent時代に向けた既存のアプローチを補完します。

Spec-Firstの時代

長年、多くの開発チームのコラボレーションプロセスはSpec-Firstでした。

それが何だったか

価値

Spec-Firstは、人間主導のAPI開発にとって正しいアプローチでした。

新しいコンシューマー：AI Agent

AIコーディングが登場した後、APIアセットのコンシューマーが変化しました。

Agentもこれらのアセットを消費し始めました。

Agentが必要とするもの

この文脈において、Apidogの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がヒントに従う)
        ↓
Agent: テストを実行する (CLIが実行する)
        ↓
CLI: レポートを返す (CLIがフィードバックを提供する)
        ↓
Agent: ユーザーに要約する (Agentが完了する)

ワークフローの変換

Spec-Firstワークフロー (人間主導)

人間が仕様を設計する
        ↓
人間が文書化する
        ↓
人間がモックを作成する
        ↓
人間がデバッグする
        ↓
人間がテストを作成する
        ↓
人間が公開する

特徴：

Skill-Firstワークフロー (Agent支援)

人間が目標を指定する
        ↓
Agentが既存のアセットを読み取る
        ↓
Agentが変更を生成する
        ↓
CLIが検証する
        ↓
Agentが書き込む
        ↓
CLIが次のステップをガイドする
        ↓
Agentが検証する
        ↓
人間が結果をレビューする

特徴：

チームがすべきこと

即座のステップ

最初のAgentタスク例

Apidog CLIを使って、Apidogで最初のAPIエンドポイントを作成するのを手伝ってください。
まず、Apidog CLIのセットアップを確認し、アクセス可能なプロジェクトをリストアップしてください。
使用するプロジェクトを私に尋ねてください。私が確認した後、Health Checkという名前のシンプルなGET /health
エンドポイントを200応答の例とともに作成してください。構造化された入力を書き込む前に検証し、その後
エンドポイントを読み戻して、何が作成されたかを要約してください。

これは以下をもたらします：

開始コマンド

# Install Apidog CLI
npm install -g apidog-cli@latest

# Install companion SKILL
apidog skill install

# Check version (need 2.2.5+)
apidog -v

# Authenticate
apidog auth login

# List projects
apidog project list

未来

未来はAgent支援のAPI開発です。

シリーズ全体の要約

私たちは全行程を網羅しました：

最終原則

Spec-Firstは人間によるコラボレーションのためでした。Skill-FirstはAgentによる実行のためです。

アセットは呼び出し可能になり、ワークフローは実行可能になり、品質は検証可能になります。

Skill-Firstへようこそ。

主要なポイント

• Spec-Firstは人間主導の開発にとって正しかった
• Agentは今やAPIアセットのコンシューマーである
• アセットは読み取り可能から呼び出し可能へと変換される
• Skill-First = Spec-First + Agent実行
• システム：Apidog (アセット) → CLI (実行) → SKILL (判断) → Agent (アクション)
• 人間が目標を指定し、Agentが実行し、CLIが検証する
• 小さく始め、パターンを学び、スコープを広げる

Apidogをダウンロードして、1つのワークスペースでAPIの設計、モック、テスト、ドキュメント化を行いましょう。Apidog CLIに関する詳細は、コマンドラインAPIテスト、CI自動化、AI Agentワークフローについて学べます。