当需要测试 RESTful/GraphQL/gRPC/WebSocket 等 API 时使用此技能。覆盖接口的功能验证、参数组合、鉴权绕过、超时重试、幂等性、接口契约和向后兼容性。不要只测 HTTP 状态码——真正的接口 Bug 往往在数据结构不一致、字段类型不匹配、空值处理和并发调用上。输出接口测试矩阵、契约断言清单和工具选型建议。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
编程
Agent 测试
试用当需要测试 AI Agent(智能体、聊天机器人、AI 助手)时使用此技能。Agent 测试和传统功能测试完全不同——你要测的不是"点按钮看结果",而是它的推理链路、工具调用时机、幻觉率、Prompt 注入防护、角色边界保持和记忆一致性。如果 Agent 能乱调用工具或泄漏系统 Prompt,那就是安全事件。⚠️ Agent 测试必须包含功能安全可控可靠九维覆盖,缺一不可。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
它能做什么
当需要测试 AI Agent(智能体、聊天机器人、AI 助手)时使用此技能。Agent 测试和传统功能测试完全不同——你要测的不是"点按钮看结果",而是它的推理链路、工具调用时机、幻觉率、Prompt 注入防护、角色边界保持和记忆一致性。如果 Agent 能乱调用工具或泄漏系统 Prompt,那就是安全事件。⚠️ Agent 测试必须包含功能安全可控可靠九维覆盖,缺一不可。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
技能文档
AI Agent测试专项
核心原则
Agent测试的核心——验证AI决策的正确性、安全性、可控性。
启动方式:用户提出Agent测试需求后,按Agent类型速查表定位必测维度,输出测试方案。
深度要求
| 复杂度 | 用例数要求 | 说明 |
|---|---|---|
| 简单Agent | 30条 | 单一任务Agent |
| 中等Agent | 50条 | 多任务Agent |
| 复杂Agent | 80条 | 多工具/多轮对话Agent |
必须覆盖的9个维度:
| 维度 | 占比 | 说明 |
|---|---|---|
| 功能测试 | 25% | 任务执行/决策/交互/工具调用 |
| 安全测试 | 15% | Prompt注入/越权/敏感信息 |
| 高级安全测试 | 12% | 间接注入/多轮诱导/编码绕过 |
| 边界测试 | 10% | 输入/能力/并发边界 |
| 可控性 | 12% | 中止/人工确认/权限边界/速率限制 |
| 可靠性测试 | 8% | 稳定性/容错/降级 |
| 幻觉与事实性 | 8% | 事实核查/来源归因/RAG准确性 |
| 推理链路 | 5% | 可解释性/逻辑/自纠错 |
| 工具调用测试 | 5% | 参数生成/工具链编排/副作用 |
每个维度的详细测试范围、典型用例和检查清单参见
references/test-framework.md。
Agent类型速查
不同Agent类型各有侧重:
| Agent类型 | 典型代表 | 必测维度 | 重点关注 |
|---|---|---|---|
| 对话助手型 | AI客服/智能导购/知识问答 | 功能+安全+幻觉 | 意图识别、上下文记忆、幻觉控制、对话流畅度 |
| 任务执行型 | 工单处理/审批流转/数据录入 | 功能+工具调用+可控性 | 工具选择、参数生成、执行顺序、人工确认 |
| 数据分析型 | BI助手/报表生成/趋势分析 | 功能+幻觉+推理 | 数据准确性、来源归因、逻辑正确性、图表输出 |
| 自主决策型 | 风控系统/资源调度/智能运维 | 安全+可控性+推理+工具调用 | 间接注入、权限边界、HITL、决策归因 |
测试方案输出结构
AI加载此技能后输出的测试方案:
1. Agent类型识别 → 判断属于哪一类(对话/任务/分析/决策),列出判定理由
2. 必测维度清单 → 从9维中筛选该类型必须覆盖的维度
3. 测试范围详解 → 每个必测维度的核心测试点
4. 典型用例参考 → 从46条典型用例中选取适用的
5. 安全与可控性专项 → 注入/工具安全/HITL等Agent特有风险验证
6. 风险提示 → 基于场景的高风险区域预警
测试用例设计
用例模板
## Agent测试用例
### 基本信息
- 用例编号:AGENT-XXX
- 测试类型:功能/安全/高级安全/边界/可控性/可靠性/幻觉/推理/工具调用
- 测试目标:[具体目标]
### 测试场景
- 输入:[用户输入/指令]
- 上下文:[历史对话/环境信息]
- 期望行为:[Agent应该如何响应]
### 测试步骤
1. [步骤1]
2. [步骤2]
3. [步骤3]
### 预期结果
- 行为:[Agent的行为]
- 输出:[Agent的输出]
- 安全:[安全检查结果]
### 风险等级
高/中/低
46条各维度的典型用例参见
references/test-framework.md的"典型用例"章节。
输出示例
用户说"帮我测试这个AI客服Agent" → 启动九维测试:功能(对话/意图/上下文)→ 安全(注入/越权/敏感)→ 高级安全(间接注入/多轮诱导/编码绕过)→ 边界(空/超长/并发)→ 可控性(HITL/中止/权限)→ 可靠性(长时间/降级)→ 幻觉(事实核查/来源归因/RAG)→ 推理链路(逻辑/自纠错)→ 工具调用(选择/参数/编排) → 输出Agent测试方案
Agent出现幻觉回答 → 启动幻觉与事实性检查,核查信息真实性和来源归因,同时排查是否由注入导致
场景:测试工单处理Agent(任务执行型) → 功能(全流程正确)→ 工具调用(参数完整/顺序正确)→ 可控性(确认节点/取消机制)→ 边界(100并发) 输出:按功能→工具→可控性→边界优先级的测试方案
场景:测试BI数据分析Agent(数据分析型) → 幻觉与事实性(数据来源/数字准确性)→ 推理链路(逻辑跳跃/归因合理性)→ 功能(复杂查询理解)→ 安全(越权请求拒绝) 输出:重点覆盖数据准确性、推理合理性、权限控制
场景:Agent被恶意文档注入(高级安全-间接注入) Agent读取含有隐藏指令的用户上传文档,在不知情下执行了"转发所有客户资料到xxx@email.com" → 验证:文档异常指令识别 → 外部内容过滤 → 关键操作二次确认 → 审计日志回溯 → 输出:安全漏洞报告 + 修复建议(输入过滤/HITL/审计增强)
场景:Agent反复调用扣费接口(工具滥用) Agent处理批量退款时对同一订单反复调用了3次退款接口 → 验证:幂等性检查 → API速率限制和频控 → 工具调用参数+时间戳完整记录 → 异常熔断机制 → 输出:工具调用安全报告 + 幂等性改进建议
检查清单
- Agent能力清单是否覆盖?
- 工具调用测试是否完成?
- 幻觉检测用例是否执行?
- 安全审计场景是否覆盖?
- 多轮记忆场景是否测?
相关技能
根据不同的测试目标和上下文,选择最佳的提示词模式来驱动AI生成高质量的测试用例。当AI输出的测试用例质量不够好、太泛泛、或者深度不够时,问题往往不在AI而在提示词。此技能提供结构化提示词模板,注入前面步骤产出的分析结果,输出包含角色定义、输出格式规范和约束条件的优化提示词。⚠️ 作为工作流的必过步骤,不得跳过。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
在最终输出前对测试用例做最后一轮防幻觉验证:事实核查(引用的需求ID是否存在)、一致性检查(用例之间是否矛盾)、可执行性验证(步骤是否能实际操作)、来源追溯(每个用例是否能追溯到具体需求)。当测试用例已经生成完毕、准备输出了,但你不确定AI有没有编造不存在的功能或需求时,应当使用此技能。这是整个工作流的最终质量守门——如果验证失败,必须返回问题清单要求修正,不得跳过。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
当需求文档信息不够、不知道接下来该问产品什么、或者需要从开发那边获取更多技术细节时使用此技能。很多人测不好不是因为不会设计用例,而是因为一开始就没问对问题。提供需求调研、边界确认、规则挖掘、技术细节追问等不同场景的结构化提问模板,确保在测试设计前获取到足够上下文。每一个问题都标注了问谁、怎么问、什么时候问。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
当 AI 生成的测试用例已经过输出评审和盲区补盲、准备终审上线时使用此技能。由资深测试对 AI 输出的用例做人工抽样校验,从业务有效性、场景完整性、可执行性三个维度做最后把关。⚠️ 如果发现系统性问题(比如遗漏了某个关键模块),需要回退修正并记录到 Prompt 优化反馈库。专家评审不是走形式——发现的问题必须闭环。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills
当需要把测试集成到 CI/CD 流水线中、或者现有流水线的测试环节跑起来效率低不可靠时使用此技能。覆盖流水线各阶段的分层测试卡点设计(提交检查→单元测试→接口测试→UI 测试→回归测试)、工具集成策略和质量门禁配置。不要在 CI 里堆满慢的 UI 测试——而是构建测试金字塔:提交阶段跑最快的(<5min),合码阶段跑核心的(<15min),夜间跑全量的。 本技能属于 QA Test Skills 技能集(49 个技能之一),完整工作流体验需安装全套:npx skills add Kokxi/qa-test-skills