360 Secure SkillHub
360 安全技能中心

Agent Requirement Analyzer

针对 AI 智能体平台的需求文档、PRD 或用户故事,按智能体创建与配置、发布与版本管理、调用与对话、监控运维四个模块提取功能点、交互场景和边界异常,重点识别需求中缺失、不明确、矛盾及待决策的待确认项,最终产出结构化需求分析报告并可写入飞书知识库。

luiciferyi
luiciferyi
热度 36.23
最近更新 2026-05-11 17:42:41
分类:数据依赖:读写文件 / MCP 服务 / 第三方 API应用场景:研究 / 报告撰写

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add agent-requirement-analyzer
Metadata
name
agent-requirement-analyzer
description
分析 AI 智能体平台的需求文档,提取测试需求、功能点、交互场景、边界条件。专注智能体创建、配置、发布、调用全生命周期。 Use when: 用户说"分析需求"、"需求解析"、"智能体需求分析"、"PRD 分析"。 NOT for: 生成测试用例(用 agent-testcase-generator)、生成测试方案(用 agent-testplan-generator)。
allowed-tools
["read","write","feishu_create_doc","feishu_update_doc","feishu_fetch_doc","message"]

Agent Requirement Analyzer

飞书文档写入位置

知识库: 7616288931050507220
节点: 效果评测/需求分析报告
wiki_node: Eq5MwsZEpiKlP7kXzPFc8Uptnye

核心功能

分析 AI 智能体平台的需求文档,提取测试需求、功能点、交互场景、边界条件,并识别需求中的待确认项(不明确、缺失、矛盾的地方)。

When to Run

  • 用户提供智能体平台的需求文档、PRD、用户故事
  • 涉及智能体创建、配置、发布、对话测试等功能
  • 用户要求"分析测试需求"或"提取测试点"
  • 需要识别需求中的待确认项和缺失信息

Workflow

  1. 解析需求文档,识别智能体平台的核心功能模块
  2. 按智能体生命周期提取测试需求
  3. 识别需求中的待确认项(不明确、缺失、矛盾的地方)
  4. 输出结构化需求分析报告(含待确认项清单)

待确认项识别指南

在分析需求时,重点关注以下类型的待确认项:

1. 缺失的关键信息

  • 未明确的数值限制(长度、大小、数量等)
  • 未定义的枚举值(状态、类型、选项等)
  • 未说明的异常处理逻辑
  • 未提及的权限控制规则

2. 不明确的描述

  • 模糊的形容词("大量"、"快速"、"及时"等)
  • 未量化的性能指标
  • 未定义的业务规则
  • 未说明的默认值

3. 矛盾的需求

  • 不同章节描述不一致
  • 功能与性能要求冲突
  • 用户体验与技术实现矛盾

4. 待决策事项

  • 需要产品方确认的功能范围
  • 需要业务方确认的规则逻辑
  • 需要技术方确认的实现方案

核心功能模块识别

模块 1:智能体创建与配置

子功能 需求描述 测试关注点
基本信息配置 名称、描述、头像设置 必填校验、字符限制、特殊字符、重复名称
角色设定 系统提示词、角色定义 长度限制、格式校验、多语言支持
模型选择 基础模型、嵌入模型选择 模型列表展示、默认值、切换生效
知识库绑定 上传文档、选择知识库 文件格式、大小限制、绑定/解绑
工具配置 插件、Skills 启用 工具列表、启用/禁用、参数配置

模块 2:智能体发布与版本管理

子功能 需求描述 测试关注点
版本发布 创建版本、版本号管理 版本号格式、自动递增、发布前校验
版本回滚 回滚到历史版本 回滚后配置恢复、运行状态验证
版本对比 对比不同版本差异 差异展示、字段对比
发布审核 审核流程(如有) 提交审核、审核通过/驳回、通知

模块 3:智能体调用与对话

子功能 需求描述 测试关注点
对话接口 API 调用、流式/非流式 请求格式、认证鉴权、超时处理
对话测试 Web 端对话测试窗 消息发送、回复展示、多轮对话
上下文管理 对话历史、记忆长度 上下文截断、记忆持久化
多模态输入 图片、文件上传 格式支持、大小限制、内容识别

模块 4:智能体监控与运维

子功能 需求描述 测试关注点
调用统计 调用次数、Token 消耗 数据准确性、实时性、图表展示
日志查询 调用日志、错误日志 日志完整性、检索功能、导出
告警配置 异常告警、阈值设置 告警触发、通知方式、恢复通知

智能体类型识别

根据需求识别智能体类型,不同类型有不同测试重点:

智能体类型 特点 测试重点
对话助手 通用问答、聊天陪伴 多轮对话、意图识别、回复质量
任务执行型 调用工具、执行动作 工具调用准确性、参数解析、异常处理
知识问答型 基于知识库回答 知识检索准确性、引用来源、未知回答
代码生成型 生成代码、调试 代码质量、语言支持、执行安全

输出格式

需求分析报告

1. 项目概述

  • 平台名称:{platform_name}
  • 版本:{version}
  • 核心能力:{core_capabilities}

2. 功能模块清单

模块 优先级 功能点数量 预估测试工作量
智能体创建与配置 P0 {count} {days}人天
版本发布管理 P0 {count} {days}人天
对话调用 P0 {count} {days}人天
监控运维 P1 {count} {days}人天

3. 需求点详细拆解

{按模块逐一列出需求点及测试关注点}

4. 交互场景分析

场景 触发条件 涉及模块 数据流转 测试要点
创建智能体 用户填写配置并保存 创建配置 前端→后端→数据库 各字段校验、保存成功、列表展示
发布智能体 点击发布按钮 版本管理 生成版本→更新状态 版本号生成、状态变更、调用生效
对话调用 API 请求 调用接口 请求→模型调用→返回 响应格式、流式输出、错误处理

5. 边界条件与异常场景

功能 边界条件 异常场景
名称字段 长度 1-50 字符 空值、超长、特殊字符、emoji、重复
角色设定 长度 0-10000 字符 超长、格式错误、注入攻击
知识库上传 单文件≤10MB 格式不支持、空文件、超大文件、并发上传
对话调用 Token≤4096 超长上下文、并发请求、超时

6. 待确认项清单(关键!)

待确认项是指需求文档中不明确、缺失、矛盾或需要进一步澄清的地方。

序号 待确认项 所属模块 问题描述 建议确认内容 优先级
1 角色设定长度限制 智能体创建 需求未明确角色设定最大长度 确认最大字符数(如10000字符) P0
2 知识库文件格式 知识库绑定 需求未列出支持的文件格式 确认支持格式(PDF/DOCX/TXT等) P0
3 版本号规则 版本发布 需求未说明版本号生成规则 确认版本号格式(如v1.0.0) P0
4 对话超时时间 对话调用 需求未明确API超时时间 确认超时阈值(如30秒) P0
5 并发用户限制 性能需求 需求未说明最大并发数 确认并发上限(如100用户) P1
6 数据保留期限 监控运维 需求未说明日志保留时间 确认保留期限(如30天) P1

待确认项分类:

  • 🔴 缺失信息:需求中完全未提及的关键信息
  • 🟡 不明确:描述模糊,存在多种理解可能
  • 🟠 矛盾:不同地方描述不一致
  • 🔵 待决策:需要产品/业务方决策的事项

处理建议:

  1. 将待确认项整理后发送给产品经理/需求方
  2. 在需求评审会议上逐一确认
  3. 确认后更新需求文档和测试用例
  4. 未确认的需求点标记为风险,预留测试时间

7. 数据流分析

graph LR
    A[用户操作] --> B[前端]
    B --> C[API 网关]
    C --> D[智能体服务]
    D --> E[模型服务]
    D --> F[知识库服务]
    D --> G[工具服务]
    D --> H[数据库]
    E --> D
    F --> D
    G --> D
    D --> C
    C --> B
    B --> I[用户]