# Devinを始めよう — Acmeエンジニアリングチーム

## 1. セッションの開始
| 方法 | 使用するタイミング | 例 |
|--------|-------------|--------|
| **Slack** — @Devinにメッセージ | 素早い、スコープが限定されたタスク | 「api-serviceで失敗しているCIを修正して」 |
| **Webアプリ** — app.devin.ai | ファイル添付やプレイブックが必要な長いタスク | マイグレーションプレイブック＋仕様ファイルを添付 |

## 2. 効果的なプロンプトの書き方
Devinは具体的でスコープが限定されたリクエストで最もよく機能します。常に
ファイルパス、何が壊れているか、いつ始まったかを含めてください。

❌ 「ログインのバグを修正して」
✅ 「src/pages/Login.tsxのログインフォームが、金曜日のJWTキーローテーション以降、
   有効な認証情報に対して401を返しています。src/middleware/auth.tsの
   認証ミドルウェアを確認してください。」

## 3. Linearインテグレーション
設定 > 接続 > Linear に移動して認証してください。接続後、
Devinは以下のことができます：
- 割り当てられたチケットを自動的に引き受ける
- 作業中にチケットのステータスを更新する
- PRを元のLinearチケットにリンクする

完全なセットアップガイドはこちら: docs.devin.ai/integrations/linear

## 4. 繰り返しタスクのプレイブック
設定 > プレイブック > 新規作成 で再利用可能なプロンプトを作成します。
Express-to-Fastifyマイグレーションのプレイブックには以下を含めてください：
- ターゲットモジュールパス（例：src/services/payments/）
- テストコマンド: npm run test:api && npm run test:integration
- マイグレーションが下流のコンシューマーを壊した場合のロールバック手順

## 5. ナレッジ — Devinにチームの規約を教える
設定 > ナレッジ > ナレッジを作成 でチームの規約を追加します。

エントリの例：
  トリガー: 「APIルートに取り組んでいる」
  内容: 「私たちはExpressではなくFastifyを使用しています。すべてのルートは
  src/routes/にあります。コミット前にnpm run test:apiを実行してください。
  エラーレスポンスはsrc/lib/errors.tsのApiErrorクラスを使用する必要があります。」