ハンズオンガイドCursor基礎講座

js/inventory.jsを開き、ship関数のすぐ上の空行に、次のコメントと関数の1行目を自分で打ってください。打ち終えると、続きのコードが薄い文字で表示されます。

// 受注した数を引き当てる。利用可能数を超えては引き当てられない
function allocate(stocks, code, qty) {

薄い文字の中身を読み、業務ルールの「引当」と合っていればTabキーで確定してください。合っていなければEscキーで消し、自分で書き足してください。最後に、ファイルの末尾のreturnの一覧にallocateを足します。

今のship関数は、引当数より多い数を出荷しても止まりません。業務ルールの「出荷できるのは引当数まで」を、インライン編集で足します。

1. ship関数の全体を選んでください。
2. Ctrl＋Kを押し、表示された入力欄に次の依頼文を貼り付けて送信してください。
3. 差分を読んで、エラーの文言が日本語になっていることを確かめてから採用してください。

出荷数が引当数を超える場合は、出荷せずに例外を投げてください。エラーの文言は「商品コード NP-1001 は引当数 3 を超えて出荷できません」の形にしてください。

先に自分で答えを考えてから聞きます。docs/業務ルール.mdの発注点の節を読んでください。そのうえでindex.htmlをブラウザで開き、発注が必要な商品が何件あるかを数えます。

次にCtrl＋Lでサイドパネルを開き、次の質問を送ってください。自分で数えた件数と、Cursorが答えた件数と理由を比べます。

@docs/業務ルール.md と @js/inventory.js を読んで答えてください。発注が必要かどうかは、どの数をどの値と比べて判定していますか。初期データで発注が必要な商品のコードを、理由と一緒に全部挙げてください。

倉庫の担当者から「商品がどの棚にあるかを一覧で見たい。棚の列（A、B、C）で絞り込みたい」と頼まれた想定です。データと計算と画面の3つのファイルにまたがるので、エージェントに頼みます。

依頼を送る前に、どのファイルのどこが変わるはずかを、自分で3行のメモに書いてください。エージェントの差分と見比べるために使います。

商品に保管棚の項目 location を追加してください。値は「A-01」のように、棚の列を表す英字1文字とハイフンと2桁の番号にします。
1. js/data.js の10商品すべてに location を入れてください。用紙と梱包資材はA、筆記具とファイルはB、OA消耗品はCの列にしてください
2. js/inventory.js に、棚の列の英字で商品を絞り込む関数 filterByZone を足してください。空文字のときはすべて返します
3. 在庫の一覧に保管棚の列を足し、表の上に棚の列を選ぶ欄（すべて、A、B、C）を置いてください
4. tests/inventory.test.js に filterByZone のテストを1件足してください

差分を採用したら、index.htmlをブラウザで開き直して、棚の列で絞り込めることを確かめてください。続けてtests/test.htmlを開き、テストの結果を見ます。

モデルの欄でComposer 2.5を選び、新しいチャットで次の依頼を送ってください。続けて新しいチャットを開き、モデルの欄でComposerとGrok以外のモデルを1つ選んで、同じ依頼を送ります。

発注が必要な商品について、仕入先に送る発注書の下書きを作る機能を設計してください。コードはまだ書かず、関数の名前と引数と戻り値、発注する数の決め方を、箇条書き10行以内で答えてください。

2つの答えを3点で比べ、メモに書いてください。3点は、返ってくるまでの時間と発注する数の決め方の具体さ、10行に収まったかどうかです。

モデルの指定はRulesには書けません。作業ごとにモデルを変えたいときは、サブエージェントのファイルにmodelを書きます。次の内容を、inventory-appの中の.cursor/agents/code-searcher.mdとして保存してください。

---
name: code-searcher
description: コードベースの検索専用。関数やファイルの場所、変数の使われ方を調べるときに使う。コードは書き換えない。
model: composer-2.5
readonly: true
---

あなたは在庫管理システムのコードを調べる担当です。

依頼されたら、次の順で答えてください。

1. 関係するファイルと関数を、ファイルのパスと行番号つきで一覧にする
2. それぞれが何をしているかを1行で書く
3. 依頼の答えに必要な事実だけを書き、設計の提案はしない

model: composer-2.5は、このサブエージェントだけを軽いモデルで動かす指定です。readonly: trueにすると、このサブエージェントはファイルを書き換えません。

チャットのモデルを、STEP 1で選んだComposer以外のモデルにしたまま、次の依頼を送ってください。先頭の/code-searcherで、調べ物だけをサブエージェントに任せます。

/code-searcher 在庫数か引当数を変えているところをすべて洗い出してください。
そのあと、その結果をもとに、返品を受けたときに在庫を戻す関数の設計を5行以内で書いてください。コードはまだ書かないでください。

チャットに表示されるサブエージェントのカードに、どのモデルで動いたかが出ます。composer-2.5で動いたことを確かめてください。

Plan & UsageのIncluded Usageを開き、研修の最初にメモした割合と比べてください。依頼ごとのモデル名とトークン数は、ブラウザで開く明細の画面に並びます。明細の画面はhttps://cursor.com/dashboard/usageです。STEP 1の2つの依頼のトークン数をメモに書き写してください。