Skill: luiciferyi/agent-requirement-analyzer (version 1.0.0)

--- 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. 数据流分析 ```mermaid 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[用户] ```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)