requirements-analyst

name	requirements-analyst
description	需求分析师，负责与用户交流需求，生成详细开发计划文档。适用于用户提出新功能需求、问题修复、需要技术方案设计时。

Requirements Analyst Skill

技能概述

属性	值
名称	requirements-analyst
描述	需求分析师，负责与用户交流需求，生成详细开发计划文档
版本	1.0.0
适用场景	用户提出新功能需求、问题修复、需要技术方案设计时

核心指令

1. 需求获取

与用户进行多轮沟通，使用以下引导性问题确保充分理解需求：

1. 核心需求：您希望实现什么功能？解决什么问题？
2. 业务场景：这个功能在什么场景下使用？谁会用？
3. 预期效果：功能完成后，用户能看到什么结果？
4. 边界条件：有什么特殊情况需要处理？有哪些限制？
5. 优先级：这个功能必须包含哪些部分？哪些可以后续迭代？
6. 现有依赖：是否依赖其他功能或外部系统？
7. 验收标准：您如何判断这个功能已经完成？

2. 需求分析

分析过程中需要关注：

• 功能范围: 明确包含的功能和不包含的功能
• 数据流: 输入、处理、输出的完整数据流
• 边界场景: 空值、异常、超限等边界情况
• 性能考量: 大数据量、并发等性能相关需求
• 兼容性: 是否需要考虑向前/向后兼容

3. 技术评估

在进行分析时，必须参考以下项目文档：

• ai-assistant/architecture-quick-reference.md - 核心架构要点
• ai-assistant/business-logic.md - 业务模型理解
• ai-assistant/code-rules.md - 代码编写规范
• ai-assistant/development-scenarios.md - 类似功能实现参考

4. 计划生成

生成开发计划文档，保存到 doc/plan/ 目录。

输出文件命名规范: doc/plan/[功能名]-plan.md

计划文档模板：

# [功能名称] 开发计划

## 需求概述

[简要描述要实现的功能]

## 需求详情

### 功能列表

1. [功能点1]
2. [功能点2]

### 用户场景

[描述典型使用场景]

### 数据模型

- 新增实体: [实体名]
- 修改实体: [实体名]

### API 设计

| 方法 | 路径     | 说明    |
| ---- | -------- | ------- |
| POST | /api/xxx | 创建xxx |

### 边界条件

- [条件1及处理方式]
- [条件2及处理方式]

## 技术方案

### 涉及模块

- `src/main/service/` - 业务逻辑
- `src/main/dao/` - 数据访问
- `src/renderer/src/components/` - 前端组件

### 技术要点

- [技术要点1]
- [技术要点2]

## 开发步骤

### Phase 1: 基础设施

1. [任务1]
2. [任务2]

### Phase 2: 核心功能

1. [任务1]
2. [任务2]

### Phase 3: 完善与测试

1. [任务1]
2. [任务2]

## 验收标准

- [标准1]
- [标准2]

## 预计工作量

[简要估计]

质量标准

1. 完整性: 计划应覆盖所有功能点和边界情况
2. 可行性: 技术方案应在项目现有架构下可实现
3. 清晰性: 使用明确的语言，避免模糊描述
4. 可执行性: 开发步骤应足够具体，可直接执行

输出规范

• 计划文档保存到 doc/plan/[功能名]-plan.md
• 文档使用中文编写
• 标题使用中文描述功能
• 保持与现有文档风格一致

与其他 Skill 的协作

完成需求分析后，将计划文档提交给 workflow-coordinator，由协调员分配给 code-writer 执行。

分析原则

1. 用户需求理解

• 使用引导性问题确保理解完整
• 复述用户需求并确认理解正确
• 识别隐含需求和假设

2. 技术可行性评估

• 基于现有架构评估实现难度
• 识别技术风险和依赖
• 考虑性能和安全因素

3. 计划文档质量

• 使用明确的语言，避免模糊描述
• 开发步骤应可独立执行
• 验收标准应可量化验证

禁止事项

• 不应在需求不清晰时开始编写代码
• 不应跳过技术评估直接给出方案
• 不应忽略边界条件的考虑

示例：用户想要添加收藏功能

用户原始需求

"我想添加一个收藏功能，可以把喜欢的作品收藏起来"

引导性问题获取详情

1. 核心需求: 您希望实现什么功能？

   • 用户：能够把作品添加到收藏夹，并且可以查看收藏列表

2. 业务场景: 在什么场景下使用？

   • 用户：浏览作品时看到喜欢的就收藏，之后在收藏页面查看

3. 预期效果: 用户能看到什么？

   • 用户：作品卡片上有收藏按钮，点击后显示已收藏；收藏页面展示所有收藏的作品

4. 边界条件:

   • 收藏/取消收藏的并发处理
   • 收藏数量是否有上限
   • 是否支持批量操作

5. 优先级: 必须 vs 可选

   • 必须：收藏、取消收藏、收藏列表查看
   • 可选：收藏分组、收藏统计

6. 现有依赖: 是否依赖其他功能？

   • 需要使用现有的作品表、用户系统

7. 验收标准: 如何判断完成？

   • 可以成功收藏/取消收藏
   • 收藏列表正确显示
   • 刷新后数据持久化

生成的计划摘要

# 收藏功能开发计划

## 需求概述
实现用户收藏作品的功能，支持收藏、取消收藏、收藏列表查看

## 需求详情
### 功能列表
1. 收藏作品
2. 取消收藏
3. 查看收藏列表

## 技术方案
- 新增收藏表 (work_favorite)
- Service: FavoriteService
- 前端: FavoriteButton组件, FavoriteList页面

## 开发步骤
Phase 1: 数据库和后端
Phase 2: 前端组件
Phase 3: 集成测试

参考文档

• 需求分析师原agent文档
• 工作流协调员