Dev Requirement

---
name: dev-requirement
description: "毕业设计(软件开发)需求分析。把项目想法+用户功能要求拆解成结构化需求规格。Use when user says 需求分析/毕设需求."
argument-hint: [project-idea]
allowed-tools: Bash(*), Read, Write, Edit, Grep, Glob
---

# 毕业设计 · 需求分析

对以下项目进行需求分析：**$ARGUMENTS**

## 输入

1. **AGENTS.md** — 含用户填的：**project_type（项目类型）**、技术栈、功能需求、自定义要求。**先读它的"说明/参数"段获取这些。** 需求分析要贴合项目类型（全栈Web/纯前端/CLI/脚本）。
2. **user_data/** — 用户可能上传的任务书/需求文档（读 `user_data/*_extracted.txt` 或 `user_data/*.txt`，若存在）。

## ⛔ 恢复场景

若工作区已有 `REQUIREMENTS.md`（上次跑了一半），在其基础上**补全完善**，不要推倒重写。

## 任务

把"项目想法 + 用户功能要求 + 上传的任务书"拆解、补全成一份**完整、可执行的需求规格** `REQUIREMENTS.md`。

- 用户只给一句话时，你要**主动拆解 + 补全**常识性必要功能（如：用户系统一般需要登录/注册/鉴权；增删改查一般需要列表/详情/表单）。
- 用户列了功能点时，以用户的为准，补齐遗漏的支撑功能。
- 每个功能标优先级：**必做** / 可选。
- 不要超纲：用户没提的大功能（如支付、实时通信）除非项目性质必需，否则不擅自加，只在"建议扩展"里列出供用户在检查点决定。

## 产出（REQUIREMENTS.md，固定小节，下游会读）

必须包含以下 `##` 小节，标题**一字不差**（下游 dev-design 靠这些定位）：

```markdown
# 需求规格说明书

## 项目概述
（一段话说明这是什么系统、给谁用、解决什么问题）

## 用户角色
（列出系统的用户类型，如：普通用户 / 管理员，各自能做什么）

## 功能清单
（逐条列，每条格式： - **功能名**（必做/可选）：一句话描述）
- **用户注册登录**（必做）：邮箱+密码注册、登录、登出、会话保持
- ...

## 页面清单
（前端需要哪些页面，如：登录页 / 首页 / 列表页 / 详情页 / 个人中心）

## 接口清单
（后端需要哪些 API，如： POST /api/login、GET /api/items、POST /api/items）

## 非功能需求
（性能/安全/兼容性的基本要求，简要即可）

## 建议扩展（可选，供用户决定）
（你觉得可以加、但用户没提、也非必需的功能）
```

## 完成铁律

- `REQUIREMENTS.md` 必须 ≥ 1500 字节，六个必需小节齐全。
- 功能清单至少覆盖用户明确提到的每一个功能点。

产出结构、存在性和最低完整性由 `finish` 按模板中的 `output_contract` 自动核验；修复返回的具体问题，不复制执行验证脚本。
验证失败就继续补全，不要 end_turn。

## 执行与产出

使用当前执行会话完成本步工作；产物路径按当前步骤合同。程序采集真实操作、输入输出、版本与运行清单，模型只负责实质成果和领域质量。

保留实际输入来源与模板信息；其内容摘要由程序记录。