| name | module-generator |
| description | 生成完整的 ABP 模块结构，以最小 token 开销创建 5 层项目、更新主模块依赖、解决方案文件和动态 API 配置。当用户想要创建新模块，提到"新建模块"、"创建模块"、"module"、"add module"、"generate module"时使用。支持简单名称（Payment）和复合名称（content-management、ContentManagement）。 |
模块生成器
通过委托 C# 脚本执行来生成完整的 ABP 业务模块结构。业务模块命名空间使用 Yi.Module.{Module}，框架基础设施引用保持 Yi.Framework.*。
工作流程
步骤 1：验证输入
检查模块名称格式：
- 支持 PascalCase（如
Payment、ContentManagement）
- 支持 kebab-case（如
payment、content-management）
- 支持 snake_case（自动转换为 PascalCase）
步骤 2：执行生成脚本
直接运行 C# 文件：
dotnet run --file .claude/skills/module-generator/scripts/generate_module.cs -- <模块名称>
脚本处理以下事项：
- 名称转换（PascalCase ↔ kebab-case）
- 创建
module/{kebab-name}/Yi.Module.{PascalName}.* 5 层项目结构
- 生成模块类和 csproj 文件
- 创建子目录（Entities、Dtos、IServices、Services、Repositories）
- 更新主模块 DependsOn 声明
- 向主 csproj 文件添加 ProjectReference，并引用
framework/{group}/Yi.Framework.* 基础设施项目
- 更新解决方案文件（.slnx）
- 在 YiAbpWebModule.cs 中配置动态 API
如果模块已存在，脚本将报告错误并停止。
步骤 3：报告结果
向用户展示：
- 生成的模块路径
- 创建的文件列表（摘要，非完整路径）
- 实体/DTO/服务创建的后续步骤
输出格式
成功生成后：
模块 '{PascalName}' 创建成功。
位置：module/{kebab-name}/Yi.Module.{PascalName}.*
已生成：
- 5 个项目层（Domain.Shared、Domain、Application.Contracts、Application、SqlSugarCore）
- 带有正确 DependsOn 的模块类
- 带有正确引用的项目文件
- 目录结构（Entities、Dtos、IServices、Services、Repositories）
已更新：
- 主模块类（5 个文件）
- 主项目文件（5 个文件）
- 解决方案文件（Yi.Abp.slnx）
- 动态 API 配置（YiAbpWebModule.cs）
后续建议步骤：
1. 使用 /crud-generator-plus 生成完整 CRUD 功能
是否需要执行 dotnet build 构建检查（一般情况下不需要）？
错误处理
| 场景 | 操作 |
|---|
| 模块已存在 | 脚本报告错误，告知用户删除或使用不同名称 |
| C# 脚本执行错误 | 显示错误消息，建议检查 .NET 安装 |
预运行模式
用于验证而不做实际更改：
dotnet run --file .claude/skills/module-generator/scripts/generate_module.cs -- <名称> --dry-run
适用于用户询问"会创建什么"或想要预览更改的情况。
示例
| 输入 | PascalCase | kebab-case | 模块路径 |
|---|
Payment | Payment | payment | module/payment/Yi.Module.Payment.* |
content-management | ContentManagement | content-management | module/content-management/Yi.Module.ContentManagement.* |
ContentManagement | ContentManagement | content-management | module/content-management/Yi.Module.ContentManagement.* |
