القائمة
快速定位和修复Bug，简化流程。用于线上/测试环境发现Bug、功能异常需要修复。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
代码生成统一入口。生成 SQL、CRUD、API、枚举等代码。
基于 Git 提交和代码变更点同步需求/技术文档并补单元测试。用于修复或紧急改动后补文档、对齐代码与文档时使用。
技术方案设计与确认（阶段二）。基于已确认的需求，设计数据库、接口、代码结构，生成技术方案文档。
需求分析与确认（阶段一）。用于理解用户需求、澄清细节、明确功能边界，生成需求分析文档。
处理开发过程中的需求变更。用于开发过程中需求有调整、需要新增/删除/修改功能点、方案确认后发现遗漏。
查看公共类规范和使用方式。包括R响应类、ErrorCode错误码、异常处理、事务、缓存、并发控制、日志等。
| name | proj-fix |
| description | 快速定位和修复Bug，简化流程。用于线上/测试环境发现Bug、功能异常需要修复。 |
Step 0: 校验任务文档 → Step 1: 问题收集 → Step 2: 问题定位 → Step 3: 修复方案 → Step 4: 代码修复 → Step 5: 验证
## Bug 信息
**问题描述：** {用户描述的问题}
**复现步骤：** {如何复现}
**期望行为：** {正确的行为}
**实际行为：** {当前错误的行为}
**错误信息：** {报错日志}
同步更新任务文档（不写细节）：
常见错误类型：
| 错误类型 | 可能原因 | 排查方向 |
|---|---|---|
| NullPointerException | 空指针 | 检查对象是否为 null |
| SQLException | 数据库错误 | 检查 SQL、字段、连接 |
| BusinessException | 业务校验失败 | 检查业务逻辑 |
| 参数校验失败 | 入参不合法 | 检查 DTO 校验注解 |
| 404 | 接口不存在 | 检查路径、Controller |
| 500 | 服务器内部错误 | 查看详细日志 |
## 修复方案
**修复方式：** {如何修复}
**修改文件：** {需要修改的文件}
**注意事项：** {风险点}
修复原则：
## 验证清单
- [ ] 问题是否已修复
- [ ] 原有功能是否正常
- [ ] 是否引入新问题
同步更新任务文档：
// 修复前
public UserResponse getDetail(Long id) {
User user = this.getById(id);
return convertToResponse(user); // user 可能为 null
}
// 修复后
public UserResponse getDetail(Long id) {
User user = this.getById(id);
if (user == null) {
throw new BusinessException(ErrorCode.DATA_NOT_EXIST);
}
return convertToResponse(user);
}
fix: {简要描述问题}
- 问题原因：{原因}
- 修复方式：{方式}