Claude Code 项目管理标准化指南

让 AI 成为你的项目经理：通过标准化的文档和命令，实现项目进度自动跟踪、文档自动更新、任务智能调度

目录

为什么需要项目管理标准化？

⚠️ 核心痛点：有 AI 也没用？

你是否遇到这些情况：

❌ 场景 1：AI 不知道你做到哪了

你: "继续开发用户反馈功能"
AI: "好的，我来实现用户反馈的 Entity..."
你: "等等！Entity 我昨天就写完了！你怎么又重新写？"
AI: "抱歉，我不知道你已经完成了哪些部分..."

原因：没有项目状态记录，AI 每次都从零开始，无法延续上下文。

❌ 场景 2：AI 不知道项目有哪些模块

你: "帮我看看还有哪些功能没做完"
AI: "我需要扫描整个项目...（扫描 5 分钟）...发现了这些模块..."
你: "不对，这些都是测试代码，核心业务在 ruoyi-business 目录！"
AI: "抱歉，我没有项目结构的上下文..."

原因：没有项目结构概览，AI 盲目扫描，浪费时间还不准确。

❌ 场景 3：AI 生成的进度报告不准确

你: "项目完成度多少了？"
AI: "扫描代码...大概 60%？"
产品经理: "给个准确数字！"
你: "..."

原因：没有标准化的完成度定义，AI 只能大概估算。

❌ 场景 4：开发完忘记更新文档

你: （开发完用户反馈功能，提交代码）
第二天...
你: "昨天做了什么来着？"
你: （翻 Git 记录）
你: "哦，用户反馈。对了，文档忘记更新了..."
你: （手动整理文档 30 分钟）

原因：没有自动化的文档更新机制，全靠手动维护。

❌ 场景 5：团队协作时互相不知道进度

团队成员 A: "我在做用户管理"
团队成员 B: "我也在做用户管理..."
第二天发现：代码冲突了！

原因：没有统一的项目状态管理，团队成员各自为战。

💡 核心问题：AI 再强大，也需要上下文！

关键认知：

  • ✅ AI 可以帮你写代码
  • ✅ AI 可以帮你调试错误
  • ❌ 但 AI 不知道你的项目做到哪了
  • ❌ AI 不知道你的项目有哪些模块
  • ❌ AI 不知道你昨天做了什么

解决方案：

给 AI 提供标准化的项目管理上下文，让 AI 成为你的项目经理，而不仅仅是代码助手。

传统项目管理的痛点

即使不考虑 AI，传统项目管理也有这些问题：

❌ 不知道做到哪了

  • 每次打开项目都要翻 Git 记录回忆上下文
  • 无法准确回答"项目完成度是多少"
  • 进度评估全靠感觉：“大概60%吧…”

❌ 文档更新麻烦

  • 开发完功能经常忘记更新文档
  • 手动整理进度报告耗时费力
  • 文档和代码经常不同步

❌ 任务管理混乱

  • 待办事项散落在聊天记录、笔记本里
  • 不知道接下来该做什么
  • 缺少优先级判断

❌ 团队协作困难

  • 团队成员不知道你在做什么
  • 需要开会对齐进度
  • 交接项目需要大量时间

标准化项目管理带来的改变

✅ 进度清晰

  • AI 自动扫描代码，精确统计完成度
  • 从"大概60%“到"精确72%”
  • 按模块、业务域分类展示

✅ 文档自动更新

  • 开发完一个功能，一条命令自动更新所有文档
  • 不再遗漏任何进度信息
  • 文档和代码完全同步

✅ 智能任务调度

  • AI 分析当前状态，建议下一步该做什么
  • 自动扫描 TODO/FIXME 注释
  • 按优先级排序任务

✅ 团队协作高效

  • 随时生成进度报告，无需开会对齐
  • 新成员 1 分钟了解项目状态
  • 项目交接轻松自如

效率提升对比：

传统方式 标准化方式 提升
2小时15分钟/天 10分钟/天 13倍

核心架构

项目管理标准化的核心是：三大文档 + 四大命令

📚 三大标准化文档

docs/
├── 需求文档.md    # 明确要做什么
├── 项目状态.md    # 记录做到哪了（AI 自动更新）
└── 待办清单.md    # 规划接下来做什么
1. 需求文档 - 明确"要做什么"

作用：

  • 团队对需求达成一致
  • AI 可以关联代码实现和需求
  • 需求变更有迹可循

核心字段：

  • 需求编号（REQ-001）
  • 优先级（高/中/低）
  • 预计时间
  • 验收标准

示例：

## 1. 功能需求

- [ ] REQ-001: 用户管理模块
  - 优先级: 高
  - 预计时间: 5天
  - 状态: 待开发
  - 描述: 实现用户的增删改查、角色分配等功能
  - 验收标准:
    - [ ] 支持用户增删改查
    - [ ] 支持角色分配
    - [ ] 接口响应时间 < 500ms
2. 项目状态 - 记录"做到哪了" ⭐⭐⭐⭐⭐

这是最核心的文档，记录已完成、进行中、待办任务。

关键特性：

  • ⭐ AI 自动更新：开发完运行 /update-status，AI 自动扫描代码更新文档
  • ⭐ 精确进度：按 Maven 模块、业务域分类统计，计算完成百分比
  • ⭐ 完整记录：每个任务包含完成时间、耗时、说明

文档结构：

# 项目状态

最后更新: 2025-01-14 15:30

## 📊 当前状态
- 项目阶段: 开发中
- 整体进度: 72%
- 下一步计划: 完成用户反馈前端页面

## ✅ 已完成
- [x] 用户管理模块 (2025-01-10)
  - 耗时: 2天
  - 说明: 完成 Entity/Service/Controller，支持增删改查

## 🚧 进行中
- [ ] 用户反馈模块 (开始: 2025-01-12)
  - 进度: 70%
  - 预计完成: 2025-01-15
  - 当前工作: 正在实现 Service 层

## 📋 待办
- [ ] 添加单元测试
  - 优先级: 中
  - 预计工作量: 2天
3. 待办清单 - 规划"接下来做什么"

按优先级组织任务，包含高/中/低优先级、进行中、最近完成。

文档结构：

# 待办事项清单

## 🔥 高优先级（紧急重要）
- [ ] 修复生产环境登录异常
  - 截止日期: 2025-01-15
  - 描述: 用户反馈无法登录系统

## 📌 中优先级（重要不紧急）
- [ ] 实现用户权限管理功能
  - 截止日期: 2025-01-20

## 💡 低优先级（可延后）
- [ ] 优化首页加载速度
  - 截止日期: 2025-02-01

## 🔄 进行中
- [ ] 开发数据统计模块（进度: 60%）
  - 开始日期: 2025-01-10
  - 预计完成: 2025-01-18

## ✅ 最近完成
- [x] 实现用户登录功能 (完成于 2025-01-10)
  - 耗时: 2天

🤖 四大项目管理命令

通过这四个命令，AI 成为你的项目经理。

命令 功能 使用场景
/start 快速了解项目状态 新窗口、休息后、切换任务
/progress 查看详细项目进度 产品问进度、写周报、自查进度
/next 获取下一步建议 任务完成后、不知道做什么
/update-status 自动更新项目状态 开发完功能、完成重要任务

快速开始

第一步：初始化项目文档

在项目根目录运行：

/init-docs

AI 会自动创建三大文档模板：

  • docs/需求文档.md
  • docs/项目状态.md
  • docs/待办清单.md

第二步：配置项目结构

在 CLAUDE.md 中定义项目资源概览，让 AI 知道你的项目有哪些模块：

## 📚 项目资源概览

### 后端已有功能模块
| 模块 | 说明 | 位置 |
|------|------|------|
| ✅ 用户管理 | 用户增删改查 | ruoyi-business/user/ |
| ✅ 权限管理 | 角色权限控制 | ruoyi-business/auth/ |

### 前端已有页面
| 页面 | 路由 | 位置 |
|------|------|------|
| ✅ 用户管理 | /user | src/views/user/ |

### 移动端已有页面
| 页面 | 路径 | 位置 |
|------|------|------|
| ✅ 个人中心 | pages/user/index | pages/user/ |

第三步：开始使用

现在你可以使用四大管理命令了！

/start    # 快速了解项目状态

命令详解

命令 1：/start - 快速进入工作状态

使用场景
  • 新打开项目窗口
  • 休息一段时间后回到项目
  • 切换任务后需要回忆上下文
执行过程

当你输入 /start 后，AI 会自动：

  1. 识别项目类型和技术栈
  2. 查看最近 3 条 Git 提交
  3. 检查代码状态（是否有未提交修改）
  4. 扫描业务模块
  5. 统计 TODO/FIXME 数量
输出示例
# 👋 欢迎回到项目

## 📂 项目信息
- **项目名称**：RuoYi-Plus-Uniapp
- **技术栈**：Spring Boot + Vue3 + Uniapp
- **主要功能**：企业级管理系统 + 移动端应用

## 🕐 最近动态
feat(feedback): 完成用户反馈模块后端开发 - 2小时前

## 📊 当前状态
- 代码状态：⚠️ 有未提交修改
- **业务模块**：检测到 2 个业务模块
  - 🔹 ruoyi-business: 3 个 TODO
  - 🔹 ruoyi-iot: 1 个 TODO
- 框架状态：稳定

## 🎯 你可以：
1. 输入 `/progress` - 查看详细的项目进度
2. 输入 `/next` - 获取下一步开发建议
3. 直接告诉我："继续开发用户反馈模块"
核心价值
  • ✅ 1 分钟快速了解项目状态
  • ✅ 不需要翻 Git 记录
  • ✅ 立刻知道接下来该做什么

命令 2：/progress - 查看详细项目进度

使用场景
  • 产品经理问进度
  • 周报、月报需要数据
  • 自己想了解整体完成情况
执行过程

当你输入 /progress 后，AI 会自动：

  1. 扫描项目结构（后端/前端/移动端）
  2. 统计功能模块数量
  3. 检查模块完整性（Entity/BO/VO/Service/DAO/Controller/Mapper）
  4. 计算每个模块的完成度百分比
  5. 生成详细进度报告
输出示例
# 📊 项目进度报告

## 🎯 项目概况
- 项目名称：RuoYi-Plus-Uniapp
- 技术栈：Spring Boot + Vue3 + Uniapp
- 当前阶段：开发中
- **整体进度：72%**

## 📈 功能模块进度

### 后端模块（按 Maven 模块统计）

#### 🔹 ruoyi-business（已实现 2 个业务域）

##### base 业务域 (100%)
1. ✅ 广告管理 - Ad
   - 📄 Entity: 已完成
   - 🔧 Service: 已完成
   - 🗄️ DAO: 已完成
   - 🌐 Controller: 已完成

2. ✅ 平台配置 - Platform
   - 📄 Entity: 已完成
   - 🔧 Service: 已完成
   - 🗄️ DAO: 已完成
   - 🌐 Controller: 已完成

##### ai 业务域 (70%)
1. ✅ AI对话管理 - Chat
   - 📄 Entity: 已完成
   - 🔧 Service: 已完成
   - 🗄️ DAO: 已完成
   - 🌐 Controller: 已完成

2. 🚧 用户反馈 - Feedback
   - 📄 Entity: 已完成
   - 🔧 Service: 已完成
   - 🗄️ DAO: 已完成
   - 🌐 Controller: 进行中 (70%)

#### 🔹 ruoyi-iot（已实现 1 个功能）
1. ✅ 设备管理 - Device
   - 完成度: 100%

### 前端页面（已实现 5 个）
1. ✅ 广告管理 - /business/base/ad
2. ✅ 平台配置 - /business/base/platform
3. 🚧 用户反馈 - /business/base/feedback (开发中)

### 移动端页面（已实现 3 个）
1. ✅ 个人中心 - pages/user/index
2. ✅ 首页 - pages/index/index
3. 🚧 反馈页面 - pages/feedback/index (开发中)

## 📝 待完成事项
1. [ ] 完成用户反馈模块 Controller
2. [ ] 实现用户反馈前端页面
3. [ ] 添加单元测试

## 🔍 代码质量分析
- 代码规范性：良好（严格遵循 CLAUDE.md 规范）
- 注释完整度：待补充（建议添加业务逻辑注释）
- TODO/FIXME：4 个待处理
核心价值
  • ✅ 精确的进度数据：不是"大概60%“，而是"精确72%”
  • ✅ 自动生成报告：1 分钟生成，可直接复制给产品经理
  • ✅ 按模块分类：清晰了解每个模块的完成情况
  • ✅ 识别模块完整性：自动检查是否缺少 DAO、Service 等

命令 3：/next - 获取下一步建议

使用场景
  • 完成一个任务，不知道接下来做什么
  • 想知道哪些任务优先级最高
  • 需要 AI 帮你规划下一步
执行过程

当你输入 /next 后，AI 会自动：

  1. 查看最近 5 条 Git 提交
  2. 扫描所有业务模块的 TODO/FIXME 注释
  3. 分析当前开发阶段
  4. 根据优先级规则排序任务
  5. 给出具体的行动建议
输出示例
# 🎯 下一步建议

## 📌 当前状态
- 最近在做：用户反馈模块后端开发
- 开发阶段：中期（核心功能开发）
- 代码状态：正常

## 🚀 建议优先级

### 🔴 高优先级（必须马上做）

1. **完成用户反馈模块 Controller**
   - 原因：Service 层已完成，需要提供接口
   - 影响：前端无法对接
   - 预计耗时：1 小时
   - 位置：`ruoyi-business/base/controller/FeedbackController.java`
   - 建议：参考 `AdController.java` 的实现

### 🟡 中优先级（近期要做）

1. **实现用户反馈前端页面**
   - 建议时间：本周内
   - 位置：`plus-ui/src/views/business/base/feedback/`
   - 依赖：需要后端接口完成

2. **处理 ruoyi-business/ai 模块的 3 个 TODO**
   - `ChatServiceImpl.java:45` - 优化AI响应速度
   - `RagServiceImpl.java:78` - 实现向量检索
   - `ChatController.java:120` - 添加参数校验

### 🟢 低优先级（可以考虑）

1. **添加单元测试**
   - 说明：提升代码质量，不急
   - 建议时间：本月内

2. **优化前端首页加载速度**
   - 当前加载时间：3s
   - 目标：< 2s

## 💡 具体行动建议

### 建议接下来：

**第一步**：完成 FeedbackController（参考 AdController）
- 预计耗时：1 小时
- 依赖：Service 层已完成

**第二步**：提交代码后运行 `/update-status` 更新项目状态

**第三步**：开始开发前端页面

## 📝 注意事项

- ⚠️ 开发 Controller 时注意遵循 CLAUDE.md 规范
- ⚠️ 确保使用 `@SaCheckPermission` 注解控制权限
- ⚠️ 接口需要添加 `@OpenApi` 注解生成文档
核心价值
  • ✅ 智能任务调度：AI 帮你排优先级
  • ✅ 具体可执行：不是"继续开发"，而是"完成 XX 文件的 XX 方法"
  • ✅ 不遗漏任务：扫描代码中的 TODO 注释
  • ✅ 考虑依赖关系：先完成 Service 再开发 Controller

命令 4：/update-status - 自动更新项目状态 ⭐⭐⭐⭐⭐

最强大的功能！开发完一个功能，一条命令自动更新所有文档

使用场景
  • 开发完一个功能模块
  • 完成一个重要任务
  • 想更新项目进度
执行过程

当你输入 /update-status 后，AI 会自动：

  1. 读取现有 docs/项目状态.md
  2. 查看最近 10 条 Git 提交
  3. 扫描所有业务模块（Controller/Service/DAO/Entity）
  4. 统计每个模块的完成度
  5. 扫描 TODO/FIXME 注释
  6. 智能更新文档：
    • 将新完成的任务移到"已完成"区域
    • 更新"进行中"任务的进度
    • 添加新发现的待办任务
    • 更新整体进度百分比
    • 更新时间戳
输出示例
# 📝 项目状态更新报告

## 本次更新内容
- ✅ 新增已完成任务：1 项
- 🚧 更新进行中任务：2 项
- 📋 新增待办任务：1 项

## 主要变更

### 1. 用户反馈模块：从进行中 → 已完成
   - 完成时间：2025-01-14 15:30
   - 完成内容：Entity + BO + VO + Service + DAO + Controller
   - Git 提交：`feat(feedback): 完成用户反馈模块后端开发`

### 2. 前端页面开发：新增进行中任务
   - 当前进度：30%
   - 位置：`plus-ui/src/views/business/base/feedback/`
   - 预计完成时间：2025-01-16

### 3. 新增待办任务：单元测试
   - 来源：代码扫描发现缺少测试覆盖
   - 优先级：中
   - 位置：`ruoyi-business/base/`

## 📊 进度变化

- 整体进度：65% → **72%** ↑ (+7%)
- ruoyi-business/base: 80% → **100%**
- ruoyi-business/ai: 60% → **70%**

---

✅ 文档已更新：`docs/项目状态.md`
更新后的项目状态文档
# 项目状态

最后更新: 2025-01-14 15:30

## 📊 当前状态
- 项目阶段: 开发中
- 整体进度: **72%** ↑ (+7%)
- 下一步计划: 完成用户反馈前端页面

## ✅ 已完成

- [x] 广告管理模块 (2025-01-10)
  - 耗时: 2天
  - 说明: 完成 Entity/Service/Controller，支持增删改查

- [x] 平台配置模块 (2025-01-11)
  - 耗时: 1天
  - 说明: 完成微信、支付宝平台配置管理

- [x] 用户反馈模块 - 后端 (2025-01-14) 🆕
  - 耗时: 2天
  - 说明: 完成 Entity/Service/Controller，支持增删改查、状态管理
  - Git: `feat(feedback): 完成用户反馈模块后端开发`

## 🚧 进行中

- [ ] 用户反馈模块 - 前端 (开始: 2025-01-14)
  - 进度: 30%
  - 预计完成: 2025-01-16
  - 当前工作: 正在实现列表页面
  - 位置: `plus-ui/src/views/business/base/feedback/`

- [ ] AI 对话模块优化 (开始: 2025-01-12)
  - 进度: 60%
  - 预计完成: 2025-01-18
  - 当前工作: 优化 AI 响应速度

## 📋 待办

- [ ] 添加单元测试 🆕
  - 优先级: 中
  - 预计工作量: 2天
  - 模块: ruoyi-business/base/

- [ ] 实现移动端用户反馈页面
  - 优先级: 高
  - 预计工作量: 1天
  - 依赖: 后端接口已完成

## 📈 里程碑

- [x] 基础模块开发完成 (2025-01-14)
- [ ] 前端页面开发完成 (预计 2025-01-18)
- [ ] 测试上线 (预计 2025-01-25)
核心价值
  • ✅ 再也不用手动维护文档：AI 自动更新
  • ✅ 精确的进度数据：自动扫描代码，计算完成度
  • ✅ 完整的变更记录：每次更新都有报告
  • ✅ 智能识别新任务：扫描 TODO 注释自动添加待办
  • ✅ 保留手动内容：不会覆盖用户手动添加的信息

完整工作流示例

以开发"用户反馈"功能为例，展示一个完整的工作周期。

周一早上 9:00 - 开始工作

操作：

/start

AI 响应：

👋 欢迎回到项目

## 📂 项目信息
- 项目名称：RuoYi-Plus-Uniapp
- 技术栈：Spring Boot + Vue3 + Uniapp

## 🕐 最近动态
feat(platform): 完成平台配置模块 - 昨天 17:30

## 📊 当前状态
- 代码状态：✅ 无未提交修改
- 业务模块：ruoyi-business (2个TODO)

## 🎯 建议
上周完成了平台配置模块
本周计划：开发用户反馈模块

价值：1 分钟了解项目状态，立刻进入工作状态

周一早上 9:05 - 规划任务

操作：

/next

AI 响应：

🎯 下一步建议

## 🔴 高优先级
1. 开发用户反馈模块
   - 后端：Entity → BO/VO → Service → DAO → Controller
   - 预计耗时：2天
   - 参考模块：AdController.java

## 建议接下来：
1. 先设计数据库表结构
2. 生成后端代码（参考 CLAUDE.md 规范）
3. 开发完运行 `/update-status` 更新进度

价值：明确接下来 2 天的工作内容和顺序

周一 - 周二 - 开发中

专注于开发"用户反馈"功能的后端代码：

  • Entity、BO、VO
  • Service、DAO
  • Controller

周二下午 15:00 - 开发完成

提交代码：

git add .
git commit -m "feat(feedback): 完成用户反馈模块后端开发"
git push

更新项目状态：

/update-status

AI 响应：

📝 项目状态更新报告

## 本次更新内容
- ✅ 新增已完成任务：1 项（用户反馈模块 - 后端）
- 📋 新增待办任务：2 项（前端页面、单元测试）

## 主要变更
1. 用户反馈模块后端：已完成 ✅
2. 整体进度：65% → 72%
3. 下一步：开发前端页面

文档已更新：docs/项目状态.md

价值：

  • 1 分钟自动更新所有文档
  • 不会遗漏任何进度信息
  • 清晰知道下一步做什么

周三早上 9:00 - 产品经理问进度

产品经理：“项目进度怎么样了？”

操作：

/progress

AI 生成报告：

📊 项目进度报告

## 整体进度：72%

### 后端模块
- ruoyi-business/base: 100%
- ruoyi-business/ai: 70%

### 前端页面
- 已完成：5 个
- 进行中：1 个（用户反馈）

### 本周完成
- ✅ 平台配置模块（周一）
- ✅ 用户反馈模块 - 后端（周二）

### 下周计划
- 用户反馈模块 - 前端
- 单元测试

操作：复制报告发给产品经理

价值：

  • 1 分钟生成精确的进度报告
  • 数据准确，不是凭感觉
  • 可直接用于周报、汇报

效果对比

时间对比

任务 传统方式 标准化方式 节省
开始工作 翻 Git 记录回忆上下文 /start 快速了解状态 -4分钟
5分钟 1分钟
进度评估 手动统计代码，全靠感觉 /progress 自动生成报告 -29分钟
30分钟 1分钟
任务规划 自己想接下来做什么 /next AI 给出建议 -9分钟
10分钟 1分钟
文档更新 手动整理，经常忘记 /update-status 自动更新 -29分钟
30分钟 1分钟
团队协作 开会对齐 查看文档即可 -55分钟
1小时 5分钟
总耗时 2小时15分钟 10分钟 -125分钟

效率提升

  • ⚡ 时间效率：提升 13 倍
  • 📊 准确度：从 “大概 60%” → “精确 72%”
  • 📝 文档同步：从 “经常忘” → “自动更新”
  • 🤝 团队协作：从 “开会 1 小时” → “查看文档 5 分钟”

质量提升

  • ✅ 不遗漏任务：AI 自动扫描 TODO 注释
  • ✅ 进度精确：基于代码自动统计，不是凭感觉
  • ✅ 文档同步：代码和文档完全一致
  • ✅ 任务优先级清晰：AI 智能排序

进阶技巧

技巧 1：自定义优先级规则

在 .claude/commands/next.md 中定义优先级规则：

## 优先级判断规则

### 🔴 高优先级（必须马上做）
- 有 FIXME 注释的代码
- 阻塞其他任务的功能（如 Service 已完成但 Controller 未完成）
- 生产环境 Bug
- 用户反馈的紧急问题

### 🟡 中优先级（近期要做）
- 已开始但未完成的功能
- 计划内的新功能
- TODO 注释的代码
- 性能优化

### 🟢 低优先级（可以考虑）
- 代码重构
- 非核心功能优化
- 文档完善

技巧 2：团队协作最佳实践

场景 1：多人协作
团队成员 A: 开发完功能 → /update-status（更新自己的进度）
团队成员 B: /progress（查看整体进度，了解其他人在做什么）
团队成员 C: /next（获取任务建议，避免冲突）
项目经理: /progress（生成汇报材料）
场景 2：项目交接
新成员第一天：
1. /start              # 快速了解项目是什么
2. Read docs/需求文档.md  # 了解项目需求
3. Read docs/项目状态.md  # 了解当前进度
4. /next               # 获取可以开始的任务

老成员交接：
1. /progress           # 生成完整的进度报告
2. 口头补充项目难点、注意事项
3. 新成员开始开发

技巧 3：标准化工作流

建立团队统一的工作流程：

每天早上：
1. /start              # 进入工作状态（1分钟）
2. /next               # 获取今日任务（1分钟）

开发过程：
3. 专注写代码          # 按照任务建议开发
4. git commit          # 提交代码

开发完成：
5. /update-status      # 自动更新文档（1分钟）
6. /next               # 规划明日任务（1分钟）

每周五：
7. /progress           # 生成周报（1分钟）

每天项目管理时间：5 分钟

技巧 4：自动化集成

Git Hook 集成

将 /update-status 提示集成到 Git Hook 中：

# .git/hooks/post-commit
#!/bin/bash

echo ""
echo "✅ 提交成功！"
echo ""
echo "💡 建议：运行 /update-status 更新项目状态"
echo ""
CI/CD 集成

在 CI 流程中自动生成进度报告：

# .github/workflows/progress.yml
name: Generate Progress Report

on:
  push:
    branches: [ main ]

jobs:
  progress:
    runs-on: ubuntu-latest
    steps:
      - name: Generate Report
        run: |
          # 调用 Claude Code API 生成进度报告
          # 发送到项目群或邮件

配置指南

最小化配置（5分钟上手）

1. 创建文档模板

在项目根目录运行：

/init-docs

AI 会自动创建：

docs/
├── 需求文档.md
├── 项目状态.md
└── 待办清单.md
2. 配置项目结构

在 CLAUDE.md 中添加：

## 📚 项目资源概览

### 后端已有功能模块
| 模块 | 说明 | 位置 |
|------|------|------|
| ✅ 用户管理 | 用户CRUD | ruoyi-business/user/ |
| ✅ 权限管理 | 角色权限 | ruoyi-business/auth/ |
3. 开始使用
/start    # 快速了解项目

配置完成！ 现在就可以使用四大管理命令了。

完整配置（推荐）

1. 创建命令文件

在 .claude/commands/ 目录下创建四个命令文件：

文件结构：

.claude/commands/
├── start.md          # 快速了解项目
├── progress.md       # 查看详细进度
├── next.md           # 获取下一步建议
└── update-status.md  # 更新项目状态

start.md 示例：

# /start - 快速了解项目

作为项目引导助手，请帮我快速了解这个项目的当前状态。

## 你需要做的：

1. 识别项目类型（Spring Boot + Vue3 + Uniapp）
2. 查看最近 3 条 Git 提交
3. 检查代码状态（是否有未提交修改）
4. 扫描业务模块（ruoyi-modules/）
5. 统计 TODO/FIXME 数量

## 输出格式：

简洁的欢迎报告，包含项目信息、最近动态、当前状态。
2. 配置项目规范

在 CLAUDE.md 中完善：

## 📚 项目资源概览

### 后端已有功能模块
| 模块 | 说明 | 位置 |
|------|------|------|
| ✅ 广告配置 | 广告位配置管理 | ruoyi-business/base/ |
| ✅ 平台配置 | 微信/支付宝配置 | ruoyi-business/base/ |

### 前端已有页面
| 页面 | 路由 | 位置 |
|------|------|------|
| ✅ 广告管理 | /business/base/ad | src/views/business/base/ad/ |

### 移动端已有页面
| 页面 | 路径 | 位置 |
|------|------|------|
| ✅ 个人中心 | pages/user/index | pages/user/ |

## 🔧 开发规范

### 后端规范
- 包名：plus.ruoyi.*
- Service 不继承任何基类
- DAO 层必须有 buildQueryWrapper() 方法

### 前端规范
- 使用 TypeScript
- 统一使用 Composition API
- API 调用使用 async/await

### 移动端规范
- 使用 WD UI 组件库
- 遵循 Uniapp 规范
3. 定义文档模板

在 .claude/templates/ 目录下创建模板文件（可直接使用本指南中的示例）。

4. 配置优先级规则

在 .claude/commands/next.md 中添加优先级判断规则（参考"进阶技巧 1"）。

常见问题

Q1：AI 如何统计项目进度？

A：AI 会自动扫描代码，检查每个功能模块是否包含：

  • Entity（实体类）
  • BO（业务对象）
  • VO（视图对象）
  • Service（业务逻辑）
  • DAO（数据访问）
  • Controller（接口）
  • Mapper（数据库映射）

完成度计算：

  • 全部存在 → 100%
  • 缺少 Controller → 约 85%
  • 只有 Entity → 约 20%

示例：

用户反馈模块：
- Entity: ✅
- BO: ✅
- VO: ✅
- Service: ✅
- DAO: ✅
- Controller: ❌ (缺少)
- Mapper: ✅

完成度 = 6/7 ≈ 85%

Q2：/update-status 会覆盖我手动添加的内容吗？

A：不会。AI 采用智能更新策略：

✅ 保留的内容：

  • 用户手动添加的任务
  • 自定义的备注和说明
  • 手动调整的优先级

✅ 自动更新的内容：

  • 可以从代码分析出的任务状态
  • Git 提交记录
  • 模块完成度百分比
  • 时间戳

示例：

## 待办

- [ ] 添加单元测试  # ← 用户手动添加，会保留
  - 优先级: 高      # ← 用户设置，会保留

- [ ] 优化 AI 响应速度  # ← AI 从 TODO 注释扫描，会保留
  位置: ChatServiceImpl.java:45

Q3：如何定义优先级规则？

A：在 .claude/commands/next.md 中定义规则，AI 会根据规则排序任务。

示例规则：

## 优先级判断规则

### 🔴 高优先级
1. 有 FIXME 注释
2. 阻塞其他任务（如 Service 完成但 Controller 未完成）
3. 生产环境 Bug

### 🟡 中优先级
1. 已开始但未完成的功能
2. TODO 注释
3. 计划内新功能

### 🟢 低优先级
1. 代码优化
2. 性能提升
3. 文档完善

Q4：团队成员如何协作？

A：推荐工作流：

方案 1：共享文档（推荐）

1. 所有文档提交到 Git 仓库
2. 每个成员开发完运行 /update-status
3. git push 后其他成员 git pull 获取最新文档
4. 项目经理运行 /progress 查看整体进度

方案 2：独立分支

1. 每个成员在自己的分支维护文档
2. 定期合并到主分支
3. 项目经理在主分支查看整体进度

冲突处理：

  • 如果多人同时修改 项目状态.md 导致冲突
  • 优先保留最新的内容
  • 或运行 /update-status 重新生成

Q5：支持哪些项目类型？

A：支持所有类型的项目，只要：

✅ 必要条件：

  • 使用 Git 版本控制
  • 有清晰的模块划分

✅ 已测试的项目类型：

  • Java Spring Boot 项目
  • Vue 3 前端项目
  • Uniapp 移动端项目
  • Python Flask/Django 项目
  • Node.js 后端项目

配置要点：
在 CLAUDE.md 中定义项目结构，AI 就能识别。

示例（Python 项目）：

## 项目资源概览

### 后端已有模块
| 模块 | 说明 | 位置 |
|------|------|------|
| ✅ 用户认证 | JWT认证 | app/auth/ |
| ✅ 数据模型 | SQLAlchemy模型 | app/models/ |

Q6：/progress 能否自定义输出格式？

A：可以。在 .claude/commands/progress.md 中自定义输出格式。

示例：

# /progress - 项目进度梳理

## 输出格式

### 按模块统计
- 后端模块（按 Maven 模块）
- 前端页面（按路由）
- 移动端页面（按页面路径）

### 额外信息
- 代码质量分析（TODO/FIXME 数量）
- 测试覆盖率（如果有）
- 最近一周的开发活跃度

最佳实践

实践 1：每日标准工作流

时间安排：

时间 操作 耗时
09:00 /start - 进入工作状态 1分钟
09:05 /next - 获取今日任务 1分钟
09:10 开始写代码 -
12:00 午休 -
17:00 /update-status - 更新今日进度 1分钟
17:30 /next - 规划明日任务 1分钟

每天项目管理时间：4 分钟

实践 2：周报自动生成

每周五 17:00：

步骤 1: /progress
步骤 2: 复制"已完成"部分
步骤 3: 整理成周报

周报模板：

# 本周工作总结 (2025-01-08 至 2025-01-12)

## 📊 整体进度
- 上周进度：65%
- 本周进度：72%
- 进度提升：+7%

## ✅ 本周完成
[从 /progress 复制"已完成"部分]

## 🚧 进行中
[从 /progress 复制"进行中"部分]

## 📅 下周计划
[从 /next 获取高优先级任务]

耗时：5 分钟

实践 3：项目交接流程

场景：老员工离职，新员工接手项目

老员工交接准备
步骤 1: /progress
  → 生成完整的项目进度报告
  → 保存为 docs/项目交接报告.md

步骤 2: /next
  → 列出所有待办任务
  → 标注优先级和注意事项

步骤 3: 补充口头说明
  - 项目难点
  - 技术选型原因
  - 业务逻辑复杂点

耗时：10 分钟

新员工接手流程
步骤 1: /start
  → 快速了解项目是什么

步骤 2: Read docs/需求文档.md
  → 了解项目需求和目标

步骤 3: Read docs/项目状态.md
  → 了解当前进度和待办任务

步骤 4: Read docs/项目交接报告.md
  → 了解完整的项目情况

步骤 5: /next
  → 获取可以开始的任务

步骤 6: 开始开发
  → 选择一个低风险的任务开始

耗时：30 分钟

交接效率：比传统方式节省 80% 时间

实践 4：多项目管理

场景：同时负责 3 个项目

项目切换流程
切换到项目 A:
1. cd project-a
2. /start
   → 1 分钟进入项目 A 的上下文

切换到项目 B:
1. cd project-b
2. /start
   → 1 分钟进入项目 B 的上下文
统一进度汇总

每周一早上：

# 自动化脚本
cd project-a && echo "=== 项目 A ===" && /progress
cd project-b && echo "=== 项目 B ===" && /progress
cd project-c && echo "=== 项目 C ===" && /progress

汇总格式：

# 多项目进度汇总 (2025-01-14)

## 项目 A - 企业管理系统
- 整体进度：72%
- 本周重点：用户反馈模块

## 项目 B - 数据分析平台
- 整体进度：85%
- 本周重点：报表导出功能

## 项目 C - 移动端应用
- 整体进度：60%
- 本周重点：首页优化

实践 5：代码审查集成

PR 审查前：

步骤 1: /progress
  → 确认该功能在"进行中"列表

步骤 2: 检查代码
  → 确保符合 CLAUDE.md 规范

步骤 3: 测试通过后
  → git commit

步骤 4: /update-status
  → 自动更新状态为"已完成"

步骤 5: 创建 PR
  → PR 描述中引用 /update-status 的报告

PR 模板：

## 功能说明
实现用户反馈模块

## 完成内容
- ✅ Entity + BO + VO
- ✅ Service + DAO
- ✅ Controller

## 进度更新
[粘贴 /update-status 的报告]

## 下一步
- 前端页面开发

成功案例

案例 1：个人开发者 - 全栈项目

背景：

  • 角色：独立开发者
  • 项目：企业管理系统（后端 + 前端 + 移动端）
  • 痛点：经常忘记做到哪了，切换任务后需要很久回忆上下文

使用前：

  • 每天花 1 小时管理项目进度
  • 切换任务后需要 10 分钟回忆上下文
  • 无法准确评估进度（“大概60%吧…”）
  • 文档和代码经常不同步

使用后：

  • 每天只需 5 分钟管理项目
  • /start 1 分钟进入工作状态
  • /progress 精确知道完成度（72%）
  • /update-status 自动更新文档，不再遗漏

效果：

  • ⚡ 项目管理时间：1 小时/天 → 5 分钟/天（提升 12 倍）
  • 📊 进度准确度：从"大概" → “精确”
  • 📝 文档同步率：从 50% → 100%

用户评价：

“现在每次打开项目，/start 一下就知道该做什么了，再也不用翻 Git 记录回忆半天。/update-status 更是解放了我，开发完直接提交，文档自动更新。”

案例 2：小团队（3-5人） - 企业级系统

背景：

  • 团队规模：3 人
  • 项目：SaaS 平台开发
  • 痛点：每天早会 30 分钟对齐进度，文档和代码不同步，不知道其他人在做什么

使用前：

  • 每天早会 30 分钟对齐进度
  • 项目经理手动整理周报（2 小时）
  • 新成员加入需要 1 周了解项目
  • 文档更新全靠自觉（经常忘）

使用后：

每个成员：
- 开发完运行 /update-status
- git push 同步文档

项目经理：
- 取消每日早会
- /progress 1 分钟生成周报
- 新成员 /start 快速了解项目

效果：

  • 🤝 团队协作效率：提升 50%
  • ⏰ 会议时间：30 分钟/天 → 0 分钟（取消早会）
  • 📊 周报生成：2 小时 → 5 分钟
  • 🚀 新成员上手：1 周 → 1 天

项目经理评价：

“以前每天早会 30 分钟，现在直接 /progress 看文档就知道大家在做什么。周报从 2 小时整理变成 5 分钟生成，解放了太多时间。”

团队成员评价：

“不用担心忘记更新文档了，/update-status 会自动帮我更新。而且 /next 会告诉我优先做什么，不会和同事冲突。”

案例 3：中型团队（10人+） - 多模块项目

背景：

  • 团队规模：12 人（3 个小组）
  • 项目：企业级管理系统（10+ 个业务模块）
  • 痛点：模块太多，进度难以统计；团队成员不知道其他组的进度

使用策略：

1. 按小组维护文档
项目结构：
├── docs/
│   ├── 需求文档.md          # 全局需求
│   ├── 项目状态.md          # 汇总状态
│   ├── 组A-项目状态.md      # 组A独立状态
│   ├── 组B-项目状态.md      # 组B独立状态
│   └── 组C-项目状态.md      # 组C独立状态
2. 统一工作流
小组成员：
- 每天 /update-status 更新本组文档

小组长：
- 每周五 /progress 生成本组报告
- 提交到主分支

项目经理：
- 每周一汇总各组报告
- 生成整体进度报告

效果：

  • 📊 进度统计：从 4 小时/周 → 30 分钟/周
  • 🔍 跨组协作：各组进度透明，避免重复开发
  • 📈 项目可见性：管理层随时了解项目进度

项目经理评价：

“12 个人的项目，以前统计进度要 4 小时，现在各组用 /progress 生成报告，我汇总只需要 30 分钟。而且数据准确，不是拍脑袋估计的。”

ruoyi-plus-uniapp 框架优势

本指南基于 ruoyi-plus-uniapp 框架开发，该框架与 Claude Code 项目管理完美配合。

框架特点

🚀 开发效率提升 80%

  • 代码量减少 70%（四层架构 + 增强查询）
  • 智能代码生成
  • 完善的工具库

🏗️ 统一的开发规范

  • 前后端移动端命名统一
  • 类型声明统一
  • 职责分层清晰

💎 技术栈

  • 后端：Spring Boot 3 + MyBatis Plus + 多租户
  • 前端：Vue 3 + Vite 6 + TypeScript + Element Plus
  • 移动端：UniApp + WD UI（98个组件）

AI + 框架 = 完美配合

框架特性 AI 项目管理 配合效果
四层架构 AI 自动识别模块完整性 精确统计完成度
统一规范 AI 严格遵循 CLAUDE.md 代码风格一致
代码生成 AI 自动更新项目状态 开发完自动记录
多端开发 AI 按端分类统计进度 三端进度清晰

实际案例：开发效率对比

传统开发：

需求确认：30 分钟
手写代码：4 小时
手动更新文档：30 分钟
总耗时：5 小时

ruoyi-plus-uniapp + Claude Code：

需求确认：10 分钟（/dev 命令引导）
代码生成：30 分钟（框架代码生成器）
AI 更新文档：1 分钟（/update-status）
总耗时：1 小时

效率提升：5 倍

立即开始

项目地址：https://ruoyi.plus/

授权定价：

  • 个人版：¥2,180
  • 企业标准版：¥2,880
  • 企业高级版：¥3,880

立即开始

第一步：初始化文档

/init-docs

第二步：配置项目结构

在 CLAUDE.md 中添加项目资源概览。

第三步：开始使用

/start          # 快速了解项目
/next           # 获取任务建议
# 开发中...
/update-status  # 更新项目状态
/progress       # 生成进度报告

核心价值总结

通过标准化的项目管理流程，AI 可以：

✅ 自动跟踪进度

  • 扫描代码，精确统计完成度
  • 按模块、业务域分类展示
  • 不是"大概"，而是"精确"

✅ 自动更新文档

  • 开发完一键更新，不再遗漏
  • 文档和代码完全同步
  • 保留手动添加的内容

✅ 智能任务调度

  • 分析当前状态，建议下一步任务
  • 自动扫描 TODO/FIXME 注释
  • 按优先级排序，考虑依赖关系

✅ 生成精确报告

  • 随时生成进度报告
  • 支持团队协作
  • 新成员快速上手

让你专注于写代码，把项目管理交给 AI。

附录

相关资源

ruoyi-plus-uniapp 官网：https://ruoyi.plus/
Claude Code 官方文档：https://docs.claude.com/claude-code
b站视频：
https://www.bilibili.com/video/BV1Y6CTBnEUD/

🚀 现在就开始你的标准化项目管理之旅吧！

# 人工智能
Logo
2048 AI社区

有“AI”的1024 = 2048，欢迎大家加入2048 AI社区

更多推荐

cover

大火的 Dify 到底是什么？

avatar 2048 AI社区

GLM-4.7上线：国产开源编码大模型的新进展

12月22日，智谱AI发布了GLM-4.7。这不只是常规版本更新，而是一个信号——开源模型在编程、推理和工具调用等关键能力上有了显著进展。距离GPT 5.2发布仅20天，GLM-4.7就随之而来。官方公布的测试数据显示，这个版本在编程、推理与智能体三个维度取得了新的进展，并在多项国际基准测试中位居前列。对国内开发者而言，这意味着一个编程效率更高、成本更可控的AI编程伙伴。

avatar 2048 AI社区
cover

大模型知识注入技术详解：从RAG到微调的8种方法对比与应用场景

avatar 2048 AI社区