# AI Coding

**Repository Path**: bill1012/ai-coding

## Basic Information

- **Project Name**: AI Coding
- **Description**: AI Coding：专注于AI编程技术的开源项目，提供代码自动生成、模型训练与部署等使用经验
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claude Code × Java Spring 重构实战系列文章

> 深入学习如何使用 Claude Code 对 Java Spring 架构项目进行重构

---

## 文章目录

### [第一篇：Claude Code 入门 —— 理解它如何"读懂"你的 Java 项目](./article-01-claude-code-introduction.md)
**核心内容：**
- Claude Code vs GitHub Copilot 的本质区别
- 工具调用循环（Agentic Loop）工作原理
- Claude Code 如何理解 Spring 项目结构（注解、分层、配置）
- 建立 CLAUDE.md 项目记忆文件
- 内置安全机制介绍

**适合人群：** 初次接触 Claude Code 的 Java 开发者

---

### [第二篇：Claude Code 在 Spring 项目中的实战工作流](./article-02-spring-workflow.md)
**核心内容：**
- 重构前的准备（项目地图生成、测试基线建立）
- 五步重构法：Define → Plan → Execute → Verify → Cleanup
- 处理循环依赖的方法
- 数据库迁移（Entity 和 Repository 安全重构）
- 配置重构（消除硬编码，引入 @ConfigurationProperties）
- 团队协作场景

**适合人群：** 准备动手重构的工程师

---

### [第三篇：Spring 项目重构的高级技巧与最佳实践](./article-03-advanced-techniques.md)
**核心内容：**
- 上下文窗口管理（REFACTORING_LOG.md）
- 测试驱动重构：特征测试、影子测试、契约测试
- N+1 问题扫描与修复
- 缓存策略重构
- DDD 架构引入（领域事件、聚合根设计）
- 统一异常处理体系
- 安全漏洞扫描（SQL注入、敏感信息泄露）

**适合人群：** 有基础经验、希望深入的工程师

---

### [第四篇：完整案例演示 —— 用 Claude Code 驱动单体到微服务的重构](./article-04-monolith-to-microservices.md)
**核心内容：**
- 完整的 8 周重构案例（ShopMax 电商平台）
- 绞杀者模式（Strangler Fig Pattern）实践
- Maven 多模块结构迁移
- 循环依赖发现与解决（真实对话还原）
- 数据所有权分析与数据层分离
- 建立模块间 API 契约（为微服务化铺路）
- 支付服务提取为独立微服务（双写验证）
- 团队经验教训总结

**适合人群：** 面临大型重构任务的技术负责人和架构师

---

### [第五篇：Claude Code Prompt 工程 —— 让 AI 精准理解你的意图](./article-05-prompt-engineering.md)
**核心内容：**
- 好/坏提示词对比分析
- 场景化提示词模板库（分析/实现/重构/调试）
- 高阶技巧：先思考后执行、渐进式授权、设定停止条件
- Spring 特有提示词技巧（版本指定、注解规范、ORM混用）
- 建立项目术语表（与 AI 共同语言）
- 常见提示词错误避免
- 效率提升技巧（批量处理、并行工作流）
- 常用提示词速查表

**适合人群：** 希望提升 AI 使用效率的所有工程师

---

## 推荐阅读顺序

```
初学者路径：
第一篇 → 第二篇 → 第五篇（先学用法，再学技巧）

进阶路径：
第一篇 → 第二篇 → 第三篇 → 第五篇

架构师路径：
第一篇 → 第四篇 → 第三篇 → 第五篇
```

---

## 核心配套文件模板

### CLAUDE.md 模板
每个项目根目录建议创建 `CLAUDE.md`，让 Claude Code 记住项目知识：

```markdown
# CLAUDE.md

## 技术栈
- Spring Boot [版本]
- JDK [版本]
- [ORM框架]
- [缓存]
- [消息队列]

## 架构约定
- [分层规范]
- [事务规范]
- [异常处理规范]

## 命名规范
- [方法命名]
- [类命名]

## 禁止修改的区域
- [路径1]（原因）
- [路径2]（原因）

## 当前重构目标
- [ ] 待办1
- [ ] 待办2
```

### REFACTORING_LOG.md 模板
长期重构项目建议维护 `REFACTORING_LOG.md`：

```markdown
# 重构进度日志

## 总体目标
[一句话描述]

## 已完成 ✅
- [日期]：[完成内容]

## 进行中 🔄
- [任务名]
  - ✅ 步骤1
  - 🔄 步骤2（当前）
  - ⬜ 步骤3

## 已知问题 ⚠️
- [问题描述]（待解决）

## 不要动的地方 🚫
- [路径]（原因）
```

---

*系列文章写作时间：2026年3月*