← ガイド · English · Português · 中文
このページの目次
Bot 成果プロンプト、解剖
目標: 文書化された導入が実際にやったように成果プロンプトを書く——タスクリストではなく領域の所有。 レベル: 中級 · 所要時間: 草案 20 分、調整に 1 週間
大きな数値を出した公開 Bot 導入はすべて、成果を割り当てる短いプロンプトから始まった。このガイドは実物を集め、なぜ機能するのかを逆工学する。
模範例#
"your job is to product manage the android app"
Android Bot の割り当てのすべて。一文が 44 日間の自走的作業を生んだ:Bot は成果を自分で書いたチケットに分解し、チケットごとに Devin セッションを回し、1,134 のマージ PR を出荷した(ローンチ記事)。プロンプトに含まれないものに注目:チケットリストなし、受入基準なし、スケジュールなし。成果そのものがそれらすべてを含意する。
機能する成果プロンプトの構造#
| 要素 | 役割 | 例 |
|---|---|---|
| 役割 | 何を作るかだけでなく、どう振る舞うかを伝える | "product manage"、"own the QA of onboarding flows" |
| 境界のある領域 | Bot が全体を見通せるスコープ——アプリ、チェック、データソース | "the android app"、"layout regressions"、"30+ onboarding flows" |
| 暗黙の完了定義 | Bot が自己検証できる状態 | "feature parity with iOS"、"no layout-shift regressions"、"every flow green" |
| 恒常の権限 | Bot がいつと次に何をを決める——それがスクリプトではなく Bot たる所以 | "your job is to…"、"keep…"、"watch for…" |
公式テンプレートマーケットプレイスのパターン#
16 のマーケットプレイステンプレートはすべて同じ文法に従う。汎化した再利用可能な定式:
領域の所有 —— "Find bugs, improvements, performance and refactoring work in a named product area; open one small PR at a time with proof it works."(Software Factory)
チェックの所有 —— "Every 3 hours, build production main, simulate first/repeat/deferred visits, and file fixes with before/after videos for any regression you introduce—or find."(Layout Bot パターン)
ライフサイクル段階の所有 —— "Take a ticket or an ask to a tested PR and through review."(Product Engineer)
ケイデンスの所有 —— "Weekly: remove dead code, one safe PR per round."(Code Reaper)——定期成果はトリガーではなくリズムとして述べる。
チーム代謝の所有 —— "Watch the channels, post updates, hand work to the right teammate, follow up until done."(Chief of Staff)
衛生の所有 —— "Old flags, stale deps, CVEs — turned into small safe PRs."(Code Health Engineer)
マルチ Bot 組織:権限を与えるプロンプト#
艦隊(SuperJennyStack、Frankie、tigsbot)では、チーフ Bot のプロンプトにルーティング契約が含まれる:どの Bot がどの領域を所有するか、横ではなく上にエスカレートするのはいつか。人間の真のプロンプトは集約仕様:「すべての未決事項を 1 スレッドに持ってこい」。完全な組織図はガイド 4を参照。
アンチパターン#
- タスク型プロンプト。 「この 12 issue を直せ」——Bot は終わってアイドルになる;Bot ではなくセッションを得る。
- 検証不能な成果。 「アプリを良くして」——自己チェックがないと、Bot の唯一の出口は Needs-you スパム。
- 隠れたスコープ。 成果が Bot に見えないシステム(届かないステージング環境、読めないダッシュボード)を必要とするなら、停滞するか進捗を幻覚する。領域を与えるか成果を縮める。
- マージ権限の物語なし。 88% の自己マージ率が存在するのは CI とレビューゲートが自律マージ用に事前設定されていたから。明記する:"merge when CI is green and diff < N lines" または "always open as draft for human review"。
あなたのものを起草——3 行テスト#
良い成果プロンプトは順に答える:
- あなたのものは何か? —— 領域
- 良い状態とは? —— 検証可能な状態
- それに対し何をするか? —— 恒常の振る舞い
部外者が 2 行目の真偽を外部から判定できないなら、絞り直す。
検証チェックリスト#
- [ ] リポジトリの実バックログ項目を取り、成果プロンプトに書き直した——領域、検証可能な状態、恒常の振る舞い
- [ ] コードベースを知らない人に見せた:Bot が「勝っている」か外部から判定できるか?
- [ ] Bot の最初の返信が計画かスコープの確認質問であるべき——「最初に何をすればいい?」と聞いたら、プロンプトは所有を割り当てていない
落とし穴#
- 成果の衣を着たタスクリスト。 「X、Y、Z を順にやれ」はチェックリストのまま——世界が変わっても Bot は優先順位を付け直せない。
- 「良い」の定義なき「アプリを良く保て」。 検証可能な状態がなければ Bot が勝手に定義を選ぶ——あなたのものではない。
- 1 領域を超えるスコープ。 「エンジニアリングを所有せよ」は失敗する;「iOS アプリを所有せよ」は出荷する。外部の一人が完全に観測できる単位で分割する。
理解度チェック#
- なぜ "fix Android bugs" より "own the Android app" が良いか?(所有は恒常の判断を含意する——Bot は直すかどうかだけでなく、どのバグが重要かを決める)
- "make the CI fast" の何が悪いか?(外部から検証不能——閾値がない。"CI under 8 minutes" は検証可能)
- "text me if tests fail" は 3 問のどれに答えているか?(恒常の振る舞い——状態に対し Bot が何をするかは言うが、領域も目標も言わない)
実録 —— outcome プロンプト vs タスク プロンプト、Devin CLI v3000.14(swe-2-flash-medium)で実演#
Bot には Max または Teams プランが必要——しかしこのガイドが教えるプロンプトの仕組みは surface に依存しないため、無料の SWE-2 CLI 枠で収録。同じリポジトリ(orders.py、ベースラインはテスト 2 件のみ)、同一のコピーを 2 つ用意し、それぞれに 1 つずつプロンプトを投入:
- タスク型: 「apply_discount('SAVE10') が 90.0 を返すテストと total([]) が 0 を返すテストを追加……」
- outcome 型: 「orders.py のテストカバレッジをあなたの担当領域とする。良い状態:total・apply_discount・shipping_fee の全分岐にテストがあり、python3 -m unittest -v が全緑。」
動画(64 秒・無音): ベースライン → タスク実行 → +6 行 → outcome 実行 → 自ら分解したカバレッジマップ → +37 行。
1. タスク型プロンプト——エージェントに渡したのは買い物リスト
2. タスク型:リストを終えたら停止——オーナーではなくセッション
3. outcome 型:役割 + 境界ある担当面 + 「良い状態」の定義——チェックリストなし
4. どのテストを書くか教えていない——+39 行、分岐はすべて自己列挙
5. 「良い状態」の定義に照らして検証し、カバレッジマップを報告
6. 同モデル・同リポジトリ、違いはプロンプトの形だけ:+6 対 +37、テスト 4 対 13
出典#
- Introducing Devin Bots · Bots ドキュメント · テンプレートマーケットプレイス
- built-with-devin にリンクされた導入レポート
