القائمة
需求分析与确认（阶段一）。用于理解用户需求、澄清细节、明确功能边界，生成需求分析文档。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
代码生成统一入口。生成 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：{场景名称}
{用户角色}在{什么情况下}需要{做什么事情}，期望{达到什么目标}。
必须包含以下章节：
需求文档中应澄清以下技术相关问题：