mit einem Klick
需求分析与确认(阶段一)。用于理解用户需求、澄清细节、明确功能边界,生成需求分析文档。
npx skills add https://github.com/zhangloveyan/backend-skill --skill proj-analyze-reqKopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um den Skill zu installieren
需求分析与确认(阶段一)。用于理解用户需求、澄清细节、明确功能边界,生成需求分析文档。
npx skills add https://github.com/zhangloveyan/backend-skill --skill proj-analyze-reqKopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um den Skill zu installieren
代码生成统一入口。生成 SQL、CRUD、API、枚举等代码。
基于 Git 提交和代码变更点同步需求/技术文档并补单元测试。用于修复或紧急改动后补文档、对齐代码与文档时使用。
技术方案设计与确认(阶段二)。基于已确认的需求,设计数据库、接口、代码结构,生成技术方案文档。
处理开发过程中的需求变更。用于开发过程中需求有调整、需要新增/删除/修改功能点、方案确认后发现遗漏。
查看公共类规范和使用方式。包括R响应类、ErrorCode错误码、异常处理、事务、缓存、并发控制、日志等。
生成Docker Compose、Dockerfile、Nginx等部署配置。用于项目初始化部署配置、新增服务需要部署、查看部署配置模板。
| name | proj-analyze-req |
| description | 需求分析与确认(阶段一)。用于理解用户需求、澄清细节、明确功能边界,生成需求分析文档。 |
目标:理解用户真实需求,明确功能边界和业务逻辑,生成需求分析文档。 产出:需求分析文档(用户确认后进入阶段二)
Step 0: 初始化任务文档 → Step 1: 需求理解 → Step 2: 规模判断 → Step 3: 需求澄清(与用户交互) → Step 4: 输出需求文档 → Step 5: 用户确认
在用户输入需求后,必须创建全流程任务文档骨架:
docs/task/{YYYYMMDD}_{中文模块名}_任务.md从用户描述中初步提取:
| 维度 | 提取内容 |
|---|---|
| 功能目标 | 要实现什么功能 |
| 使用角色 | 谁来使用 |
| 涉及端 | Web后台/小程序/App/开放接口 |
| 涉及模块 | 影响哪些现有模块 |
| 关键操作 | 核心功能点 |
注意:此步骤仅做初步理解,禁止假设任何细节。
| 规模 | 特征 | 后续流程 |
|---|---|---|
| 简单 | 改字段、加接口、改配置 | 可简化澄清,但仍需确认 |
| 中等 | 新模块、独立功能 | 标准流程 |
| 复杂 | 跨模块、架构调整、核心流程 | 完整流程,详细文档 |
判断依据:
AI 必须向用户询问以下问题,根据需求复杂度选择性提问:
| 维度 | 问题 | 说明 |
|---|---|---|
| 功能范围 | 这个功能给谁用?Web端?移动端?都需要? | 明确端类型 |
| 用户角色 | 涉及哪些角色?各角色能做什么操作? | 明确权限边界 |
| 功能清单 | 具体需要哪些功能点? | 列表/详情/创建/编辑/删除/导出/审批... |
| 业务流程 | 主要业务流程是怎样的?有哪些状态流转? | 明确流程节点 |
| 业务规则 | 有哪些业务限制或校验规则? | 明确约束条件 |
| 数据要求 | 需要记录哪些信息/字段? | 明确数据结构 |
| 关联关系 | 与现有哪些模块有关联? | 明确依赖关系 |
| 参考资料 | 有没有参考产品或原型图? | 获取更多上下文 |
我来帮您分析这个需求。为了准确理解,请回答以下问题:
**1. 功能范围**
- 这个功能给谁用?Web后台管理端?小程序端?还是都需要?
**2. 用户角色**
- 涉及哪些角色?各角色分别能做什么操作?
**3. 功能清单**
- 需要哪些具体功能?(如:列表查询、详情查看、新增、编辑、删除、导出...)
**4. 业务流程**
- 主要的业务流程是怎样的?
- 是否有状态流转?(如:待处理→处理中→已完成)
**5. 数据要求**
- 需要记录哪些信息/字段?
- 哪些是必填项?
请逐一回答,我会根据您的回答进一步澄清。
在充分澄清后,使用模板输出需求分析文档。
模板文件:需求文档模板
保存位置:docs/req/{YYYYMMDD}_{中文模块名}_需求.md
同步更新任务文档:
输出需求文档后,必须使用以下话术请求确认:
以上是我对需求的理解,请确认:
1. 功能范围是否完整?
2. 业务流程是否正确?
3. 是否有遗漏的功能点或业务规则?
确认后我将进入技术方案设计阶段(/proj-analyze-design)。
| 用户反馈 | 处理方式 |
|---|---|
| "确认"/"没问题"/"可以" | 进入阶段二:/proj-analyze-design |
| "需要补充xxx" | 更新需求文档,再次确认 |
| "需要修改xxx" | 修改对应内容,再次确认 |
| "取消"/"不做了" | 结束流程 |
确认后同步更新任务文档:
需求文档应包含:
需求文档禁止包含:
每个主要功能都要有典型使用场景:
场景X:{场景名称}
{用户角色}在{什么情况下}需要{做什么事情},期望{达到什么目标}。
必须包含以下章节:
需求文档中应澄清以下技术相关问题: