xlcp/.claude/commands/prison-module-api-consistency-review.md
tangweijie d1c9f356d6 chore: 更新 Claude Code 配置和 Agent 文档
- 添加各模块代码审查 Agent 配置
- 添加 API 一致性审查命令
- 添加工作流配置

Co-Authored-By: Claude <noreply@anthropic.com>
2026-01-19 23:19:47 +08:00

99 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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
此节点调用MCPModel 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
此节点调用MCPModel 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 参数指定审查特定模块
```