스펙은 어제 이야기, 이젠 실력 우선 시대!

이것은 API 테스트 및 API 라이프사이클 관리를 위한 명령줄 도구인 Apidog CLI를 Apidog가 어떻게 개발했는지 공유하는 10부작 시리즈입니다. 순서대로 읽거나 관심 있는 게시물로 이동하세요:

AI 에이전트와 함께 API 개발이 변화하고 있습니다. Skill-First는 스펙, 테스트, 시나리오를 실행 가능하고 검증 가능한 스킬로 패키징하여 에이전트 시대의 기존 접근 방식을 보완합니다.

Spec-First 시대

수년 동안 많은 개발 팀의 협업 프로세스는 Spec-First였습니다.

무엇이었는가

가치

Spec-First는 인간 중심의 API 개발에 적합한 접근 방식이었습니다.

새로운 소비자: AI 에이전트

AI 코딩이 등장한 후, API 자산의 소비자가 바뀌었습니다.

에이전트 또한 이러한 자산을 소비하기 시작했습니다.

에이전트가 필요로 하는 것

이러한 맥락에서 Apidog의 API 문서, 테스트 케이스, 테스트 시나리오는 단순히 인간을 위한 협업 자료가 아닙니다.

이들은 에이전트가 결정적으로 호출할 수 있는 자산입니다.

자산 변환

자산은 "읽기 가능"에서 "호출 가능"으로 변환됩니다.

Skill-First 정의

Spec-First를 기반으로:

더하기:

Skill-First = Spec-First + 에이전트 실행 계층.

시스템 아키텍처

각 계층은 특정 역할을 가집니다.

함께 작동하는 방식

사용자: "환불 API에 대한 테스트를 생성하고 검증을 실행하세요"
        ↓
에이전트: 작업 유형을 이해합니다 (SKILL이 도움)
        ↓
에이전트: CLI를 호출하여 엔드포인트를 읽습니다 (CLI 실행)
        ↓
에이전트: 테스트 케이스를 생성합니다 (에이전트 생성)
        ↓
CLI: 구조를 검증합니다 (cli-schema가 유효성 검사)
        ↓
에이전트: 테스트 케이스를 작성합니다 (CLI 실행)
        ↓
CLI: agentHints를 반환합니다 (CLI 안내)
        ↓
에이전트: 다시 읽고 조정합니다 (에이전트가 힌트를 따름)
        ↓
에이전트: 테스트를 실행합니다 (CLI 실행)
        ↓
CLI: 보고서를 반환합니다 (CLI 피드백 제공)
        ↓
에이전트: 사용자에게 요약합니다 (에이전트 완료)

워크플로 변환

Spec-First 워크플로 (인간 중심)

인간이 스펙을 설계
        ↓
인간이 문서화
        ↓
인간이 모의를 생성
        ↓
인간이 디버그
        ↓
인간이 테스트를 작성
        ↓
인간이 게시

특징:

Skill-First 워크플로 (에이전트 지원)

인간이 목표를 지정
        ↓
에이전트가 기존 자산을 읽음
        ↓
에이전트가 변경 사항을 생성
        ↓
CLI가 유효성 검사
        ↓
에이전트가 작성
        ↓
CLI가 다음 단계를 안내
        ↓
에이전트가 검증
        ↓
인간이 결과를 검토

특징:

팀이 해야 할 일

즉각적인 단계

첫 번째 에이전트 작업 예시

Apidog CLI를 사용하여 Apidog에서 첫 번째 API 엔드포인트를 생성하는 것을 도와주세요.
먼저, Apidog CLI 설정을 확인하고 액세스할 수 있는 프로젝트를 나열해 주세요.
어떤 프로젝트를 사용할지 물어봐 주세요. 제가 확인한 후, 200 응답 예시를 포함하는 Health Check라는 이름의 간단한 GET /health 엔드포인트를 생성해 주세요.
작성하기 전에 모든 구조화된 입력을 검증한 다음, 엔드포인트를 다시 읽고 생성된 내용을 요약해 주세요.

이는 다음을 제공합니다:

시작하기 명령

# Apidog CLI 설치
npm install -g apidog-cli@latest

# SKILL 컴패니언 설치
apidog skill install

# 버전 확인 (2.2.5+ 필요)
apidog -v

# 인증
apidog auth login

# 프로젝트 목록
apidog project list

미래

미래는 에이전트 지원 API 개발입니다.

전체 시리즈 요약

우리는 전체 여정을 다루었습니다:

최종 원칙

Spec-First는 인간 협업을 위한 것이었습니다. Skill-First는 에이전트 실행을 위한 것입니다.

자산은 호출 가능해집니다. 워크플로는 실행 가능해집니다. 품질은 검증 가능해집니다.

Skill-First에 오신 것을 환영합니다.

주요 요점

• Spec-First는 인간 중심 개발에 적합했습니다.
• 이제 에이전트가 API 자산의 소비자입니다.
• 자산은 읽기 가능에서 호출 가능으로 변환됩니다.
• Skill-First = Spec-First + 에이전트 실행
• 시스템: Apidog (자산) → CLI (실행) → SKILL (판단) → 에이전트 (작업)
• 인간은 목표를 지정하고, 에이전트가 실행하며, CLI가 유효성을 검사합니다.
• 작게 시작하고, 패턴을 학습하고, 범위를 확장하세요.

Apidog를 다운로드하여 설계, 모의, 테스트 및 문서화하세요. 명령줄 API 테스트, CI 자동화 및 AI 에이전트 워크플로를 위한 Apidog CLI에 대해 자세히 알아보세요.