shazhou/skills
8
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity
skills/hermes/requirements-analysis/references/complete-example.md

7.3 KiB
Raw Blame History

完整需求分析示例

初始请求

用户："我们需要一个管理者仪表板"

分析对话

第 1 轮：基本理解

AI："我会帮你分析这个需求。让我先问几个问题：

1. 管理者面临什么具体问题，这个仪表板将解决？
2. 谁在请求这个仪表板？
3. 这是用于现有系统还是新系统？"

用户："管理者无法轻松查看团队绩效指标。运营副总裁在请求它。这是用于我们现有的项目管理系统。"

第 2 轮：利益相关者识别

AI："很好，让我了解利益相关者：

1. 谁是将使用这个仪表板的管理者？
2. 除了运营副总裁，还有谁需要参与？
3. 是否有合规或安全要求？"

用户："所有部门经理（约 50 人）。我们需要让 IT 总监和数据隐私官参与，因为我们要显示员工数据。"

第 3 轮：详细需求

AI："现在让我们深入细节：

1. 管理者需要看到哪些具体指标？
2. 数据应该多久更新一次？
3. 管理者需要过滤或自定义视图吗？
4. 是否有性能要求？"

用户："他们需要看到：项目完成率、团队利用率、预算 vs 实际、即将到来的截止日期。数据应该每天更新。是的，他们应该能按团队、项目和日期范围过滤。仪表板应该在 3 秒内加载。"

第 4 轮：时间线和依赖关系

AI："让我们讨论时间：

1. 你什么时候需要这个仪表板？
2. 是否依赖其他项目？
3. 是否有特定事件或截止日期驱动这个需求？"

用户："我们需要在第二季度末（6 月 30 日）之前完成。它依赖于数据仓库项目首先完成。CEO 想在 7 月审查第二季度绩效，所以我们需要准备好。"

第 5 轮：验收标准

AI："最后，让我们定义成功：

1. 我们如何知道这个仪表板满足你的需求？
2. 哪些是必须有的功能，哪些是最好有的？
3. 你将如何测试？"

用户："成功意味着管理者可以做出数据驱动的决策，而无需向 IT 请求报告。必须有：我提到的 4 个指标、过滤和导出到 Excel。最好有：深入到单个项目、趋势图表。我们将首先与 5 位试点经理测试。"

最终需求文档

需求：管理者绩效仪表板

概述

  • ID：REQ-2026-001
  • 状态：已批准
  • 优先级：高
  • 创建日期：2026-02-10
  • 最后更新：2026-02-10

利益相关者

  • 业务负责人：运营副总裁，Jane Smith
  • 最终用户：部门经理（50 位用户）
  • 技术负责人：IT 总监，John Doe
  • 其他利益相关者：数据隐私官（合规审查）

业务背景

问题陈述

部门经理目前缺乏对团队绩效指标的可见性，必须向 IT 请求自定义报告，导致决策延迟和 IT 资源使用效率低下。

业务价值

  • 将 IT 报告请求量减少 80%
  • 实现实时数据驱动决策
  • 提高经理生产力 20%
  • 支持 CEO 的第二季度绩效审查流程

成功指标

  • 1 个月内 90% 经理采用率
  • IT 报告请求减少 80%
  • < 3 秒仪表板加载时间
  • 85% 用户满意度评分

需求详情

功能性需求

核心指标显示

  1. 项目完成率

    • 显示按时完成的项目百分比
    • 按团队和整体显示
    • 颜色编码：绿色（>90%）、黄色（70-90%）、红色（<70%）

  2. 团队利用率

    • 显示团队容量利用百分比
    • 按团队成员和团队平均值显示
    • 包括可计费 vs 不可计费分解

  3. 预算 vs 实际

    • 按项目显示预算差异
    • 显示为百分比和绝对值
    • 如果差异 > 10% 则警报

  4. 即将到来的截止日期

    • 列出未来 30 天内有截止日期的项目
    • 按紧急程度排序
    • 以红色突出显示逾期项目

过滤和自定义

  • 按团队过滤（多选）
  • 按项目过滤（多选）
  • 按日期范围过滤（最近 7/30/90 天，自定义范围）
  • 保存每个用户的过滤偏好
  • 重置为默认视图

数据导出

  • 导出到 Excel（.xlsx 格式）
  • 包含基于当前过滤器的所有可见数据
  • 保持格式和颜色编码

最好有的功能

  • 深入到单个项目详情
  • 趋势图表（显示随时间变化的指标的折线图）
  • 电子邮件定时报告

非功能性需求

  • 性能：

    • 仪表板加载时间 < 3 秒
    • 过滤器应用 < 1 秒
    • 支持 50 个并发用户

  • 安全：

    • 基于角色的访问控制（经理只能看到他们的团队）
    • 数据访问审计日志
    • 仅 HTTPS

  • 数据新鲜度：

    • 数据每天早上 6 点更新
    • 显示最后更新时间戳

  • 可用性：

    • 移动响应式设计
    • 无障碍（符合 WCAG 2.1 AA）
    • 无需培训的直观界面

  • 可用性：

    • 工作时间（早上 6 点 - 晚上 8 点）99% 正常运行时间
    • 计划维护窗口：周日凌晨 2-4 点

验收标准

  1. Given 我是一名经理，When 我登录仪表板，Then 我看到截至今天早上 6 点更新的我的团队绩效指标

  2. Given 我正在查看仪表板，When 我应用过滤器（团队、项目、日期范围），Then 指标在 1 秒内更新以反映过滤后的数据

  3. Given 我正在查看过滤后的数据，When 我点击"导出到 Excel"，Then 下载一个 Excel 文件，包含所有可见数据并保持颜色编码

  4. Given 我是一名经理，When 我尝试查看另一个团队的数据，Then 我被拒绝访问并看到适当的错误消息

  5. Given 仪表板正在加载，When 页面加载时，Then 所有指标在 3 秒内可见

  6. Given 我在移动设备上查看仪表板，When 我从手机访问它，Then 所有功能都可访问和可读

时间线

  • 预期交付：2026-06-30
  • 里程碑：
    • 需求批准：2026-02-15
    • 设计审查：2026-03-01
    • 开发完成：2026-05-31
    • 试点测试：2026-06-01 - 2026-06-15
    • 全面推出：2026-06-30

依赖关系

  • 数据仓库项目：必须在 2026-04-30 之前完成以提供数据源
  • 认证系统：必须支持基于角色的访问控制
  • Excel 导出库：需要在 2026-03-15 之前评估和选择库

约束条件

  • 必须使用现有项目管理数据库作为数据源
  • 必须符合数据隐私法规（GDPR、CCPA）
  • 必须与当前浏览器版本（Chrome、Firefox、Safari、Edge）兼容
  • 预算：$50,000（开发 + 基础设施）

风险

风险 影响 概率 缓解措施
数据仓库项目延迟 高 中 从直接数据库查询开始，稍后迁移到仓库
50 个并发用户的性能问题 中 低 在预发布环境进行负载测试，优化查询，添加缓存
经理抵制采用 高 低 让经理参与设计，提供培训，收集反馈
数据隐私问题 高 低 与数据隐私官提前审查，实施严格的访问控制

备注

  • 在全面推出之前，与来自不同部门的 5 位经理进行试点
  • 计划在 6 月为所有经理举办培训课程
  • 考虑根据反馈在第 2 阶段添加更多指标
  • 探索在未来版本中与移动应用集成