AI プログラミング アシスタントのナニー レベルのチュートリアル: コード補完からエージェント モードの効率的な使用まで

🛒 開発者は、再利用可能な一連のメソッドを使用して、AI プログラミング アシスタントを実際の効率で使用できます。

チュートリアルの目的

このチュートリアルでは、Cursor と GitHub Copilot を例として取り上げ、AI プログラミング アシスタントを「時折完成」から「安定した毎日のエンジニアリング ツール」にアップグレードし、エージェント モードでの複数ファイルの変換、再構築、テスト生成をマスターするのに役立ちます。

準備チェックリスト

  • [ ] VS Code または Cursor をインストールします (このチュートリアルでは例として Cursor を使用します)。
  • [ ] アカウントにログインし、無料割り当て/サブスクリプションのステータスを確認します。
  • [ ] Git で管理されるサンプル プロジェクト (最初に練習してから実際のウェアハウスを使用することをお勧めします)。
  • [ ] Node/Python およびその他の実行環境はすでにローカルで利用可能です (テスト検証の実行に使用されます)。
  • [ ] コード ベースの構造 (エントリ、依存関係、テスト コマンド) を理解します。

ステップ 1: インストールと基本構成

  1. Cursor (または VS Code + Copilot プラグイン) をダウンロードしてインストールします。
  2. アカウントにログインし、設定でモデルと完了スイッチを確認します。
  3. サンプル プロジェクトを開き、ウェアハウスのルート ディレクトリにあるキー ファイル (README、インターフェイス ドキュメント) を表示したままにします。

提案の設定: 「オートコンプリート (タブ)」および「コード レビュー」機能をオンにします。 「すべての提案を自動的に受け入れる」などのリスクの高いオプションをオフにします。

ステップ2：3種類の基本的な使い方をマスターする

  1. インライン補完: 関数名またはコメントを入力し、Tab キーを押して提案を受け入れます。
  2. ダイアログの質問: ⌘ + L ダイアログを開き、コード スニペットを貼り付けて、「このコードの何が問題か」と尋ねます。
  3. コード操作の選択: コードを選択し、右クリックして [説明/リファクタリング/テストの生成] を選択します。

重要なアイデア: 単に「私に代わって書く」のではなく、AI にコンテキストを提供します。まず、関連するファイルを選択するか、インターフェイス署名をポストします。

ステップ 3: 高品質のプロンプトワードを作成する

不適切なプロンプト ワード: 「ログイン インターフェイスを作成してください」。

適切なプロンプトの言葉の例:


src/auth/login.ts にログイン インターフェイスを実装します。
- 入力パラメータ: { ユーザー名、パスワード }
- 検証: bcrypt を使用したパスワード比較
- JWT が正常に返されました。有効期限は 2 時間です
- 失敗すると 401 とエラー コードが返されます
- プロジェクトの既存のエラー処理に従います (src/utils/errors.ts を参照)。
- 単体テストも同時に生成
「」

3 つの重要なポイント: **目標を明確にし、境界線を設け、既存のコードを特定する**。

## ステップ 4: エージェント モードを使用して複数のファイルを変更する

カーソル内で `⌘ + I` を押して Composer/Agent モードに入り、次のように入力します。

```テキスト
注文モジュールの金額計算を独立したツール関数に抽出し、src/utils/money.ts に配置します。
既存の命名スタイルを維持したまま、すべてのコール ポイントを更新し、単体テストを追加します。
「」

エージェントはファイル全体を編集します。このとき、必ず次のことを行ってください。

1. 独立したブランチで運用します。
2. エージェントの差分をすべて 1 クリックで受け入れるのではなく、1 つずつ確認します。
3. テストを実行して、回帰がないことを確認します。

## ステップ 5: AI を使用してテストの生成と修正を支援する

- テストの生成: src/utils/money.ts の「境界条件をカバーする単体テストを生成」。
- 修復失敗: CI エラー メッセージを AI に投稿します:「テスト xx が失敗しました。エラーは次のとおりです...根本原因を特定して修正してください。」。

経験: 「エラー レポート + 関連ドキュメント + 予想される動作」を一緒に投稿すると、エラー レポートだけを投稿するよりも成功率が大幅に高くなります。

## ステップ 6: プロジェクトレベルの仕様を設定する (.cursorrules)

AI 出力をチーム スタイルに適合させるために、プロジェクトのルート ディレクトリに `.cursorrules` を作成します。

```テキスト
- プロジェクト言語: TypeScript、厳密モードを使用
- エラー処理: src/utils/errors.ts での ApiError の使用を統一
- 命名: 関数動詞はコンポーネント PascalCase で始まります
- 提出前にeslintとprettierに合格する必要があります
- すべての新しいロジックには単体テストが必要です
「」

保存後、新しいセッションは自動的に有効になり、チームの統一仕様を共有ウェアハウスに配置できます。

## ステップ 7: 検証とセキュリティ境界

検証チェックリスト:

- [ ] による補完候補は Tab で受け入れられ、文法的には正しいです。
- [ ] プロンプト ワードは、仕様を満たし、実行可能なコードを安定して生成できます。
- [ ] エージェントは、変更後のテストでは完全に緑色になります。
- [ ] 機密情報 (キー、イントラネット アドレス) が Cloud AI に貼り付けられることはありません。

セキュリティ上の赤線: 機密コードは貼り付けられず、共有セッションは機密性の高い倉庫で開かれず、エージェントはトランクに直接プッシュされません。

## ステップ 8: 毎日の効率的なワークフローの組み合わせ

分散した使用法を「標準アクション」に結合することにより、効率が最も明らかに向上します。

1. 要件を取得 → AI を使用してタスク リストとインターフェイスの境界を解体します。
2. コードを作成し、関連ファイルを選択し、エージェントを使用して実装の最初のバージョンを生成します。
3. セルフテスト → AI に単体テストを生成させ、実行させます。
4. 共同デバッグ → 根本原因を特定して修正するために、エラー レポートを AI に投稿します。
5. 仕上げ → AIに変更指示とコミット情報を生成させる。

この組み合わせにより、毎日 1 ～ 2 時間を節約できます。重要なのは、「あらゆる段階での明確な入力と受け入れ」です。

## よくある間違いと注意事項

1. ワンクリックですべてのエージェントの差分を受け入れます。必ず 1 つずつ確認し、テストがすべて緑色の場合にのみマージしてください。
2. コンテキストを与えずに質問します。まずファイルを選択するか、インターフェイスの署名を貼り付けます。
3. AI へのキーの投稿: これはセキュリティ上の危険な一線であり、固く禁止されています。
4. AI の変更後にテストを実行しない: AI の変更はテストによって検証する必要があり、盲目的に信じることはできません。
5. プロンプトの単語は変更されません。効果が減少した場合は、率先してテンプレートを繰り返してください。

## 検証方法

- 検証 1: 補完候補は Tab で受け入れられ、文法的に正しいです。
- 検証 2: プロンプト ワードは、仕様を満たし、実行可能なコードを安定して生成できます。
- 検証 3: 変更後のエージェントは完全に緑色になります。
- 検証 4: 機密情報 (キー、イントラネット アドレス) が Cloud AI に貼り付けられていない。

## よくある質問とトラブルシューティング (FAQ)

1. 補完は常にジャンクコードを示唆しますか?

   より多くのコンテキストを与え (ファイルの選択、インターフェースの貼り付け)、`.cursorrules` を使用してスタイルを制約し、必要に応じてより強力なモデルに変更します。

2. エージェントがファイルを破損した場合はどうすればよいですか?

   Git を使用してファイルをロールバックします: `git checkout <file>`; 「変身前に枝を切り、変身後に一つずつ見直す」習慣を身につけましょう。

3. プロンプトワードの効果が不安定ですか?

   「目標、境界線、既存のコード、想定される検証」の4つの要素を書き出します。効果が不十分な場合は、別の文言でもう一度試してください。

4. 無料割り当てが足りませんか?

   「テストの生成、コードの解釈、コメントの作成」などの頻度の低いタスクを最初に AI に処理させます。クォータが十分になるまで、またはサブスクリプションをアップグレードするまで、高頻度のリファクタリングを残しておきます。

5. チームは AI の使用仕様をどのように統一していますか?

   `.cursorrules` を作成し、Word テンプレートと安全性のレッドラインを共有ドキュメントにプロンプ​​トし、新規ユーザーのオンボーディングに含めます。

6. プロジェクトごとにスタイルが大きく異なる場合はどうすればよいですか?

   プロジェクトごとに「.cursorrules」を個別に管理し、ウェアハウス内で均一に管理して、プロジェクト間のスタイルを回避します。

## 概要と次のステップ

この時点で、「完了」から「エージェント変換」、「テスト修復」までの完全な使い方をマスターしたことになります。最初に 2 ～ 3 日間サンプル プロジェクトで練習し、その後実際のウェアハウスで低リスク モジュールで練習することをお勧めします。最後に、「.cursorrules」とプロンプトワードテンプレートをチーム資産として蓄積できます。

## 進歩と拡大

- コマンド ライン エージェント: <a href="https://www.aistarmap.com/ja-JP/aitool/claude-code" target="_self" class="tool-link"><img src="https://res.aistarmap.com/uploads/images/tools/zh-CN/claude-code/logo_1785766936.png" alt="Claude Code" class="tool-logo" style="width: 20px; height: 20px; margin-right: 5px; vertical-align: middle;">Claude Code</a> を使用して、ターミナルでバッチ再構築を完了します。
- 自動レビュー：AIに自己評価と意見を生成させ、最終的なレビューは手動で行われます。
- 民営化モデル: コードがイントラネットから流出しないように、機密性の高いプロジェクトはローカル展開モデルに接続されます。
- 効率の測定: 導入率と再作業率、四半期ごとのレビューと反復プロンプト ワード資産を記録します。

ユーザーレビュー

  • レビューを読み込み中...