Skip to main content

チーム専用の Devin オンボーディングガイドを生成する

Devin が自身のドキュメントを読み取り、あなたのチームのスタック、連携、ワークフローに合わせてカスタマイズされた導入ガイドを生成します — Notion や Slack でそのまま共有できます。
AuthorCognition
CategoryDevin の最適化
FeaturesMCP
1

Devin にガイドの作成を依頼する

Devin には、Devin Docs MCP を通じて Devin 自身のドキュメントへアクセスする機能が組み込まれており、セットアップや設定は一切不要です。ドキュメントサイト全体、APIリファレンス、変更履歴、ベストプラクティスを、必要に応じて検索・閲覧できます。新しいエンジニアにドキュメントリンク集を送る代わりに、Devin に依頼して、あなたのチームに必要な内容だけを抽出し、スタックに合わせたプロンプト、ワークフロー、例を含む、1つのオンボーディングガイドとしてまとめてもらいましょう。
2

作成されたガイドを確認する

Devin は各トピックごとにドキュメントを検索し、関連するページを読み、あなたのスタックとワークフローに合った完全なオンボーディングガイドを作成します。出力は次のようになります。
# Getting Started with Devin — Acme Engineering Team

## 1. Starting a Session
| Method | When to use | Example |
|--------|-------------|--------|
| **Slack** — message @Devin | Quick, scoped tasks | "Fix the failing CI in api-service" |
| **Web app** — app.devin.ai | Longer tasks needing file attachments or playbooks | Attach a migration playbook + spec file |

## 2. Writing Effective Prompts
Devin works best with specific, scoped requests. Always include
the file path, what's broken, and when it started.

❌ "Fix the login bug"
✅ "The login form at src/pages/Login.tsx returns a 401 for valid
   credentials since the JWT key rotation on Friday. Check the
   auth middleware at src/middleware/auth.ts."

## 3. Linear Integration
Go to Settings > Integrations > Linear and authorize. Once
connected, Devin can:
- Pick up tickets assigned to it automatically
- Update ticket status as it works
- Link PRs to the originating Linear ticket

See the full setup guide: docs.devin.ai/integrations/linear

## 4. Playbooks for Recurring Tasks
Create reusable prompts at Settings > Playbooks > Create New.
For our Express-to-Fastify migration, the playbook should include:
- The target module path (e.g., src/services/payments/)
- Test commands: npm run test:api && npm run test:integration
- Rollback steps if the migration breaks downstream consumers

## 5. Knowledge — Teaching Devin Our Conventions
Add team conventions at Settings > Knowledge > Add Knowledge.

Example entry:
  Trigger: "working on API routes"
  Content: "We use Fastify, not Express. All routes live in
  src/routes/. Run npm run test:api before committing.
  Error responses must use the ApiError class from src/lib/errors.ts."
3

フォローアップを追加してガイドを拡張する

同じセッションを開いたままにしておきましょう — Devin はコンテキストを保持し、ガイドにセクションを追加して拡張できます。
4

ガイドを共有し、最新に保つ

ガイドの内容が整ったら、それを共有し、Knowledge として保存しましょう。そうすることで、Devin 自身があなたのチームのルールや慣例を参照できるようになります。
  1. ガイドを共有する — Notion ページを #engineering チャンネルに貼り付けるか、チームの wiki にピン留めします
  2. Knowledge として保存する — Settings > Knowledge > Add Knowledge に移動し、トリガーを "onboarding new team members to Devin" に設定し、ガイドの内容を貼り付けて、すべてのリポジトリ にピン留めします
これで、どのチームメンバーが Devin に「how should I write prompts?」や「how do I connect Linear?」と質問しても、一般的なドキュメントではなく、あなたのカスタマイズ済みガイドを元に回答するようになります。Devin が新機能をリリースしたら、同じセッション形式でガイドの更新を依頼してください。たとえば、次のように依頼します: “Read the latest changelog and update our onboarding guide with any new features that affect our workflows.”