scaffold

Scaffold

在现有代码库中生成增量代码，并遵循本地代码模式。

Contract

输入：

• Scaffold 目标类型和名称
• 代码库根目录
• 可参考的现有示例

输出：

• 创建或修改的文件
• 从现有代码中沿用的模式
• 后续手动步骤和需要运行的测试

创建/修改：

• 针对所请求的模块／组件／包创建本地源文件、测试文件和导出文件
• 不会创建完整的产品代码库

外部副作用：

• 无

需要确认：

• 覆盖现有文件之前
• 当匹配示例少于 3 个时，引入新模式之前

委托给：

• 用户需要创建全新项目时，交给 project-init-orchestrator
• 用户需要创建新的 Shipshit.dev 产品代码库时，交给 project-init-orchestrator（v0 路线）／npx @shipshitdev/v0
• NestJS、React、shadcn 或 TypeScript 等框架专用技能，例如 nestjs-expert、react-patterns、shadcn 或 typescript-expert

Steps

1. 根据参数确定要 scaffold 的内容：

   • endpoint [name] — 新建 API 端点（控制器 + 服务 + 模块）
   • module [name] — 新建包含完整结构的后端模块
   • component [name] — 新建带有适当类型定义的 UI 组件
   • package [name] — 新建共享包
   • model [name] — 新建数据库模型（Prisma）及其服务

2. 查找 3 个或更多现有示例：

   • 在代码库中搜索相似实现
   • 确认使用的具体模式（导入、命名、文件结构）
   • 记录任何模块专属约定

3. 根据类型 scaffold：

   API Endpoint

   • 在适当目录中创建控制器、服务和模块
   • 遵循以下模式：身份验证守卫、租户筛选、序列化器响应

   UI Component

   • 创建带有适当类型定义的组件文件
   • 在专用 props 文件中定义 props 接口
   • 从 barrel 文件导出

   Shared Package

   • 创建包含 package.json 的目录
   • Barrel 导出：src/index.ts
   • TypeScript 配置

   Database Model

   • 创建 Prisma 模型文件和迁移
   • 在共享接口包中定义接口
   • 在共享序列化器包中创建序列化器（如适用）

4. 应用关键规则：

   • 接口应放在专用文件中，而不是内联定义
   • 使用路径别名，而不是相对导入
   • 在所有查询中添加租户／组织筛选（如适用）

5. 报告：列出所有创建的文件以及所需的任何手动步骤

Arguments

• 必填：要 scaffold 的内容（例如，"endpoint tasks"、"component ImageGrid"、"model workflows"）