← ガイド · English · Português · 中文
このページの目次
ガイド 13 — 公式ユースケース・クックブック
目標: Cognition 公式ドキュメントで実証済みの使用パターンをクックブックとして整理 — Devin に切り分けるべき仕事とは何か、そしてプロンプト付きでコピーできる 40 以上の文書化レシピ。 レベル: まずは網羅性のためにここから 出典: Best Practices · Use-case gallery · use-case tutorials
すべてを貫く唯一のルール#
公式ガイダンスのロジックをそのまま言うと:wide & shallow(広く浅い)仕事を選べ — シンプルで水平方向にスケールするタスクの大きなバックログは、複雑な新規構築に常に勝る。
| 理想的なタスク | アンチタスク |
|---|---|
| ジュニアエンジニア程度の複雑さの反復的サブタスク | 新規の複雑な機能 |
| スライスあたり手作業 90 分未満 | 分割不可能なもの |
| 客観的な合否検証 | 「なんか良さそう」 |
| 分離され、後方互換で、並列化可能 | 絡み合った依存関係 |
ドキュメントにある 4 つの優れたスライス形:マイグレーション、リファクタ、モダナイゼーション、技術的負債バックログ。
レシピカタログ#
以下はすべて公式ギャラリーに文書化されたユースケース — それぞれコピペ可能なプロンプト付き。人間の週から取り除いてくれる仕事別に整理。
インシデント & 本番健全性#
| レシピ | 仕組み |
|---|---|
| Datadog/PagerDuty アラートの自動調査 | Webhook/API トリガー → 発火時にセッションが調査 |
| ポストモーテムの自動生成 | PagerDuty 解決 → Devin がタイムライン・根本原因・アクションアイテムを起草 |
| Sentry エラーの毎日修正 | 夜間 cron が新規エラーを取得 → 朝には修正 PR |
| バグレポートの end-to-end デバッグ | レポート + Datadog ログ + DB アクセスを Devin に渡す → 根本原因 |
定期ハイジーン(ドキュメントで最も ROI の高いページ)#
| レシピ | 頻度 |
|---|---|
| 週次の依存関係更新 PR | 週次:古いパッケージ → テスト済みアップグレード PR |
| ステージングでの夜間 E2E | 夜間:スイート実行、失敗分をチケット化 |
| マージ済み PR からの週次変更履歴 | 金曜:分類済み変更履歴 → Slack |
| Datadog ヘルスの日次ダイジェスト | 日次:エラースキャン → Slack ダイジェスト |
| デザインシステムの日次監査 | 日次:マージ済み PR のハードコード色・欠落トークンを検出 |
| フィーチャーフラグの掃除 | リリース後に一度だけのセッションでフラグ + デッドコードを剥がす |
| Notion ステータスの週次ダイジェスト | 週次:PR/コミット要約 → Notion |
| 会議議事録からの PR | 毎時:Granola をポーリング → エンジニアリングタスク抽出 → 子セッション |
コード品質#
| レシピ | 仕組み |
|---|---|
| マージ前に PR のバグを自動修正 | Devin が全 PR をレビューし、ブランチに修正をプッシュ |
| サービスへのユニットテスト追加 | テスト作成スキルを構築し、課金フロー/返金/webhook に適用 |
| ビジュアルリグレッションの捕捉 | リポジトリスキル:PR 前に影響ページすべてをスクリーンショット |
| 全 PR のマイグレーションチェックリスト | リポジトリスキルが破壊的操作を捕捉し、スキーマ変更を検証 |
| モノリシックルーターの分割 | 2,000 行の Express ルーター → 共有ミドルウェア付きドメインルート |
| コードカバレッジの向上 | Devin がスイートを分析し、ギャップを埋めるテストを作成 |
| リポジトリ横断の既知 CVE パッチ | 公式スキル(devin-vuln-fixes):読み取り専用棚卸し → 承認ゲート → 確認済み対象パッチ → before/after テスト → リポジトリごとに 1 PR |
マイグレーション & 機能開発#
| レシピ | 仕組み |
|---|---|
| 50 ファイルの REST→GraphQL | スコープ → 競合しないパッケージ → 並列(ガイド 11) |
| React 18→19 アップグレードスキル | 公式アップグレードガイドを自社コードベース向けの段階的スキルに変換 |
| OpenAPI 仕様 → 実装 | YAML 仕様 → Express ハンドラ + Zod バリデーション + Supertest |
| Stripe チェックアウトフロー | 仕様 → 動作するフロー + テスト + ブラウザ検証 |
| Next.js アプリの i18n | next-i18next 導入、文字列抽出、3 言語ブラウザチェック |
| Figma → ピクセルパーフェクト | Figma MCP → モックアップからコンポーネント |
| Django アプリの Docker 化 | マルチステージ Dockerfile + Django/Postgres/Redis 用 compose |
プロジェクト管理 & データ#
| レシピ | 仕組み |
|---|---|
| Linear 経由のバグ自動トリアージ | ラベル適用 → Devin が調査 |
| PRD → スプリントチケット | Notion PRD → スコープ済み Linear チケット |
| バックログの実装計画 | Linear チケットを複数選択 → 信頼度スコア付き計画 |
Slack の /dana データクエリ |
どのチャネルからでも平易な英語でデータベースクエリ |
| カスタム API 使用状況ダッシュボード | Devin が v3 API 上にオーダーメイドのダッシュボードを構築 |
Devin 自体の上達("Devin Optimization")#
| レシピ | 教訓 |
|---|---|
| 機能プロンプトを 42→12 ACU に削減 | 高コストセッションの解剖:3 つの根本原因 → プロンプト書き直し |
| 1 問題を 3 セッションで競争 | 並列セッションが競合する最適化戦略を試行;ベストを出荷 |
| 夜通し 8 並列セッション | テストなしモジュール 8 個 → 朝にはユニットテスト PR |
| 30 ライブラリの評価 | ライブラリごとに 1 セッション → スコア付きランキング比較 |
| ホットフィックスをスキル化 | 成功したインシデントセッションを再利用可能なスキルに抽出 |
| 週次のナレッジ重複排除 | 定期セッションがナレッジ提案をマージ・競合整理 |
| チームオンボーディングガイド | Devin が自社ドキュメントを読む → あなたのスタック向け入門ガイド |
このクックブックの使い方#
- 定期ハイジーンから 1 レシピ選ぶ — 最も安い初勝利(考えなくても回り続ける夜間/週次ループ)
- PagerDuty/Datadog/Sentry があれば インシデントから 1 つ追加
- レシピが動いたら スキル(ガイド 12)か Bot(ガイド 1–5)に凍結する — 上の行すべてはどちらかの形で生き残る
実録ウォークスルー — レシピを1本実演、Devin CLI v3000.14(swe-2-flash-medium)で収録#
Code quality 棚の Raise code coverage レシピを端から端まで実行:意図的にテスト不足にした orders.py(割引コード、送料ティア、エッジケース)を持つ小さなリポジトリで。プロンプトは一行、あとは Devin 任せ。
動画(74 秒、無音): レシピプロンプト → ファイル読込 → テスト作成 → コマンド承認 → 全パス。
1. swe-2-flash-medium の CLI REPL — Pro プラン、無料枠
2. レシピプロンプト送信 — 最初に orders.py と test_orders.py を読む
3. テスト作成 — +43 行で空カート・割引コード・全送料ティアを網羅
4. コマンド承認 — python3 -m unittest -v test_orders.py が Allow を待つ
5. 11 テスト全パス — 未テストだった全ブランチを列挙;orders.py 無変更、コミットなし
6. /exit 後に検証 — Ran 16 tests ... OK、変更は指示どおり未コミット
検証チェックリスト#
- [ ] ハイジーンレシピ 1 つがスケジュールで動き、最初の PR/レポートを出した
- [ ] その出力がスキル・プレイブック・Bot に凍結されている — 誰かの頭の中に住んでいない
落とし穴#
- レシピ 10 個、凍結ゼロ。 手動プロンプトのままのレシピは金曜には忘れられる — 運用化するか捨てるか。
- 自社リポジトリの検証なしのコピペプロンプト。 ギャラリーのプロンプトはテストスイートの存在を前提にしている;タスクだけでなくチェックを適応させる。
理解度チェック#
- なぜインシデント対応より先に定期ハイジーンレシピから始めるのか?(最も安い勝利だから — 寝ている間に回り、夜間 lint 修正の失敗は回復可能だが、インシデント操作の失敗は回復不能だ。)
- 「レシピをスキルか Bot に凍結する」とは実際に何を防ぐのか?(プロンプトドリフトと個人依存 — レシピは書いた人を越えて生き残る。)
- なぜタスク部分より先にギャラリープロンプトの検証部分を適応させるのか?(タスクは意図を記述するだけ;チェックこそが自社リポジトリが実際に証明できるもの — 間違ったチェックは自信満々のゴミを生む。)
出典#
- Use-case gallery — 上の全レシピ、それぞれコピペプロンプト付き
- Best Practices — スライスの教義
- Use-case tutorials — API 統合、コードカバレッジ、コンテナ化、フロントエンドコンポーネント、MCP
- 関連:ガイド 11 — スケールするマイグレーション · ガイド 6 — オートメーション
