Cursorでコードを生成する - 自然言語から実装への変換

1
2
3
4
5
6
7

指示例：
ユーザー登録APIのエンドポイントを作成してください。
- POST /api/users で呼び出し
- リクエストボディにemail、password、nameを含む
- パスワードはbcryptでハッシュ化して保存
- 成功時は201ステータスとユーザー情報を返す
- メールアドレスの重複チェックを行う

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

// src/controllers/user.controller.ts
import { Request, Response } from 'express';
import bcrypt from 'bcrypt';
import { UserService } from '../services/user.service';

export class UserController {
  constructor(private userService: UserService) {}

  async register(req: Request, res: Response): Promise<void> {
    const { email, password, name } = req.body;

    // メールアドレスの重複チェック
    const existingUser = await this.userService.findByEmail(email);
    if (existingUser) {
      res.status(409).json({ error: 'Email already exists' });
      return;
    }

    // パスワードのハッシュ化
    const hashedPassword = await bcrypt.hash(password, 10);

    // ユーザー作成
    const user = await this.userService.create({
      email,
      password: hashedPassword,
      name,
    });

    // パスワードを除いたユーザー情報を返す
    const { password: _, ...userWithoutPassword } = user;
    res.status(201).json(userWithoutPassword);
  }
}

1
2
3
4
5
6

コンテキストを含めた指示例：
@src/services/user.service.ts と @src/models/user.model.ts を参考に、
パスワードリセット機能を実装してください。
- ランダムなトークンを生成
- 有効期限は1時間
- 既存のUserServiceのパターンに従う

1
2
3

指示例：
既存のUserServiceと同じパターンで、ProductServiceを作成してください。
CRUD操作と検索機能を含めてください。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

// src/services/product.service.ts
import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository, FindOptionsWhere, Like } from 'typeorm';
import { Product } from '../entities/product.entity';
import { CreateProductDto, UpdateProductDto } from '../dto/product.dto';

@Injectable()
export class ProductService {
  constructor(
    @InjectRepository(Product)
    private productRepository: Repository<Product>,
  ) {}

  async create(dto: CreateProductDto): Promise<Product> {
    const product = this.productRepository.create(dto);
    return this.productRepository.save(product);
  }

  async findAll(): Promise<Product[]> {
    return this.productRepository.find();
  }

  async findById(id: string): Promise<Product | null> {
    return this.productRepository.findOne({ where: { id } });
  }

  async update(id: string, dto: UpdateProductDto): Promise<Product | null> {
    await this.productRepository.update(id, dto);
    return this.findById(id);
  }

  async delete(id: string): Promise<boolean> {
    const result = await this.productRepository.delete(id);
    return result.affected !== 0;
  }

  async search(query: string): Promise<Product[]> {
    return this.productRepository.find({
      where: [
        { name: Like(`%${query}%`) },
        { description: Like(`%${query}%`) },
      ],
    });
  }
}

1
2
3

指示例：
@Codebase 認証ミドルウェアの実装パターンを参考に、
APIレート制限のミドルウェアを作成してください。

1
2
3
4
5
6
7

指示例：
注文管理機能を実装してください。
- Order エンティティ（id, userId, items, totalAmount, status, createdAt）
- OrderService（CRUD操作、ステータス更新）
- OrderController（REST API）
- 注文作成時にユーザーの在庫チェックを行う
- 必要なDTOとバリデーションを含める

1
2
3

指示例：
まずチェックポイントを作成してから、
決済モジュールを実装してください。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

---
description: TypeScript コーディング規約
globs: ["**/*.ts", "**/*.tsx"]
alwaysApply: true
---

# TypeScript コーディング規約

## 命名規則
- クラス名: PascalCase（例: UserService）
- 関数名・変数名: camelCase（例: getUserById）
- 定数: UPPER_SNAKE_CASE（例: MAX_RETRY_COUNT）
- インターフェース名: I接頭辞なし（例: User, not IUser）

## エラーハンドリング
- カスタム例外クラスを使用する（HttpException継承）
- エラーメッセージは日本語でユーザーフレンドリーに
- ログにはスタックトレースを含める

## コメント
- 関数にはJSDocコメントを必須とする
- 複雑なロジックには理由を説明するコメントを追加
- TODOコメントには担当者と期限を記載

1
2

指示例：
ユーザーのプロフィール更新機能を実装してください。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

import { Injectable, NotFoundException } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { User } from '../entities/user.entity';
import { UpdateProfileDto } from '../dto/update-profile.dto';

/**
 * ユーザープロフィール管理サービス
 * ユーザーのプロフィール情報の更新と取得を担当する
 */
@Injectable()
export class ProfileService {
  constructor(
    @InjectRepository(User)
    private userRepository: Repository<User>,
  ) {}

  /**
   * ユーザーのプロフィールを更新する
   * @param userId - 更新対象のユーザーID
   * @param dto - 更新するプロフィール情報
   * @returns 更新されたユーザー情報
   * @throws NotFoundException ユーザーが見つからない場合
   */
  async updateProfile(userId: string, dto: UpdateProfileDto): Promise<User> {
    const user = await this.userRepository.findOne({ where: { id: userId } });

    if (!user) {
      throw new NotFoundException('指定されたユーザーが見つかりません');
    }

    // 更新可能なフィールドのみを適用
    Object.assign(user, {
      displayName: dto.displayName,
      bio: dto.bio,
      avatarUrl: dto.avatarUrl,
      updatedAt: new Date(),
    });

    return this.userRepository.save(user);
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

---
description: React コンポーネント規約
globs: ["src/components/**/*.tsx", "src/pages/**/*.tsx"]
alwaysApply: true
---

# React コンポーネント規約

## コンポーネント構造
- 関数コンポーネントを使用（クラスコンポーネント禁止）
- Props は型定義を必須とする
- デフォルトエクスポートを使用

## Hooks
- カスタムHooksは use 接頭辞で命名
- useEffectには依存配列を必ず指定
- 状態管理は useState または Context API を使用

## スタイリング
- CSS Modules または Tailwind CSS を使用
- インラインスタイルは禁止

1
2
3
4
5

変更前（赤）:
-  const user = await db.query('SELECT * FROM users WHERE id = ' + id);

変更後（緑）:
+  const user = await db.query('SELECT * FROM users WHERE id = ?', [id]);

1
2
3
4
5
6
7

修正指示例：
このコードにはいくつか問題があります：
1. エラーハンドリングが不十分です。try-catchを追加してください
2. 入力値のバリデーションが必要です
3. ログ出力を追加してください

これらを修正してください。

1
2

選択範囲に対する指示例：
この関数にnullチェックを追加して

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

段階的な指示例：

ステップ1：
まずOrderエンティティとDTOを作成してください。
フィールドとバリデーションルールは以下の通りです...

ステップ2：
次にOrderServiceを作成してください。
先ほど作成したエンティティを使用し、CRUD操作を実装してください。

ステップ3：
最後にOrderControllerを作成し、
REST APIエンドポイントとしてServiceを公開してください。

1
2
3
4
5
6
7

Agentの計画例：
1. src/entities/notification.entity.ts を作成
2. src/dto/notification.dto.ts を作成
3. src/services/notification.service.ts を作成
4. src/controllers/notification.controller.ts を作成
5. src/modules/notification.module.ts を作成
6. src/app.module.ts を更新して NotificationModule をインポート

1
2
3

継続指示例：
続きを実行してください。
OrderControllerの作成から再開してください。

1
2
3
4
5

エラー修正指示例：
以下のエラーが発生しています：
"Property 'email' does not exist on type 'CreateUserDto'"

このエラーを修正してください。