- 添加各模块代码审查 Agent 配置 - 添加 API 一致性审查命令 - 添加工作流配置 Co-Authored-By: Claude <noreply@anthropic.com>
99 lines
3.1 KiB
Markdown
99 lines
3.1 KiB
Markdown
---
|
||
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 参数指定审查特定模块
|
||
```
|