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

3.1 KiB
Raw Blame History

description
description
prison-module-api-consistency-review
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 参数指定审查特定模块