Skills
skills/skills.netease.im/requirement-review

requirement-review

SKILL.md

需求评审 Skill

触发条件

用户满足以下任一条件时触发：

  • 明确要求评审需求（如"帮我评审这个需求"）
  • 提供需求文档的 URL
  • 提供本地需求文档路径（如 requirements/xxx.md）
  • 粘贴需求内容并要求分析
  • 提供产品说明文档 URL 作为参考

输入获取

1. 待评审需求

  • 本地文件：使用 read 工具读取本地文件
    • 支持 .md/.txt/.html 等格式
    • 工作目录：D:\home\liuchang24\.openclaw\workspace
    • 示例路径：requirements/需求文档.md 或完整路径
  • URL 获取：使用 web_fetch 工具读取 URL 内容
    • 支持任意平台的 URL
    • 设置 maxChars: 15000 避免内容过长
  • 粘贴内容：直接使用用户提供的文本内容

本地文件加载方式：

// 文件在工作目录下
read({ path: "requirements/需求文档.md" })

// 或完整路径
read({ path: "D:/path/to/requirement.md" })

2. 参考产品说明文档（用户提供）

用户可以在评审需求时，额外提供产品说明文档的 URL。

提供方式：

  • 在提供需求文档时，同时说明产品说明文档 URL
  • 例如："评审这个需求，参考文档在这里：https://xxx.com/docs"

使用规则：

  1. 仅从用户提供的 URL 中提取背景知识
  2. 禁止自行 search 或访问其他来源获取产品信息
  3. 如果用户未提供产品说明文档，则跳过产品背景知识分析

读取方式：

web_fetch({
  url: "用户提供的产品的说明文档URL",
  maxChars: 10000
})

3. 产品背景知识提取规则

当需要了解需求中涉及的产品背景时：

  1. 优先从用户提供的参考文档 URL 中提取

  2. 必须限定范围：只读取用户提供的产品说明文档相关页面

  3. 禁止发散：

    • ❌ 不使用 web_search 搜索
    • ❌ 不访问其他未授权的 URL
    • ❌ 不从外部百科或文档站点获取信息

  4. 提取策略：

    • 先读取用户提供的主文档 URL
    • 根据需求内容中的关键词，在文档内搜索相关内容
    • 仅引用文档中明确说明的产品功能/术语

  5. 边界处理：

    • 如果产品说明文档中找不到相关内容 → 明确告知"文档中未找到相关说明，建议补充"
    • 如果用户未提供产品说明文档 → 在评审报告中注明"未提供产品说明文档，跳过产品背景分析"

评审流程

第一步：解析需求内容

从网页或文本中提取：

  • 需求名称/标题
  • 需求描述
  • 功能点列表
  • 业务流程
  • 边界条件

第二步：结构化评审

按照以下五个维度进行评审：

1. 需求合理性 (Requirement Rationality)

  • 业务价值是否明确
  • 目标用户是否清晰
  • 需求必要性（是否解决实际问题）
  • 与现有功能的关联/冲突

2. 与现有产品的兼容性 (Product Compatibility)

  • 需求是否基于原始产品文档（Easydata V9.0）扩展
  • 是否与现有功能冲突或重复
  • 新增功能是否需要与已有模块交互
  • 现有产品是否有相关功能可复用

3. 功能完整性 (Functional Completeness)

  • 核心功能是否描述完整
  • 业务流程是否闭环
  • 边界条件和异常场景是否覆盖
  • 数据来源和流向是否清晰
  • 权限/角色要求是否明确

4. 技术实现难度 (Technical Complexity) - 前端视角

结合 Vue2/Vue3 + Ant Design Vue 技术栈评估：

高难度指标：

  • 复杂表单（动态表单项、级联选择、跨表单校验）
  • 大数据量表格（虚拟滚动、分页、排序、筛选）
  • 实时协作/多人编辑
  • 复杂可视化图表
  • 文件上传（分片、进度控制、断点续传）
  • 树形/层级数据结构处理
  • 复杂状态管理（多模块状态、撤销/重做）
  • iframe 或第三方嵌入
  • 移动端适配

中难度指标：

  • 弹窗流程（多步弹窗、弹窗内表单）
  • 动态权限控制
  • 复杂搜索筛选
  • 列表到详情的跳转逻辑
  • 数据导入/导出
  • 用户引导/新手教程

低难度指标：

  • 静态展示页面
  • 简单CRUD操作
  • 标准表单提交

5. 文档质量 (Documentation Quality)

  • 术语是否一致
  • 描述是否无歧义
  • 前后描述是否一致
  • 截图/示例是否充分
  • 交互流程是否清晰

第三步：输出评审报告

评审输出格式

# 需求评审报告：[需求名称]

> 评审时间：{YYYY-MM-DD HH:mm}
> 技术栈：Vue2/Vue3 + Ant Design Vue

---

## 1. 需求概述
[简要概述这个需求是什么]

---

## 1.5 产品背景知识（基于提供的文档）

**参考文档**：[用户提供的URL或"未提供"]

**相关背景**：
- [从产品说明文档中提取的与需求相关的背景知识]
- [如果文档中未找到：标注"文档中未找到相关说明"]

**需要注意的产品特性**：
- [产品相关的产品特性、限制或注意事项]

---

## 2. 需求合理性分析

| 维度 | 评分 | 说明 |
|------|------|------|
| 业务价值 | ⭐⭐⭐⭐⭐ |  |
| 目标用户 | ⭐⭐⭐⭐⭐ |  |
| 需求必要性 | ⭐⭐⭐⭐⭐ |  |

**结论**：[是否合理的总体判断]

---

## 2.5 与现有产品关联性

| 检查项 | 状态 | 说明 |
|--------|------|------|
| 基于 Easydata V9.0 扩展 | ✅/⚠️ |  |
| 与现有功能关系 | 复用/扩展/冲突/独立 |  |
| 是否可复用现有模块 | ✅/❌ |  |

**分析**：[需求与现有产品的关联说明]

---

## 3. 功能完整性检查

### 3.1 核心功能
| 功能 | 描述 | 完整性 |
|------|------|--------|
|      |      | ✅完整 / ⚠️需补充 |

### 3.2 缺失检查
- [ ] 边界条件说明
- [ ] 异常流程说明
- [ ] 数据权限说明
- [ ] 其他：...

---

## 4. 技术实现难度（前端视角）

### 4.1 技术复杂度评估
| 功能模块 | 复杂度 | 说明 |
|----------|--------|------|
|          | 高/中/低 |  |

### 4.2 重点难点分析

**? 高风险点**
- [具体功能]：难点说明 + 建议方案

**? 中等风险**
- [具体功能]：难点说明 + 建议方案

### 4.3 技术选型建议
- 推荐使用的组件/库
- 性能优化建议
- 架构建议

---

## 5. 文档质量评估

| 检查项 | 状态 |
|--------|------|
| 术语一致性 | ✅/❌ |
| 描述清晰度 | ✅/❌ |
| 流程完整性 | ✅/❌ |

---

## 6. 总结与建议

### 必须修改 (P0)
1. [问题描述] → [修改建议]

### 建议修改 (P1)
1. [问题描述] → [修改建议]

### 待确认 (Q)
1. [悬而未决的问题]

---

**评审人**：AI Assistant  
**建议后续**：与产品经理确认 P0 问题后进入设计阶段

参考资料

详细的前端技术评估标准请参见：references/frontend-checklist.md

Installs
1
Source
skills.netease.…b9e199d7
First Seen
Apr 8, 2026