跳到正文
cccskills
免费在 GitHub 公开中文介绍

response-compliance

对本地或远程 Response API 运行官方 OpenResponses 兼容性测试,检查普通响应、流式输出、工具调用、图像输入和多轮对话,并据请求与响应详情排查认证或结构问题。

原文查看原文说明

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

lobehub/lobehub星标 83,510(GitHub 83,510 + 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 测试运行器。

本介绍由 AI(OpenAI Codex)根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

文档检查

AI 根据 SKILL.md 的内容检查了需要注意的操作和使用前提。评分只依据实际运行的结果(实测对比)。

安全性发送数据、删除文件、执行命令等是否有说明
A良好资料说明会向测试服务器发送请求,并在首次运行时获取官方仓库。
安装难易度所需工具和 API 密钥是否少且有说明
B部分不足列出了服务器、路由和模拟认证设置,但未说明工具安装步骤。

不计入评分。 由 AI(OpenAI Codex)于 2026年10月26日 评估。仅供参考,安装前请同时查看原文。

如果您认为评估有误,请申请复核

请写明哪一项有误以及原因。无需登录。我们会对照 SKILL.md 重新评估,并在此处更新结果。

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

包含的文件(1)

  • SKILL.md3.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

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

ModeFlags
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:

IDDescriptionRelated Issue
basic-responseSimple text generation (non-streaming)LOBE-5858
streaming-responseSSE streaming lifecycle + eventsLOBE-5859
system-promptSystem role message handlingLOBE-5858
tool-callingFunction tool definition + call outputLOBE-5860
image-inputMultimodal image URL content—
multi-turnConversation history via input itemsLOBE-5861

Environment Variables

VariableDefaultDescription
APP_URLhttp://localhost:3010Server 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

  1. Run with -v to see full request/response payloads
  2. 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

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

acceptance

免费有简介

通过实际操作产品验证交付内容,记录用户可查看的证据,并发布验收报告。可检查已有验证计划或创建检查项,选择合适的操作界面,并使用 `lh` CLI 发布结果。

  • 实际检查更改后的产品行为
  • 收集截图或其他验证证据
  • 编写验证计划和报告
lobehub/lobehub8.4万2026年10月26日 更新

add-model-provider

免费有简介

本技能指导在 LobeHub 中接入 AI 模型提供商,涵盖运行时、模型信息、设置、品牌展示、文档和验收,并帮助判断新增模型是否需要新的提供商集成。

  • 为 LobeHub 接入新的 AI 模型提供商
  • 更新提供商设置说明或介绍
  • 判断添加模型是否需要新的提供商集成
lobehub/lobehub8.4万2026年10月26日 更新

add-setting-env

免费有简介

本技能指导如何用服务器端环境变量设置用户偏好默认值,涵盖变量校验、服务器配置、写入用户状态,以及更新 `.env.example` 和自托管文档。

  • 通过环境变量设置用户偏好默认值
  • 将设置接入服务器配置和用户状态
  • 更新环境变量示例及文档
lobehub/lobehub8.4万2026年10月26日 更新

agent-runtime-hooks

免费有简介

说明如何在智能体执行步骤、工具调用、人工审批、上下文压缩和子智能体调用时注册钩子。钩子可观察事件、模拟本地工具结果,也可通过 Webhook 按配置策略允许或拒绝工具调用。

  • 记录智能体步骤和错误
  • 测试时模拟工具结果
  • 通过 Webhook 允许或拒绝工具调用
lobehub/lobehub8.4万2026年10月26日 更新

agent-signal

免费有简介

此技能用于为智能体设计事件驱动的后台工作流,划分来源、信号、动作和策略的职责,并处理异步交接、去重、执行范围、完成记录与运行观测。

  • 添加事件触发的后台任务
  • 将工作移出对话请求
  • 防止动作重复执行
lobehub/lobehub8.4万2026年10月26日 更新

agent-testing-bot

免费有简介

本技能在 macOS 桌面聊天应用中测试机器人频道:打开应用、进入频道或联系人、发送消息、等待回复并截图。支持 Discord、Slack、Telegram、微信、飞书和 QQ;iMessage 使用 BlueBubbles 桥接。

  • 检查真实 Discord 频道中的机器人回复
  • 测试 Slack 或 Telegram 的对话流程
  • 记录 macOS 应用中的操作结果
lobehub/lobehub8.4万2026年10月26日 更新

查看 lobehub 的全部技能

报告此技能的问题