무료GitHub에 공개한국어 소개

response-compliance

로컬 또는 원격 Response API 엔드포인트에서 공식 OpenResponses 호환성 테스트를 실행합니다. 기본 응답, 스트리밍, 도구 호출, 이미지 입력, 다중 턴 대화를 확인하고 요청·응답 세부 정보로 인증이나 스키마 문제를 조사할 수 있습니다.

원문원문 설명 보기

Use for OpenResponses/Response API compliance tests, endpoint schema failures and test runs.

lobehub/lobehub스타 83,504(GitHub 83,504 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

Response API 호환성 테스트 실행
엔드포인트 스키마 불일치 조사
선택한 응답 테스트만 재실행
CI용 JSON 결과 출력

한국어 소개

할 수 있는 일

이 스킬은 로컬 또는 원격 Response API 엔드포인트에 공식 OpenResponses 호환성 테스트를 실행합니다. 일반 응답, 스트리밍 응답, 시스템 프롬프트, 도구 호출, 이미지 입력, 여러 차례 이어지는 대화를 한꺼번에 확인하거나 --filter로 테스트를 골라 실행할 수 있습니다. 상세 모드에서는 요청과 응답 내용을 볼 수 있으며, JSON 결과는 CI에서 사용할 수 있습니다. 테스트가 실패하면 인증 오류로 HTML이 반환되는 경우, LLM 실행이 구현되지 않은 경우, 응답의 필수 필드가 빠진 경우, 응답 형식이 맞지 않는 경우 등을 살펴볼 단서를 얻을 수 있습니다.

이럴 때 유용합니다

Response API를 구현한 뒤 예상한 동작을 하는지 확인할 때 사용할 수 있습니다. 특정 테스트만 다시 실행해 문제 범위를 좁힐 수도 있습니다. 엔드포인트 스키마나 인증 설정의 변경을 조사하는 개발자, CI에 호환성 테스트를 넣으려는 팀에도 유용합니다.

사용 예시

“로컬 Response API에 호환성 테스트를 실행하고 실패 내용을 자세히 보여 주세요.”
“streaming-response와 tool-calling만 테스트해 주세요.”
“CI에서 사용할 수 있도록 테스트 결과를 JSON으로 출력해 주세요.”

주의 사항

대상 서버를 실행하고 api/v1/responses 경로를 등록해야 합니다. 개발용 모의 인증을 사용한다면 .env에 ENABLE_MOCK_DEV_USER=true를 설정해야 합니다. 처음 실행할 때 공식 테스트 저장소를 가져온 뒤 해당 저장소의 CLI 테스트 실행기를 실행합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

문서 점검

AI가 SKILL.md의 내용에서 주의가 필요한 작업과 도입 전제를 확인했습니다. 점수는 실제로 실행한 결과(실행 검증)만으로 매깁니다.

안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호테스트 서버 요청과 최초 실행 시 공식 저장소를 가져오는 동작이 명시되어 있습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족서버, 경로, 모의 인증 설정은 나오지만 도구 설치 절차는 없습니다.

점수에는 넣지 않았습니다. 2026년 10월 26일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md3.9 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

OpenResponses Compliance Test

Run the official OpenResponses compliance test suite against the local (or remote) Response API endpoint.

Quick Start

# From the openapi package directory
cd packages/openapi

# Run all tests (dev mode, localhost:3010)
APP_URL=http://localhost:3010 bun run test:response-compliance -- \
  --auth-header "lobe-auth-dev-backend-api" --no-bearer --api-key 1

# Run specific tests only
APP_URL=http://localhost:3010 bun run test:response-compliance -- \
  --auth-header "lobe-auth-dev-backend-api" --no-bearer --api-key 1 \
  --filter basic-response,streaming-response

# Verbose mode (shows request/response details)
APP_URL=http://localhost:3010 bun run test:response-compliance -- \
  --auth-header "lobe-auth-dev-backend-api" --no-bearer --api-key 1 -v

# JSON output (for CI)
APP_URL=http://localhost:3010 bun run test:response-compliance -- \
  --auth-header "lobe-auth-dev-backend-api" --no-bearer --api-key 1 --json

Prerequisites

Dev server running with ENABLE_MOCK_DEV_USER=true in .env
The api/v1/responses route registered (via src/app/(backend)/api/v1/[[...route]]/route.ts)

Auth Modes

Mode	Flags
Dev (mock user)	`--auth-header "lobe-auth-dev-backend-api" --no-bearer --api-key 1`
API Key	`--api-key lb-xxxxxxxxxxxxxxxx`
Custom	`--auth-header <name> --api-key <value>`

Test IDs

Available --filter values:

ID	Description	Related Issue
`basic-response`	Simple text generation (non-streaming)	LOBE-5858
`streaming-response`	SSE streaming lifecycle + events	LOBE-5859
`system-prompt`	System role message handling	LOBE-5858
`tool-calling`	Function tool definition + call output	LOBE-5860
`image-input`	Multimodal image URL content	—
`multi-turn`	Conversation history via input items	LOBE-5861

Environment Variables

Variable	Default	Description
`APP_URL`	`http://localhost:3010`	Server base URL (auto-appends `/api/v1`)
`API_KEY`	—	API key (alternative to `--api-key` flag)

How It Works

The script (packages/openapi/scripts/compliance-test.sh) clones the official openresponses/openresponses repo into scripts/openresponses-compliance/ (gitignored) and runs its CLI test runner. First run clones; subsequent runs update from upstream.

Debugging Failures

Run with -v to see full request/response payloads
Common failure patterns:
- "Failed to parse JSON": Auth failed, server returned HTML redirect
- "Response has no output items": LLM execution not yet implemented
- "Expected number, received null": Missing required field in response schema
- "Invalid input": Zod validation on response schema — check field format

Key Files

Types: packages/openapi/src/types/responses.type.ts
Service: packages/openapi/src/services/responses.service.ts
Controller: packages/openapi/src/controllers/responses.controller.ts
Route: packages/openapi/src/routes/responses.route.ts
Test script: packages/openapi/scripts/compliance-test.sh
Cloud route: src/app/(backend)/api/v1/[[...route]]/route.ts

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

acceptance

무료요약 있음

실제 제품을 적절한 조작 환경에서 실행해 변경 사항을 검증하고, 사용자가 확인할 수 있는 증거를 모아 인수 보고서로 게시합니다. 기존 검증 계획을 확인하거나 점검 항목을 만들고, `lh` CLI로 결과를 게시할 수 있습니다.

변경된 제품 동작을 실제로 확인하기
스크린샷 등 검증 증거 수집하기
검증 계획과 보고서 작성하기