《IntelliJ + Claude Code + Gemini + ChatGPT 实战配置手册（升鲜宝版）》

一、先定分工

这类项目，最稳的分工是：

IntelliJ：编码、调试、跑项目、Git、断点、最终 review
Gemini Code Assist：当前文件解释、小范围补代码、单测、局部重构
Claude Code：跨文件改造、批量修改、执行命令、验证修复、仓库级任务
ChatGPT：PRD、架构、DDL、流程、状态机、代码审查意见、长期知识库

IntelliJ 自带内嵌终端，适合直接在 IDE 里跑 Maven、Git 和本地命令；Gemini Code Assist 支持 IntelliJ 登录与使用；Claude Code 支持常见开发流程如探索代码库、调试、重构、测试；ChatGPT Projects 可以把文件、聊天和自定义指令聚合到一个项目空间里。

二、推荐目录规范

Claude Code 的项目级配置，官方支持这些位置：

项目记忆：CLAUDE.md 或 .claude/CLAUDE.md
Skills：.claude/skills/SKILL.md
共享设置：.claude/settings.json
本地设置：.claude/settings.local.json
自定义命令：.claude/commands/*.md

这些都是 Claude Code 官方支持的文件系统配置方式。

推荐你在仓库里放成这样：

project-root/
├─ .claude/
│  ├─ settings.json
│  ├─ settings.local.json          # gitignore
│  ├─ CLAUDE.md                    # 可选；你也可以放根目录 CLAUDE.md
│  ├─ skills/
│  │  ├─ java-domain-review/
│  │  │  └─ SKILL.md
│  │  ├─ ddl-design/
│  │  │  └─ SKILL.md
│  │  ├─ audit-anti-audit/
│  │  │  └─ SKILL.md
│  │  └─ mp-refactor/
│  │     └─ SKILL.md
│  └─ commands/
│     ├─ scan-project.md
│     ├─ fix-build.md
│     ├─ add-javadoc.md
│     └─ review-diff.md
├─ docs/
│  ├─ architecture/
│  ├─ ddl/
│  ├─ prd/
│  └─ ai-prompts/
├─ src/
├─ pom.xml
├─ CLAUDE.md                      # 推荐放根目录，最直观
├─ GEMINI.md
├─ CHATGPT-PROJECT.md
└─ .gitignore

三、`.gitignore` 建议补充

# Claude local settings
.claude/settings.local.json

# IDE
.idea/
*.iml

# Build
target/
out/

# OS
.DS_Store
Thumbs.db

# Logs
logs/
*.log

四、根目录 `CLAUDE.md` 模板

Claude Code 会读取项目记忆文件作为长期上下文。下面这份模板，我已经按你常用规范写成“升鲜宝版”。

# 升鲜宝项目开发规范（Claude Code 项目记忆）

## 1. 项目背景
本项目为升鲜宝供应链管理系统，面向企业级供应链、仓储、门店、财务、物流、商城、会员等业务域。
目标是：生产级、可上线、可维护、最小改动优先。

## 2. 技术栈
- Java
- Spring Boot
- MyBatis-Plus
- MySQL 8.0
- Maven
- IntelliJ IDEA
- 部分模块可能使用 Redis、Swagger、Lombok

## 3. 代码风格
- 按阿里规范书写
- 优先最小 Diff Patch，不做无关重构
- 能不新增层就不新增层
- 优先沿用现有目录结构：entity / dao / service / serviceImpl / controller / xml
- 优先使用 MyBatis-Plus Wrapper；除非复杂 SQL，否则不要随意新增 XML
- 控制器入参与返回结构尽量保持兼容
- 优先使用 `@Resource`，避免 `@Autowired`
- Enum、Facade、核心 Service 需要 Javadoc
- 公共常量、错误码、状态值尽量统一收口

## 4. 数据库规范
- 数据库：MySQL 8.0
- 表字段不要使用 `is_` 前缀
- 通用字段优先：
  - remark
  - sort_code
  - del_flag
  - enabled
  - create_date
  - update_date
  - creator
  - updater
- 金额、数量字段要注意精度与舍入方式
- 生成 DDL 时必须包含：
  - 主键
  - 唯一索引
  - 普通索引
  - 字段注释
  - 表注释

## 5. 业务规范
- 审核/反审核必须成对设计
- 状态流转必须防重复审核、防重复反审核
- 涉及库存/成本/财务的操作必须考虑回滚
- 写入日志要考虑：
  - 单据日志
  - 审核日志
  - 反审核日志
  - 异常日志
- 涉及库存时，优先考虑：
  - 库存主表
  - 库存流水
  - 成本主表
  - 成本流水
  - 批次 / FIFO / 移动加权影响

## 6. 输出要求
当我要求你改代码时：
1. 先理解现有结构
2. 给出修改思路
3. 直接输出最终可复制代码
4. 如果涉及多文件，按文件分别输出
5. 尽量保证可编译
6. 不要只给伪代码，除非我明确要求方案版

## 7. 禁止事项
- 不要脱离当前项目风格重写整个模块
- 不要引入大量无关新框架
- 不要随意修改 controller 签名
- 不要虚构不存在的表和字段；如需新增，必须明确标注
- 不要省略关键判空、事务、异常处理

## 8. 默认工作方式
- 先读相关类、表、SQL、调用链
- 找出最小改动路径
- 修改后给出验证点
- 如需生成 zip/文档，按正式交付风格整理

五、`.claude/settings.json` 模板

Claude Code 支持共享项目设置和本地项目设置。下面这份是一个保守、安全、适合企业仓库的共享模板；个人机器差异大的内容，放到 settings.local.json。

{
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Glob",
      "Grep",
      "LS"
    ],
    "ask": [
      "Bash"
    ],
    "deny": []
  },
  "hooks": {
    "PostEdit": [
      {
        "matcher": ".*\\.(java|xml|yml|yaml|md|sql)$",
        "hooks": [
          {
            "type": "command",
            "command": "echo File edited: ${CLAUDE_FILE_PATH}"
          }
        ]
      }
    ]
  }
}

`.claude/settings.local.json` 示例

这个文件不进 Git，专门放你自己电脑上的习惯。

{
  "permissions": {
    "allow": [
      "Read",
      "Edit",
      "Glob",
      "Grep",
      "LS",
      "Bash(mvn -q -DskipTests compile:*)",
      "Bash(mvn -q test:*)",
      "Bash(git diff:*)",
      "Bash(git status:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "Bash(git commit:*)",
      "Bash(del:*)",
      "Bash(rm:*)"
    ],
    "deny": []
  }
}

六、`.claude/skills/` 推荐拆分

Claude Code 支持 Skills，核心是放 SKILL.md，Claude 会在相关场景自动调用，或者你手动用 /skill-name 调用。

建议你至少拆 4 个 skill：

java-domain-review
ddl-design
audit-anti-audit
mp-refactor

七、`SKILL.md` 通用母版

---
name: java-domain-review
description: 用于审查 Java 企业项目中的领域建模、分层、事务、异常、审核反审核、库存成本影响
---

# 使用场景
当任务涉及以下内容时启用本 skill：
- Service / ServiceImpl 设计审查
- Controller / DAO / XML 调用链分析
- 审核 / 反审核
- 库存 / 成本 / 流水一致性
- 生产级代码补齐与收口

# 目标
输出“可落地、最小改动、符合项目现有结构”的最终代码或建议。

# 检查清单
1. 是否保持现有目录结构
2. 是否优先最小 Diff
3. 是否保留兼容接口签名
4. 是否补齐事务
5. 是否补齐判空、异常、状态校验
6. 是否考虑日志
7. 是否考虑审核与反审核回滚对称性
8. 是否考虑库存主表、库存流水、成本主表、成本流水一致性
9. 是否避免随意新增中间层
10. 是否补充必要 Javadoc

# 输出格式
- 先给“问题摘要”
- 再给“修改思路”
- 再按文件输出最终代码
- 最后给“验证点”

# 特别规则
- 使用 `@Resource`
- 优先 MyBatis-Plus
- 需要 DDL 时带索引与注释
- 避免伪代码

八、4 个可直接用的 Skill 成品

1）`.claude/skills/audit-anti-audit/SKILL.md`

---
name: audit-anti-audit
description: 处理审核与反审核对称设计，适用于盘点、报损、报溢、入库、出库、调拨等单据
---

# 核心目标
实现生产级“审核 + 反审核”闭环，避免重复审核与重复反审核，确保库存/成本/流水/日志一致。

# 审核检查
1. 单据是否存在
2. 单据状态是否允许审核
3. 明细是否存在
4. 审核后是否更新主表状态、审核人、审核时间
5. 是否生成库存流水/成本流水
6. 是否写日志
7. 是否做幂等保护

# 反审核检查
1. 单据是否存在
2. 单据状态是否允许反审核
3. 是否存在依赖下游单据
4. 是否已产生库存/成本影响
5. 反审核是否完整回滚
6. 是否恢复状态
7. 是否写日志

# 输出要求
- 给出 approve(Long id) 与 unApprove(Long id) 最终版
- 抽公共方法，避免逻辑散乱
- 标注关键回滚点

2）`.claude/skills/ddl-design/SKILL.md`

---
name: ddl-design
description: 生成生产级 MySQL 8.0 DDL，适用于升鲜宝各业务域
---

# 目标
输出完整、规范、可执行的 DDL。

# 规范
- MySQL 8.0
- 字段不要用 is_ 前缀
- 必须有表注释、字段注释
- 合理设置主键、唯一索引、查询索引
- 金额 decimal 精度要合理
- 时间字段优先 bigint 或 datetime，保持项目现有风格

# 输出格式
1. 表设计说明
2. CREATE TABLE
3. 索引说明
4. 数据字典
5. 关键约束说明

3）`.claude/skills/mp-refactor/SKILL.md`

---
name: mp-refactor
description: 将常规 CRUD / 查询逻辑按最小改动重构为 MyBatis-Plus 风格
---

# 目标
在不破坏现有结构的前提下，把简单查询、更新、删除逻辑尽量改为 MP Wrapper 风格。

# 规则
- 不随意删除 XML，除非确认无复杂 SQL
- 保留原有返回结构
- 保证可读性
- 排序必须白名单化
- 分页逻辑保持一致
- 避免 N+1 查询

# 输出格式
- 原问题
- 重构点
- 最终代码
- 风险说明

4）`.claude/skills/java-domain-review/SKILL.md`

---
name: java-domain-review
description: Java 企业级项目代码审查与补齐
---

# 关注点
- 分层是否清晰
- DTO / Entity / Query / VO 是否职责分离
- Service 是否过重
- 事务边界是否正确
- 异常码是否统一
- 状态机是否健壮
- 日志是否足够
- 命名是否贴近业务

九、`.claude/commands/` 自定义命令模板

Claude Code 支持自定义 commands。你可以把高频动作沉淀成命令文件。

`.claude/commands/scan-project.md`

请扫描当前项目，并输出：
模块结构
技术栈
启动入口
数据访问层实现方式
主要业务域
高风险点
推荐先阅读的 10 个文件

`.claude/commands/fix-build.md`

请执行以下流程：
阅读最近改动文件
分析编译错误
给出最小修复方案
直接修改代码
输出修复清单
给出剩余风险

`.claude/commands/add-javadoc.md`

请为当前选中的 Java 类补充生产级 Javadoc：
- 类注释
- 关键方法注释
- 参数与返回值说明
- 保持当前代码结构不变

`.claude/commands/review-diff.md`

请审查当前 git diff：
归纳改动目的
找出潜在 bug
找出事务/空指针/并发/状态流转问题
给出修改建议
如果问题明确，直接给出补丁代码

十、`GEMINI.md` 模板

Gemini Code Assist 适合你在 IntelliJ 里做“近场协作”。它支持 IntelliJ 的 chat、生成代码、completion；Agent mode 在 IntelliJ 里可用，但目前仍属预览能力。

你可以在仓库里放一个 GEMINI.md，虽然这不是 Gemini 的官方必须文件，但非常适合作为团队约定文档：

# 升鲜宝项目 Gemini 使用约定

## 适合让 Gemini 做的事
- 解释当前类 / 当前方法
- 为当前接口补参数校验
- 生成单元测试
- 为当前 SQL / XML / Mapper 做局部优化
- 给当前异常堆栈做定位建议
- 对当前文件进行小范围重构

## 不适合直接让 Gemini 独立完成的事
- 跨模块大规模重构
- 未读完整调用链就直接改全仓
- 批量修改几十个文件
- 复杂审核 / 反审核闭环设计
- 涉及大量 DDL 级别结构变更

## 默认提示要求
- 保持最小改动
- 不要改 controller 签名
- 使用 `@Resource`
- 优先 MP Wrapper
- 输出最终可复制代码，不要只讲思路

十一、ChatGPT Project 指令模板

ChatGPT Projects 可以把聊天、项目文件和 custom instructions 聚合成一个长期上下文，非常适合你做“升鲜宝主仓”。如果你想再进一步，也可以建自定义 GPT；OpenAI 官方也支持在 GPT 里配置 instructions、knowledge 和 capabilities。

项目名建议

升鲜宝-Java主仓-架构与交付

Project Instructions 模板

你是我的 Java 企业级项目架构助手、代码审查助手、DDL 设计助手、交付文档助手。

项目背景：
- 系统名称：升鲜宝供应链管理系统
- 技术栈：Java + Spring Boot + MyBatis-Plus + MySQL 8.0 + Maven
- 开发工具：IntelliJ IDEA（Windows）
- 项目风格：传统分层，不轻易新增层
- 目标：生产级、可上线、最小 Diff Patch

硬性规范：
1. 优先最小改动，避免无关重构
2. 优先使用 @Resource，不用 @Autowired
3. 优先 MyBatis-Plus Wrapper，复杂 SQL 再考虑 XML
4. Controller 签名尽量兼容
5. 数据库字段不要出现 is_ 前缀
6. DDL 必须包含注释、索引、约束说明
7. 审核 / 反审核必须对称设计
8. 涉及库存 / 成本 / 流水 / 财务时，必须考虑一致性与回滚
9. 输出代码时优先给最终版，不要只给伪代码
10. 需要时给出验证点、风险点、上线注意事项

你需要优先帮助我完成：
- Java 代码补齐
- 业务流程设计
- 审核 / 反审核闭环
- DDL / 数据字典
- 技术方案 / PRD / 白皮书
- 差异审查 / 风险排查

回答风格：
- 直接、专业、工程化
- 少空话，多成品
- 默认给可复制结果

十二、ChatGPT 自定义 GPT 指令模板

如果你要做一个“升鲜宝专用 GPT”，可以直接把下面这段放进 GPT 的 Instructions。OpenAI 官方支持给 GPT 配置 instructions、knowledge files 和 capabilities。

你是“升鲜宝企业级研发助手”。

你的角色：
- Java / Spring Boot 架构顾问
- MyBatis-Plus 与 MySQL 8.0 设计顾问
- 审核/反审核闭环设计顾问
- 供应链/WMS/HWMS/OMS/Finance 领域建模顾问
- 交付文档顾问

你的输出原则：
- 优先最小改动
- 优先最终代码
- 优先生产级风格
- 优先保持现有目录结构
- 避免凭空虚构表与字段
- 涉及数据库时补齐索引、注释、约束
- 涉及审核/反审核时补齐状态机、幂等、防重、回滚逻辑
- 涉及库存/成本时考虑主表、流水、FIFO/移动加权等影响
- 所有建议尽量贴近企业项目真实可落地方案

当用户给出代码时：
1. 先分析问题
2. 再给修改思路
3. 最后输出最终代码

当用户给出业务需求时：
1. 先拆业务域
2. 再给表设计/流程/状态机
3. 最后给 DDL 或代码落地方案

十三、给 Claude / Gemini / ChatGPT 的提示词模板

A. 给 Claude Code 的模板

Claude Code 很适合“仓库级任务 + 执行命令 + 改多个文件 + 修到能跑”。官方也给了探索代码库、调试、重构、测试等常见工作流。

1）扫描项目

先不要改代码。请先扫描当前项目，并输出：
模块结构
启动入口
核心业务域
主要表与调用链
我应该先看的 10 个文件
当前最危险的设计点

2）修编译

请基于当前代码改动，修复编译错误。
要求：
- 最小 Diff
- 不改变 controller 签名
- 优先沿用现有结构
- 改完后列出修改文件和验证方法

3）做审核/反审核

请为当前单据补齐审核与反审核闭环。
要求：
- approve / unApprove 对称
- 防重复审核、防重复反审核
- 补齐事务
- 补齐状态校验
- 考虑库存、成本、流水、日志回滚
- 输出最终生产级代码

4）批量补 Javadoc

请扫描当前模块的 service、facade、enum，补齐生产级 Javadoc。
要求：
- 不改业务逻辑
- 注释风格统一
- 方法说明贴近业务语义

B. 给 Gemini 的模板

1）解释当前类

请解释当前类的职责、主要调用链、风险点，并指出最值得重构的 3 个地方。

2）生成单测

请为当前 Service 的核心方法生成 JUnit 测试用例。
要求：
- 覆盖成功场景
- 覆盖参数非法
- 覆盖状态不允许
- 覆盖异常场景

3）局部重构

请仅重构当前方法。
要求：
- 保持方法签名不变
- 提高可读性
- 提取必要私有方法
- 不改变外部行为

4）定位异常

请结合当前异常堆栈和当前类代码，分析最可能的 3 个根因，并给出最小修复建议。

C. 给 ChatGPT 的模板

1）架构方案

基于以下业务需求，给出：
领域划分
模块边界
核心表设计
关键流程图
状态机
风险点
最终落地建议

2）DDL 设计

按 MySQL 8.0 生成完整 DDL。
要求：
- 含表注释、字段注释、索引
- 不要用 is_ 前缀字段
- 给出数据字典
- 说明关键唯一约束与查询索引

3）代码审查

请审查下面这段代码：
逻辑问题
空指针风险
并发问题
状态流转问题
事务问题
可维护性问题
给出最终改进版代码

4）交付文档

请把以下技术方案整理成正式交付文档结构：
- 背景
- 目标
- 范围
- 架构
- 表设计
- 接口
- 流程
- 风险
- 里程碑

十四、IntelliJ 实操建议

IntelliJ 的嵌入终端可直接跑 Git、Java 工具和命令行工具；终端起始目录和终端设置也能在 IDE 里调整。

你的实际操作建议是：

日常模式

左边开项目
右边开 Gemini Chat
下方开 IntelliJ Terminal
Claude Code 从 Terminal 启动
ChatGPT 放浏览器单独开一个项目页

工作切分

当前文件问题：先问 Gemini
跨模块问题：交给 Claude Code
方案与文档：交给 ChatGPT
编译、调试、断点：只在 IntelliJ 做

十五、日常工作流模板

场景 1：新接手一个模块

Claude：扫描项目与调用链
Gemini：解释当前核心类
ChatGPT：整理成领域结构与改造路线
IntelliJ：开始动手改

场景 2：修一个线上 bug

IntelliJ 复现
Gemini 看当前异常附近代码
Claude 做跨文件修复与回归修改
ChatGPT 做“事故复盘 / 风险补丁建议”

场景 3：做一个完整新模块

ChatGPT：先出 PRD / DDL / 流程 / 状态机
Claude：按现有项目结构落代码骨架
Gemini：逐个类补局部实现
IntelliJ：联调、修编译、测接口

十六、最推荐的落地顺序

第一步

先在仓库加这 5 个文件：

CLAUDE.md
.claude/settings.json
.claude/skills/java-domain-review/SKILL.md
GEMINI.md
CHATGPT-PROJECT.md

第二步

在 ChatGPT 建一个 Project，把这些文档传进去：

你的表结构
现有规范
核心模块设计
常见 DDL 模板
历史交付文档

Projects 可以长期保留项目上下文；文件上传也可用于查找、提取和总结。文件会保留到项目或 GPT 被删除为止，之后按官方说明清理。

第三步

IntelliJ 里装 Gemini Code Assist，并登录。Google 官方文档给出了 IDE 中点击扩展、登录 Google 账号的流程；IntelliJ 中也支持 chat、code generation，Gemini 3.1 Pro / 3.0 Flash 还可用于 agent mode、chat 和 code generation。

第四步

本地用 Claude Code：

用它扫描项目
先只读不改
再逐步开放编辑权限
本地 Bash 权限先保守放开

Claude Code 官方支持 CLI 配置、settings 文件、hooks、skills，以及仓库探索、调试、重构、测试等工作流。

十七、`CHATGPT-PROJECT.md` 文件成品

# 升鲜宝 ChatGPT Project 使用说明

## 项目用途
用于沉淀以下内容：
- 架构方案
- DDL 设计
- PRD 文档
- 审核/反审核流程
- 状态机
- 错误码规范
- 技术白皮书
- 交付文档

## 建议上传资料
- 数据库表结构
- 历史设计文档
- 领域说明
- 关键 Java 类
- 旧版 DDL
- API 文档
- 业务流程截图

## 建议提问方式
- “基于这份表结构，生成完整 DDL 设计方案”
- “基于这组 Java 类，补充审核/反审核闭环”
- “把这份技术方案整理成正式交付文档”
- “分析这段代码的事务边界和状态机风险”

十八、你现在最小可用版

如果你不想一下子配很多，先做这个最小组合就行：

根目录放 CLAUDE.md
.claude/settings.json
.claude/skills/java-domain-review/SKILL.md
仓库放 GEMINI.md
ChatGPT 建一个升鲜宝 Project

这 5 步做完，你的基本协作链路就能跑起来了。Claude Code 的项目上下文、skills 和 settings 都能生效；Gemini 能在 IntelliJ 里承担当前文件协作；ChatGPT 能沉淀长期项目知识。

posted @ 2026-03-26 10:26 升鲜宝生鲜供应链系统阅读(6) 评论(0) 收藏举报

刷新页面返回顶部

升鲜宝生鲜配送供应链管理系统源代码_【JAVA开源版】升鲜宝-杭州生鲜配送企业接地气的解决方案_

专注于 生鲜配送供应链、连锁门店收银系统、 O2O 后端配货解决方案系统建设 官方网站 https://sxbscm.sxbscm.com 升鲜宝供应链管理系统