← ガイド · English · Português · 中文

更新 2026-11-19

このページの目次
  1. このガイドが最初にある理由
  2. 他のすべてを支える4つのルール
  3. 公式の見本ブリーフの解剖
  4. 防衛線の向こう:自分に残すもの
  5. 「指示」から「所有」へ
  6. 実録ウォークスルー — Devin CLI v3000.14(swe-2-flash-medium)で収録
  7. 確認
  8. 落とし穴
  9. 理解度チェック
  10. ソース

ガイド 18 — Devin への伝え方:プロンプトの教義

ゴール: Devin が読み違えようのない指示を書く——仕上がるセッションと迷走するセッションの分かれ目。 レベル: ここから始める ソース: Coding Agents 101(Cognition、2025年6月)· Instructing Devin Effectively——どちらも公式。以下は要点+現場注釈

このガイドが最初にある理由

このリポジトリのすべてのガイドが前提にするスキルがひとつある:欲しいものを Devin が誤解しようのない形で伝えられること。Cognition 自身の2つのガイダンス——Coding Agents 101 と docs の Instructing Devin Effectively——は異なる角度から同じことを言っている:エージェントを最も活用しているエンジニアは、願い事を書くのではなく、ジュニアな同僚にブリーフするように書く。 このガイドはその教義の凝縮版であり、カリキュラムの残りに繋がっている。

他のすべてを支える4つのルール

1. 「何を」だけでなく「どう」を言う。 「search モジュールの C++ バインディングを直して新しいユニットテストを通して——注意、変更のたびにバインディングを再コンパイルしてからテストして」。自分のコードベースの罠は自分が一番知っている。書き出せ。オープンエンドな指示(「アプリを良くして」「DB のパフォーマンスを改善して」)はオープンエンドな結果を返す。

2. どこから始めるかを教える。 リポジトリ、ディレクトリ、ファイル、参照実装、ドキュメント URL——そのタスクがあなたの机に来たら欲しいものすべて。「authTemplate.rs を参考にエラーハンドリングの一貫性を保って」は、スタイルの長文に毎回勝つ。

3. 成功をチェック可能な形で定義する。 「ちゃんと動くこと」ではなく——Devin が実行できるチェック:エンドポイントが X/Y/Z フィールド付きで 200 を返す、1440px と 375px で console エラーなしにレンダリングされる、npm test がグリーン。Devin は完全なマシンを持っている——ブラウザ、シェル、IDE。自分で検証させよ(「npm run dev を実行して /settings が描画されることを確認」)。PR を見る前に QA が終わっている。

4. フィードバックの雰囲気ではなくループを与える。 型チェッカー、リンター、テスト、CI——エージェントの超能力はエラーメッセージに対して反復すること。リポジトリが間違いを教えられないなら、あなたがフィードバックループになる。それは一番高い構成だ。

公式の見本ブリーフの解剖

Cognition 自身のモデルプロンプトに注釈:

In the Devin repo, build a tool that monitors RAM and CPU usage of the remote machines Devin runs on.——スコープと目的を1行で

  • Create a background task that launches when devin.rs starts——かたまりではなく段階的に
  • It opens a connection to all forked remote machines and monitors usage——仕組みを名指し
  • If usage exceeds 80%, emit a new type of Devin event (check how we use Kafka)——成功基準 + 既存パターンへのポインタ
  • Architect so it doesn't block other operations——作者だけが知る制約

ないものに注目:美的意見、留保、「たぶん」「良いと思えば」。すべての行がシステムを知る人間の下した決定だ。

防衛線の向こう:自分に残すもの

101 ガイドは限界について率直だ:大きなチケットでは ~80% の時間削減を期待し、完全自動化ではない。 数ファイルを超えるものは複数回のフィードバックを見込め。勝つ姿勢はジュニアのドラフト PR をレビューするアーキテクト——正しさはあなた、キーストロークは Devin。

実際の帰結:

「指示」から「所有」へ

セッション指示は「このタスクをうまくやれ」に答える。Bot の outcome prompt は「この領域を持て」に答える。教義は同じ——具体性、境界、チェック可能な成功——だが対象がタスクから責任に変わる。ここが流暢になったら、outcome-prompts リファレンスが同じ筋肉で Android Bot の 1,134 PR を生む様子を見せてくれる。

実録ウォークスルー — Devin CLI v3000.14(swe-2-flash-medium)で収録

使い捨ての demo-repo でドクトリンを実演:4 行のブリーフ——方法+機構、ファイル名指名、検証可能な成功条件、明示の境界。1 セッション、途中確認ゼロ、自己検証済み。

動画(90 秒、無音): ブリーフ → 編集 → 権限プロンプト → セルフチェック → 境界遵守。

SWE-2 Flash Medium がタスク完了 — 5 件の unittest 全パス、コミットなし

1. demo-repo の CLI REPL、SWE-2 Flash Medium — composer 準備完了 1. demo-repo の CLI REPL、SWE-2 Flash Medium — composer 準備完了

2. そのブリーフ — 4 行に 4 つのルール:方法、起点、成功条件、境界 2. そのブリーフ — 4 行に 4 つのルール:方法、起点、成功条件、境界

3. 途中:test_app.py を記述中 — 権限プロンプトは Allow / accept-edits / bypass / deny 3. 途中:test_app.py を記述中 — 権限プロンプトは Allow / accept-edits / bypass / deny

4. 自己検証:エージェントが指名どおりのチェック python3 -m unittest -v を要求 4. 自己検証:エージェントが指名どおりのチェック python3 -m unittest -v を要求

5. 完了 — 5 テスト全パス;報告自体が境界を確認「No commit made.」 5. 完了 — 5 テスト全パス;報告自体が境界を確認:「No commit made.」

6. /exit 後 — devin -r 再開ヒントと、境界が守られた git status:2 ファイル変更、新規コミットなし 6. /exit 後 — devin -r の再開ヒント、境界が守られた git status:2 ファイル変更、新規コミットなし

確認

落とし穴

理解度チェック

  1. 「ユニットテストを追加」が「poller.ts のリトライパスにユニットテストを追加、fetch をモック、タイムアウトと 5xx をカバー」に負ける理由は? 後者はエージェントが判断を下す必要をなくす:何をテストし、どのエッジが重要で、何をモックするか。明記されない決定はすべて、あなたが制御しないコイントス。
  2. Devin がきれいな diff とグリーン CI の PR を出した。完了? まだ——CI グリーンはチェックが通ったという意味で、意図が満たされた証拠ではない。最終検証レイヤーはあなた。その非対称が取引の本質(~80% 削減、正しさは人間)。
  3. 指示はいつ Skill に昇格する? 同じものをまた打っていると気づいた時。3 度目は SKILL.md——フォーマットと発見パスはガイド 16。

ソース