需求分析
- 作者仓库星标 0
- 作者仓库 full-stack-skill
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @RainLib · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 需求分析
## 何时使用
- 用户描述了产品想法、提供了原型文档或需求草稿,需要整理成可执行需求时。
- 全栈工作流第 1 阶段,由编排器调用。
## 与用户交流(必须)
本阶段在**主对话中执行**,需与用户多轮对话,不得臆造需求。
### 交互原则
- 对模糊点**必须**用 1~3 轮提问补全,**等待用户回复后再写入文档**。
- **所有决策点都应以结构化选项呈现**,让用户选择而非自由输入。例如向用户提供编号选项("请选择 1/2/3"),可同时选多个时说明"可多选"。
- 允许用户在选项之外补充说明(如选了"其他"后追加描述)。
- 一次不要问超过 3 个问题,避免用户信息过载。
## 执行要点
1. **原型/文档识别**:若用户提供了产品原型截图、PRD 文档或草稿,先提取其中的功能描述与页面流程。
2. **功能点梳理**:按「功能模块 → 功能点」提取列表,不遗漏、不臆造。每个功能点含简要描述与输入输出。
3. **用户故事**:核心功能点转写为用户故事格式(As a ... I want ... So that ...)。
4. **验收标准**:每个功能点附 1~3 条验收标准(Given/When/Then 或要点式)。
5. **细节追问**:对模糊点(角色、边界、数据来源、异常情况)用 1~3 轮简短提问补全,**等待用户回复后再写入**。
6. **输出格式**:使用 [templates/requirements-template.md](templates/requirements-template.md) 填写并产出需求文档。
## 结构化提问引导
以下每组为一轮提问。每轮向用户呈现**结构化选项**,用户选择后再进入下一轮。
### 第 1 轮:基础信息
向用户确认以下内容(可合并为一组选项):
**Q1 — 是否有原型图或设计稿?**
- A. 有(原型图/设计稿/Figma 链接等)
- B. 有参考网站或竞品
- C. 都没有,从零开始
**Q2 — 项目涉及哪些端?**
- A. 前端 + 后端(全栈)
- B. 仅前端
- C. 仅后端
**Q3 — 用户角色?**(可多选)
- A. 仅单角色(无权限区分)
- B. 普通用户 + 管理员
- C. 多角色(3 种及以上),请简要说明
### 第 2 轮:前端 UI/UX 偏好(Q1 选 C 时必问)
若用户没有原型图/设计稿,向用户呈现以下选项:
**Q4 — 整体风格?**
- A. 现代简约(参考 Linear / Notion)
- B. 商务正式(参考企业后台)
- C. 科技感 / 仪表盘风格
- D. 其他(请补充或提供参考网站)
**Q5 — 主色调?**
- A. 蓝色系
- B. 绿色系
- C. 紫色系
- D. 暗色系(深色背景)
- E. 其他(请说明色值或偏好)
**Q6 — 布局方式?**
- A. 侧边栏导航(左侧菜单 + 右侧内容)
- B. 顶部导航栏
- C. 无导航(单页/落地页)
- D. 其他
**Q7 — 响应式需求?**
- A. 仅桌面端
- B. 桌面 + 平板
- C. 全端适配(桌面 + 平板 + 手机)
- D. 移动端优先
**Q8 — 是否需要暗色模式?**
- A. 需要
- B. 不需要
- C. 后续再说
### 第 3 轮:后端架构偏好(项目涉及后端且未明确时必问)
**Q9 — API 风格?**
- A. RESTful
- B. GraphQL
- C. 无偏好,你来推荐
**Q10 — 认证方式?**
- A. JWT(无状态)
- B. Session(有状态)
- C. OAuth2 第三方登录
- D. 暂不需要认证
**Q11 — 数据库偏好?**
- A. MySQL
- B. PostgreSQL
- C. MongoDB
- D. SQLite(轻量/嵌入式)
- E. 无偏好
**Q12 — 是否需要 API 文档自动生成(Swagger/OpenAPI)?**
- A. 需要
- B. 不需要
- C. 后续再说
### 第 4 轮:补充确认
根据用户前面的回答,对仍有模糊的业务流程、异常分支、非功能需求进行针对性追问。此轮可使用开放式问题。
## 辅助资料
- 完整示例输出:[examples/sample-output.md](examples/sample-output.md) — 展示一份合格需求文档的完整结构与内容深度
- 编写参考:[reference.md](reference.md) — 用户故事 INVEST 原则、验收标准写法、常见追问清单
## 产出
- 一份按模板填写的需求文档,供「技术选型」与后续阶段使用。
## 文档与状态
- 产出写入 `docs/{current_iteration_id}/requirements-{requirements_id}.md`。
- 开始前:调用 `history-manager` skill 的 `get-phase requirements` 和 `check-file` 确认是否已完成。
- 完成后:调用 `history-manager` skill 的 `set-phase requirements {requirements_id}` 记录并推进状态。
章节与文件索引
按说明文件中的顺序排列。
何时使用
交互原则
执行要点
第 1 轮:基础信息
第 2 轮:前端 UI/UX 偏好(Q1 选 C 时必问)
文件/命令 -> docs/{current_iteration_id}/requirements-{requirements_id}.md · history-manager · get-phase requirements · check-file · set-phase requirements {requirements_id}
内容校验值 -> f0dadc7a171d
当前原文的自动摘译,尚未人工审校。
何时使用
用户描述了产品想法、提供了原型文档或需求草稿,需要整理成可执行需求时。 全栈工作流第 1 阶段,由编排器调用。
交互原则
对模糊点必须用 1~3 轮提问补全,等待用户回复后再写入文档。 所有决策点都应以结构化选项呈现,让用户选择而非自由输入。例如向用户提供编号选项("请选择 1/2/3"),可同时选多个时说明"可多选"。 允许用户在选项之外补充说明(如选了"其他"后追加描述)。 一次不要问超过 3 个问题,避免用户信息过载。
执行要点
原型/文档识别:若用户提供了产品原型截图、PRD 文档或草稿,先提取其中的功能描述与页面流程。 功能点梳理:按「功能模块 → 功能点」提取列表,不遗漏、不臆造。每个功能点含简要描述与输入输出。 用户故事:核心功能点转写为用户故事格式(As a ... I want ... So that ...)。 验收标准:每个功能点附 1~3 条验收标准(Given/When/Then 或要点式)。 细节追问:对模糊点(角色、边界、数据来源、异常情况)用 1~3 轮简短提问补全,等待用户回复后再写入。
第 1 轮:基础信息
向用户确认以下内容(可合并为一组选项): Q1 — 是否有原型图或设计稿? A. 有(原型图/设计稿/Figma 链接等) B. 有参考网站或竞品 C. 都没有,从零开始
第 2 轮:前端 UI/UX 偏好(Q1 选 C 时必问)
若用户没有原型图/设计稿,向用户呈现以下选项: Q4 — 整体风格? A. 现代简约(参考 Linear / Notion) B. 商务正式(参考企业后台) C. 科技感 / 仪表盘风格