chore: 更新 Claude Code 配置和 Agent 文档
- 添加各模块代码审查 Agent 配置 - 添加 API 一致性审查命令 - 添加工作流配置 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
parent
ef46c8d06b
commit
d1c9f356d6
64
.claude/agents/subagent-area.md
Normal file
64
.claude/agents/subagent-area.md
Normal file
@ -0,0 +1,64 @@
|
||||
---
|
||||
name: subagent-area
|
||||
description: 审查监区管理(Area)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：Area（监区管理）模块
|
||||
|
||||
请对 Area 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/area/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/area/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在：
|
||||
1. 读取前端 `AreaApi` 中的 `createArea` / `updateArea` 方法的请求参数类型
|
||||
2. 提取前端请求对象的所有字段（注意区分必填/可选字段）
|
||||
3. 对比后端 `AreaSaveReqVO.java` 中 `@Schema` 或 `@TableField` 标注的所有字段
|
||||
4. 报告差异：
|
||||
- 前端有但后端缺失的字段
|
||||
- 后端有但前端缺失的字段
|
||||
- 字段命名不一致（camelCase vs snake_case）
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段（如关联查询的name字段）是否在Service层正确填充：
|
||||
1. 识别RespVO中的关联字段（`*Name`, `*Code`等）
|
||||
2. 检查 `AreaServiceImpl` 中是否调用关联Service查询并填充
|
||||
3. 验证填充时机（分页查询时批量查询 vs 单条查询时单独查询）
|
||||
4. 报告差异：
|
||||
- 关联字段未填充
|
||||
- N+1查询性能问题
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范：
|
||||
1. 提取SaveReqVO中所有日期/时间类型字段
|
||||
2. 检查Controller层是否使用 `@JsonFormat` 注解指定时区 `Asia/Shanghai`
|
||||
3. 检查Service层日期字段的自动维护逻辑
|
||||
4. 报告差异：
|
||||
- 缺少 `@JsonFormat` 注解
|
||||
- 时区配置不正确
|
||||
- 日期字段未设置默认值
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - Area（监区管理）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
100
.claude/agents/subagent-batch-review.md
Normal file
100
.claude/agents/subagent-batch-review.md
Normal file
@ -0,0 +1,100 @@
|
||||
---
|
||||
name: subagent-batch-review
|
||||
description: 批量模块审查引擎
|
||||
model: sonnet
|
||||
color: cyan
|
||||
---
|
||||
## 批量模块接口一致性审查任务
|
||||
|
||||
请对项目中的模块进行批量接口一致性审查。
|
||||
|
||||
### 任务说明
|
||||
你需要进行以下步骤：
|
||||
|
||||
#### 步骤1：模块发现
|
||||
1. 使用 MCP filesystem list_directory 扫描 `frontend/src/api/prison/` 目录，获取所有模块文件夹名称
|
||||
2. 使用 MCP filesystem list_directory 扫描 `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/` 目录，获取所有模块文件夹名称
|
||||
3. 合并两个列表，确保模块名称一致性
|
||||
|
||||
#### 步骤2：批量审查
|
||||
对每个发现的模块，执行以下审查：
|
||||
|
||||
**对于每个模块 {moduleName}:**
|
||||
|
||||
1. **字段完整性校验**
|
||||
- 读取前端 `frontend/src/api/prison/{moduleName}/index.ts` 中的 `create{ModuleName}` / `update{ModuleName}` 方法的请求参数类型
|
||||
- 读取后端 `backend/.../controller/admin/{moduleName}/vo/*{ModuleName}SaveReqVO.java` 的所有字段
|
||||
- 对比并报告差异：
|
||||
- 前端有但后端缺失的字段
|
||||
- 后端有但前端缺失的字段
|
||||
- 字段命名不一致（camelCase vs snake_case）
|
||||
|
||||
2. **非实体字段填充校验**
|
||||
- 检查 `backend/.../service/{moduleName}/impl/*{ModuleName}ServiceImpl.java` 中关联字段的填充逻辑
|
||||
- 检查 RespVO 中的关联字段（`*Name`, `*Code`等）是否正确填充
|
||||
- 报告 N+1 查询性能问题
|
||||
|
||||
3. **日期字段处理校验**
|
||||
- 检查 SaveReqVO 中日期字段的 `@JsonFormat` 注解配置
|
||||
- 检查时区是否为 `Asia/Shanghai`
|
||||
- 检查日期格式是否为 `yyyy-MM-dd HH:mm:ss` 或 `yyyy-MM-dd`
|
||||
|
||||
#### 步骤3：生成汇总报告
|
||||
|
||||
```markdown
|
||||
## 批量审查报告
|
||||
|
||||
### 发现模块列表
|
||||
| 序号 | 模块名称 | 前端路径 | 后端路径 | 审查状态 |
|
||||
|------|----------|----------|----------|----------|
|
||||
| 1 | area | frontend/src/api/prison/area/ | .../controller/admin/area/ | 已审查 |
|
||||
| ... | ... | ... | ... | ... |
|
||||
|
||||
### 模块详细审查结果
|
||||
|
||||
#### {模块名称1}
|
||||
[按下方格式输出详细报告]
|
||||
|
||||
#### {模块名称2}
|
||||
[按下方格式输出详细报告]
|
||||
|
||||
...（每个模块都需详细报告）
|
||||
|
||||
### 总体统计
|
||||
- 总模块数: X
|
||||
- 成功审查: X
|
||||
- 审查失败: X
|
||||
- 发现问题总数: X
|
||||
- 字段完整性问题: X
|
||||
- 字段填充问题: X
|
||||
- 日期处理问题: X
|
||||
```
|
||||
|
||||
### 各模块详细报告格式
|
||||
|
||||
对于每个模块，输出：
|
||||
|
||||
```markdown
|
||||
## 审查报告 - {模块名称}
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/{moduleName}/`
|
||||
- 后端: `backend/.../controller/admin/{moduleName}/`
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
44
.claude/agents/subagent-cell.md
Normal file
44
.claude/agents/subagent-cell.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-cell
|
||||
description: 审查监室管理(Cell)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：Cell（监室管理）模块
|
||||
|
||||
请对 Cell 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/cell/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/cell/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - Cell（监室管理）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
44
.claude/agents/subagent-consumption.md
Normal file
44
.claude/agents/subagent-consumption.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-consumption
|
||||
description: 审查消费记录(Consumption)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：Consumption（消费记录）模块
|
||||
|
||||
请对 Consumption 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/consumption/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/consumption/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - Consumption（消费记录）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
44
.claude/agents/subagent-question.md
Normal file
44
.claude/agents/subagent-question.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-question
|
||||
description: 审查问卷问题(Question)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：Question（问卷问题）模块
|
||||
|
||||
请对 Question 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/question/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/question/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - Question（问卷问题）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
44
.claude/agents/subagent-questionnaire-record.md
Normal file
44
.claude/agents/subagent-questionnaire-record.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-questionnaire-record
|
||||
description: 审查问卷答题记录(QuestionnaireRecord)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：QuestionnaireRecord（问卷答题记录）模块
|
||||
|
||||
请对 QuestionnaireRecord 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/questionnairerecord/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/questionnairerecord/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - QuestionnaireRecord（问卷答题记录）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
44
.claude/agents/subagent-questionnaire.md
Normal file
44
.claude/agents/subagent-questionnaire.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-questionnaire
|
||||
description: 审查问卷模板(Questionnaire)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：Questionnaire（问卷模板）模块
|
||||
|
||||
请对 Questionnaire 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/questionnaire/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/questionnaire/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - Questionnaire（问卷模板）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
56
.claude/agents/subagent-report-consolidation.md
Normal file
56
.claude/agents/subagent-report-consolidation.md
Normal file
@ -0,0 +1,56 @@
|
||||
---
|
||||
name: subagent-report-consolidation
|
||||
description: 审查报告汇总生成
|
||||
model: sonnet
|
||||
color: green
|
||||
---
|
||||
## 审查报告汇总任务
|
||||
|
||||
请汇总所有模块的审查结果，生成最终报告。
|
||||
|
||||
### 输入
|
||||
- 上一步批量审查的详细报告
|
||||
- 模块发现结果（模块列表）
|
||||
|
||||
### 输出要求
|
||||
|
||||
```markdown
|
||||
## 审查报告汇总
|
||||
|
||||
### 执行摘要
|
||||
- 审查时间: {timestamp}
|
||||
- 审查范围: 前端/后端接口一致性校验
|
||||
- 扫描模块数: X
|
||||
- 发现问题总数: X
|
||||
|
||||
### 问题分类统计
|
||||
| 问题类型 | 数量 | 严重程度 |
|
||||
|----------|------|----------|
|
||||
| 字段缺失 | X | 高 |
|
||||
| 类型不匹配 | X | 中 |
|
||||
| 命名不一致 | X | 低 |
|
||||
| 关联字段未填充 | X | 高 |
|
||||
| N+1查询 | X | 性能 |
|
||||
| 日期格式缺失 | X | 中 |
|
||||
| 时区配置错误 | X | 高 |
|
||||
|
||||
### 各模块审查结果
|
||||
|
||||
| 模块 | 字段完整性 | 字段填充 | 日期处理 | 问题数 | 状态 |
|
||||
|------|------------|----------|----------|--------|------|
|
||||
| area | ✅ | ⚠️ | ❌ | 3 | 待修复 |
|
||||
| cell | ✅ | ✅ | ✅ | 0 | 通过 |
|
||||
| ... | ... | ... | ... | ... | ... |
|
||||
|
||||
### 高优先级问题（需立即修复）
|
||||
1. [{模块}] {问题描述}
|
||||
2. [{模块}] {问题描述}
|
||||
|
||||
### 优化建议
|
||||
1. 建议统一使用 `@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "Asia/Shanghai")`
|
||||
2. 建议批量查询关联字段，避免 N+1 查询
|
||||
3. 建议建立前后端字段映射表，确保一致性
|
||||
|
||||
### 审查完成
|
||||
审查报告生成完毕，请查阅各模块详细问题。
|
||||
```
|
||||
44
.claude/agents/subagent-risk-assessment.md
Normal file
44
.claude/agents/subagent-risk-assessment.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-risk-assessment
|
||||
description: 审查危险评估(RiskAssessment)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：RiskAssessment（危险评估）模块
|
||||
|
||||
请对 RiskAssessment 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/riskassessment/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/riskassessment/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - RiskAssessment（危险评估）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
44
.claude/agents/subagent-score.md
Normal file
44
.claude/agents/subagent-score.md
Normal file
@ -0,0 +1,44 @@
|
||||
---
|
||||
name: subagent-score
|
||||
description: 审查计分考核(Score)模块
|
||||
model: sonnet
|
||||
color: blue
|
||||
---
|
||||
## 审查任务：Score（计分考核）模块
|
||||
|
||||
请对 Score 模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 模块路径
|
||||
- 前端: `frontend/src/api/prison/score/`
|
||||
- 后端: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/score/`
|
||||
|
||||
### 规则1：字段完整性校验
|
||||
检查前端API接口参数是否在后端SaveReqVO中全部存在。
|
||||
|
||||
### 规则2：非实体字段填充校验
|
||||
检查RespVO中非DO字段是否在Service层正确填充。
|
||||
|
||||
### 规则3：日期字段处理校验
|
||||
检查Create/Update接口中日期字段的处理规范。
|
||||
|
||||
### 输出要求
|
||||
```markdown
|
||||
## 审查报告 - Score（计分考核）
|
||||
|
||||
### 1. 字段完整性检查
|
||||
| 状态 | 位置 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 2. 非实体字段填充检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 3. 日期字段处理检查
|
||||
| 状态 | 字段 | 问题描述 | 建议修复 |
|
||||
|------|------|----------|----------|
|
||||
|
||||
### 4. 审查总结
|
||||
- 检查通过项: X
|
||||
- 警告项: X
|
||||
- 错误项: X
|
||||
```
|
||||
60
.claude/commands/my-workflow.md
Normal file
60
.claude/commands/my-workflow.md
Normal file
@ -0,0 +1,60 @@
|
||||
---
|
||||
description: my-workflow
|
||||
---
|
||||
```mermaid
|
||||
flowchart TD
|
||||
start_node_default([开始])
|
||||
prompt_review_instructions[## 代码审查任务]
|
||||
subagent_area[subagent-area]
|
||||
subagent_cell[subagent-cell]
|
||||
subagent_consumption[subagent-consumption]
|
||||
subagent_question[subagent-question]
|
||||
subagent_questionnaire[subagent-questionnaire]
|
||||
subagent_questionnaire_record[subagent-questionnaire-record]
|
||||
subagent_risk_assessment[subagent-risk-assessment]
|
||||
subagent_score[subagent-score]
|
||||
end_node_default([结束])
|
||||
|
||||
start_node_default --> prompt_review_instructions
|
||||
prompt_review_instructions --> subagent_area
|
||||
subagent_area --> subagent_cell
|
||||
subagent_cell --> subagent_consumption
|
||||
subagent_consumption --> subagent_question
|
||||
subagent_question --> subagent_questionnaire
|
||||
subagent_questionnaire --> subagent_questionnaire_record
|
||||
subagent_questionnaire_record --> subagent_risk_assessment
|
||||
subagent_risk_assessment --> subagent_score
|
||||
subagent_score --> end_node_default
|
||||
```
|
||||
|
||||
## 工作流执行指南
|
||||
|
||||
按照上方的Mermaid流程图执行工作流。每种节点类型的执行方法如下所述。
|
||||
|
||||
### 各节点类型的执行方法
|
||||
|
||||
- **矩形节点**：使用Task工具执行子代理
|
||||
- **菱形节点（AskUserQuestion:...）**：使用AskUserQuestion工具提示用户并根据其响应进行分支
|
||||
- **菱形节点（Branch/Switch:...）**：根据先前处理的结果自动分支（参见详细信息部分）
|
||||
- **矩形节点（Prompt节点）**：执行下面详细信息部分中描述的提示
|
||||
|
||||
### Prompt节点详细信息
|
||||
|
||||
#### prompt_review_instructions(## 代码审查任务)
|
||||
|
||||
```
|
||||
## 代码审查任务
|
||||
|
||||
请按照以下规则对指定模块进行前端/后端接口一致性审查：
|
||||
|
||||
### 审查目标
|
||||
1. 校验前端请求参数与后端VO字段的完整性匹配
|
||||
2. 检查非实体字段（关联查询字段）的Service层填充逻辑
|
||||
3. 验证Create/Update接口的日期字段处理规范
|
||||
|
||||
### 审查范围
|
||||
- **前端模块**: `frontend/src/api/prison/{module}/index.ts`
|
||||
- **后端模块**: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/{module}/`
|
||||
- **VO定义**: `controller/admin/{module}/vo/*ReqVO.java`, `*RespVO.java`
|
||||
- **Service层**: `service/{module}/impl/*ServiceImpl.java`
|
||||
```
|
||||
98
.claude/commands/prison-module-api-consistency-review.md
Normal file
98
.claude/commands/prison-module-api-consistency-review.md
Normal file
@ -0,0 +1,98 @@
|
||||
---
|
||||
description: prison-module-api-consistency-review
|
||||
---
|
||||
```mermaid
|
||||
flowchart TD
|
||||
start_node_default([开始])
|
||||
prompt_review_instructions[## 通用代码审查工作流]
|
||||
mcp_discover_frontend[[MCP: list_directory]]
|
||||
mcp_discover_backend[[MCP: list_directory]]
|
||||
subagent_batch_review[subagent-batch-review]
|
||||
subagent_report_consolidation[subagent-report-consolidation]
|
||||
end_node_default([结束])
|
||||
|
||||
start_node_default --> prompt_review_instructions
|
||||
prompt_review_instructions --> mcp_discover_frontend
|
||||
prompt_review_instructions --> mcp_discover_backend
|
||||
mcp_discover_frontend --> subagent_batch_review
|
||||
mcp_discover_backend --> subagent_batch_review
|
||||
subagent_batch_review --> subagent_report_consolidation
|
||||
subagent_report_consolidation --> end_node_default
|
||||
```
|
||||
|
||||
## 工作流执行指南
|
||||
|
||||
按照上方的Mermaid流程图执行工作流。每种节点类型的执行方法如下所述。
|
||||
|
||||
### 各节点类型的执行方法
|
||||
|
||||
- **矩形节点**：使用Task工具执行子代理
|
||||
- **菱形节点（AskUserQuestion:...）**：使用AskUserQuestion工具提示用户并根据其响应进行分支
|
||||
- **菱形节点（Branch/Switch:...）**：根据先前处理的结果自动分支（参见详细信息部分）
|
||||
- **矩形节点（Prompt节点）**：执行下面详细信息部分中描述的提示
|
||||
|
||||
## MCP工具节点
|
||||
|
||||
#### mcp_discover_frontend(list_directory)
|
||||
|
||||
**描述**: Discover frontend module directories
|
||||
|
||||
**MCP服务器**: filesystem
|
||||
|
||||
**工具名称**: list_directory
|
||||
|
||||
**验证状态**: valid
|
||||
|
||||
**已配置参数**:
|
||||
|
||||
- `path` (string): frontend/src/api/prison
|
||||
|
||||
**可用参数**:
|
||||
|
||||
- `path` (string) (必需): Frontend API modules directory path
|
||||
|
||||
此节点调用MCP（Model Context Protocol）工具。执行此工作流时，请使用已配置的参数通过MCP服务器调用该工具。
|
||||
|
||||
#### mcp_discover_backend(list_directory)
|
||||
|
||||
**描述**: Discover backend module directories
|
||||
|
||||
**MCP服务器**: filesystem
|
||||
|
||||
**工具名称**: list_directory
|
||||
|
||||
**验证状态**: valid
|
||||
|
||||
**已配置参数**:
|
||||
|
||||
- `path` (string): backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin
|
||||
|
||||
**可用参数**:
|
||||
|
||||
- `path` (string) (必需): Backend controller modules directory path
|
||||
|
||||
此节点调用MCP（Model Context Protocol）工具。执行此工作流时，请使用已配置的参数通过MCP服务器调用该工具。
|
||||
|
||||
### Prompt节点详细信息
|
||||
|
||||
#### prompt_review_instructions(## 通用代码审查工作流)
|
||||
|
||||
```
|
||||
## 通用代码审查工作流
|
||||
|
||||
本工作流将对指定范围内的模块进行前端/后端接口一致性审查。
|
||||
|
||||
### 审查目标
|
||||
1. 校验前端请求参数与后端VO字段的完整性匹配
|
||||
2. 检查非实体字段（关联查询字段）的Service层填充逻辑
|
||||
3. 验证Create/Update接口的日期字段处理规范
|
||||
|
||||
### 审查范围
|
||||
- 前端 API 目录: `frontend/src/api/prison/`
|
||||
- 后端 Controller 目录: `backend/yudao-module-prison/src/main/java/cn/iocoder/yudao/module/prison/controller/admin/`
|
||||
- 默认扫描范围: prison 模块下所有子模块
|
||||
|
||||
### 使用方式
|
||||
- **自动扫描**: 工作流将自动发现所有模块并逐一审查
|
||||
- **指定模块**: 通过 targetModules 参数指定审查特定模块
|
||||
```
|
||||
2
backend
2
backend
@ -1 +1 @@
|
||||
Subproject commit 877e691792daf30ddba3881d00e45f6f13bda475
|
||||
Subproject commit 0d46e00ba7a8d58045514dc95b1e6977ab4ea890
|
||||
2
frontend
2
frontend
@ -1 +1 @@
|
||||
Subproject commit 4bac14276a6e483d2d648bdf79c4b9129c6520f9
|
||||
Subproject commit 934f2935ac97f2bec4c5aaf954c582fcbb882a3d
|
||||
Loading…
x
Reference in New Issue
Block a user