crud

CRUD 技能

为指定实体（表）自动生成达到可用于生产环境级别的 CRUD 功能。

快速参考

• “为任务管理创建 CRUD” → /crud tasks
• “还需要搜索和分页” → 一并包含所有功能
• “包含权限（谁可以查看/编辑）” → 一并配置授权/规则

交付内容

• CRUD + 验证 + 授权 + 测试，完整且适用于生产环境的套件
• 尽量减少差异，以匹配现有数据库/代码

功能：

• 自动添加验证（Zod）
• 自动配置身份验证/授权（行级安全性）
• 支持关联（一对多、多对多）
• 分页、搜索、筛选
• 自动生成测试用例

---

自动调用技能

此技能必须使用 Skill 工具显式调用以下技能：

技能	用途	调用时机
impl	实现（父技能）	实现 CRUD 功能
verify	验证（父技能）	实现后的验证

---

执行流程

详细步骤见以下各阶段。

阶段 1：实体分析

1. 从 $ARGUMENTS 中解析实体名称
2. 检测现有架构（Prisma、Drizzle、原始 SQL）
3. 推断字段类型和关联

阶段 2：生成 CRUD

1. 根据需要生成模型/架构
2. 创建 API 端点（REST 或 tRPC）
3. 添加验证架构（Zod）
4. 配置授权规则

阶段 3：生成测试

1. 为每个端点创建单元测试
2. 添加集成测试
3. 生成测试夹具

阶段 4：验证

1. 运行类型检查
2. 运行测试
3. 验证构建

---

支持的框架

框架	检测方式	生成的文件
Next.js + Prisma	prisma/schema.prisma	API 路由、Prisma 客户端
Next.js + Drizzle	drizzle.config.ts	API 路由、Drizzle 查询
Express	package.json 中的 express	控制器、路由
Hono	package.json 中的 hono	路由处理程序

---

输出结构

src/
├── lib/
│   └── validations/
│       └── {entity}.ts        # Zod schemas
├── app/api/{entity}/
│   ├── route.ts              # GET (list), POST (create)
│   └── [id]/
│       └── route.ts          # GET, PUT, DELETE
└── tests/
    └── {entity}.test.ts      # Test cases

---

相关技能

• impl - 功能实现
• verify - 构建验证
• auth - 身份验证/授权