AgentScope Agent Test Harness

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install agentscope-agent-test-harness
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 agentscope-agent-test-harness。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AgentScope Agent Test Harness 可帮助开发者在将现有 AgentScope agent 连接到实时模型之前对其进行验证。它会生成一个轻量级测试文件，使用预设响应替换真实模型，并默认在不发起外部 API 调用的情况下检查 agent 的行为。
使用此 Openclaw Skills 工具，可在开发早期发现 agent 连接配置、工具绑定、消息格式和状态转换方面的问题。测试结果将以 Markdown 格式报告为通过或失败。

应用场景

在部署前验证 AgentScope agent 的工具绑定。
检查提示词和消息格式，避免产生实时模型调用费用。
使用预设模型响应测试预期的 agent 状态转换。
在开发或排查 agent 模块问题时运行离线断言。
为现有 Python agent 生成可重复运行的 pytest 测试框架。

工作原理

将测试框架生成器指向现有的 AgentScope agent 模块。
在指定的输出路径生成测试框架文件。
默认情况下，测试框架使用返回预设响应的模拟模型，而不是调用实时模型。
使用 pytest 运行生成的测试文件。
查看以 Markdown 格式报告的通过／失败结果，其中包含针对工具调用、消息格式和 agent 状态转换的断言。

配置指南

要求：Python 3 和 pytest。该技能的元数据将 OPENAI_API_KEY 列为使用 OpenAI 或兼容 API 所需的环境变量；离线测试为默认模式，除非 agent 明确使用真实模型，否则不会发起实时调用。该技能说明，AGENTSCOPE_TEST_MODE 是一个可选环境变量，可用于跳过实时模型调用并仅运行离线断言。
从技能文件夹运行生成器，并将示例路径替换为你的 agent 模块路径和所需的输出位置：
python3 scripts/generate_harness.py --agent /path/to/agent_module.py --output /path/to/test_harness.py
运行生成的测试：
python3 -m pytest /path/to/test_harness.py
AgentScope Agent Test Harness 数据架构与分类体系
该技能根据现有 agent 模块生成 Python 测试框架。输入和输出位置通过命令行参数指定；该技能未规定固定的目录布局或其他数据格式。
项目 用途
Agent 模块 使用 --agent 指定的现有 Python agent
测试框架 使用 --output 指定的生成式 Python 测试文件
测试结果 以 Markdown 格式报告的 pytest 通过／失败输出
断言 检查工具调用、消息格式和 agent 状态转换
模型响应 用于离线测试的模拟模型预设响应

高级特性

默认使用模拟模型响应测试 agent 行为，无需外部 API 调用。
在同一个测试框架中验证工具调用、消息格式和 agent 状态转换。
AGENTSCOPE_TEST_MODE
，以请求运行离线断言并跳过实时模型调用。
将生成的测试文件集成到 pytest 工作流中。
除非 agent 明确使用真实模型，否则不会发起实时模型调用。

name: agentscope-agent-test-harness description: Create and run lightweight tests for AgentScope agents without hitting external APIs. Use this whenever the user wants to validate agent wiring, tool binding, or prompt formatting before live model calls. version: 0.1.0