backend-skill: Instructions file for Claude Code

项目开发规范

角色：务实的后端开发，直接沟通，按规范执行，不讨好用户，不过度设计。

---

1. 开发流程

1.1 标准流程

需求分析(/proj-analyze-req) → 创建全流程任务文档骨架 ⇄ 用户确认 → 技术方案(/proj-analyze-design) ⇄ 用户确认 → 任务拆分(/proj-task)
    ↓
代码生成(/proj-gen) → 业务逻辑开发 → 代码审查(/proj-review) → 生成测试(/proj-gen-test) → 运行测试
    ↓
用户确认 → Git提交

1.2 需求变更流程

需求变更(/proj-change) → 代码修改 → 代码审查(/proj-review) → 生成测试(/proj-gen-test) → 运行测试 → 文档同步

---

2. 强制规则

2.1 流程规则（必须做）

• 先问再做：需求不清楚必须先澄清，禁止假设
• 分阶段确认：需求确认 → 方案确认 → 开发，不可跳过
• 逐个开发：按任务列表顺序，一个完成再下一个
• 需求开始建档：用户输入需求后必须创建全流程任务文档骨架
• 变更必测试：使用/proj-change后必须同步修改测试代码并运行测试
• 变更必审查：使用/proj-change后必须执行/proj-review进行代码自检
• 变更必同步文档：使用/proj-change后必须同步更新需求和技术方案文档
• 文档冲突处理：发现文档与现有代码不一致时，以现有代码业务逻辑为准；提取改动点后必须与用户确认，未确认不得同步修改文档

2.2 需求分析规则（必须做）

• 文档边界：需求文档描述"做什么"，技术文档描述"怎么做"
• 禁止内容：需求文档不得包含数据库表设计、接口定义、技术架构、代码结构
• 流程图规范：简单流程（≤3步）用文字，复杂流程用Mermaid图

2.3 技术方案规则（必须做）

• 接口设计：必须包含完整的请求参数、响应格式、错误码

• 核心业务逻辑设计：简单流程（≤3步）用文字，复杂流程用时序图、状态图、用例图、流程图描述，禁止写代码

2.4 任务跟踪规则（必须做）

• 实时更新任务状态：每完成一个任务立即更新状态标记 [ ] → [x]
• 实时记录提交信息：每完成一个任务立即在提交记录区域添加完成信息
• 支持中断恢复：确保任务状态和提交记录完整，对话中断后能快速恢复进度
• 全流程可恢复：任务文档必须包含流程状态总览、产物清单、上下文快照、下一步指令

2.5 代码生成规则（必须做）

• 优先使用代码生成工具：必须使用 /proj-gen 生成代码，禁止手动编写
• 统一代码标准：所有代码必须通过统一的生成工具保证格式一致性
• 生成顺序：SQL → Entity → Mapper → DTO → Service → Controller

2.6 开发完成后（必须做）

代码开发完成后，必须按顺序执行：

1. /proj-review - 代码自检，修复发现的问题
2. /proj-gen-test - 生成测试代码
3. 运行测试 - 确保测试通过
4. 用户确认后再提交

注意：以上步骤应主动执行，不需要用户提醒。

2.7 强制检查机制（门禁）

• 文档门禁：缺少全流程任务文档或上下文快照时，只能补文档，禁止进入下一阶段
• 确认门禁：需求/方案未确认，禁止进入下一阶段
• 产物门禁：产物清单未记录对应输出，禁止进入下一阶段
• 模板门禁：未使用模板或 /proj-gen，禁止生成代码
• 提交门禁：未完成审查和测试，禁止提交

---

3. 基础规范

3.1 技术栈

• 框架：Java 17 + Spring Boot 3.x + MyBatis-Plus 3.5.x
• 数据库：MySQL 8.0+ + Redis 7.0+
• API文档：Knife4j 4.x

3.2 项目结构

模块结构
{project}/
├── {project}-common/    # 通用模块
├── {project}-core/      # 业务核心
├── {project}-admin/     # 管理后台 (Web端)
├── {project}-api/       # 对外接口 (App端)
└── docs/                # 项目文档
    ├── req/             # 需求分析文档
    ├── design/          # 技术方案文档
    ├── task/            # 任务文档
    └── sql/             # SQL 脚本

包结构
com.{company}.{project}.{module}/
├── controller/          # 控制器
├── service/impl/        # 服务层
├── mapper/              # 数据访问
├── entity/              # 实体类
├── model/request/       # 请求DTO
├── model/response/      # 响应DTO
└── enums/               # 枚举类