Linear から API ドキュメントを自動生成
ドキュメント用のプレイブックを作成し、それを Linear のラベルとして同期しておけば、チケットにそのラベルを付けるだけで誰でもドキュメント生成を実行できます。ドキュメント向けのプレイブックを作成する
まずは、標準化したいタスク用のplaybookを作成します。この例では、チームメンバーがチケットにラベルを付けたときに API ドキュメントを自動生成する playbook を作成します。Settings > Playbooks に移動し、Create playbook をクリックします。名前とマクロ（例:
!add-docs）を指定します。具体的な手順をステップごとに記述します。実際のファイルパスや運用ルールを参照させて、Devin がチームの標準に従えるようにします:playbook が具体的であればあるほど、アウトプットの品質は高くなります。チームで実際に使っているドキュメントテンプレート、スタイルガイド、ツール類を参照させてください。効果的な playbook の書き方については、playbook docs も参照してください。プレイブックをLinearに同期する
まだ Linear integration を接続していない場合は、Settings > Integrations > Linear に移動し、Connect をクリックします。Devin にアクセス権を付与するチームを選択します。接続できたら、Synced playbook labels までスクロールし、Add playbook をクリックします。ドロップダウンから
!add-docs を選択します。これにより、Linear の Devin Playbooks ラベルグループの配下に !add-docs というラベルが自動的に作成されます。今後は誰かがチケットにそのラベルを追加すると、Devin がそのプレイブックを使ってセッションを開始します。プレイブックラベルを Linear に自動同期するには、Linear ワークスペースで Manage workspace labels が All members に設定されている必要があります（Linear の Settings > Security にあります）。これが有効になっていない場合は、Linear でラベルを手動で作成する必要があります。
チケットにラベルを付けてドキュメントを生成する
チームメンバーが次のようなチケットに
!add-docs ラベルを追加すると:ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.Devin が自動的にセッションを開始し、あなたのドキュメント向けプレイブックに従います:
- チケットを読む — エンドポイントの説明、パラメータ、およびリンクされた PR を取得する
- ソースコードを探す — ルートハンドラー、リクエスト検証スキーマ、レスポンスタイプを特定する
- ドキュメントを生成する — 既存のフォーマットに従って
docs/api/に新しいページを作成する - PR を作成する — 新しいドキュメントページと更新されたサイドバーを含める
!add-docs ラベルを追加すると、複数のエンドポイントのドキュメントを並列で生成できます。チーム向けプレイブックをさらに作成する
同じパターンは、あらゆる定型的なタスクに使えます。プレイブックを作成してラベルとして同期すれば、チームはどのチケットからでもそれをトリガーできます。例えば次のようなものがあります:
!write-tests— チケットに記載された機能に対してテストカバレッジを追加する!refactor— チームの規約に従ってコードをリファクタリングする!security-audit— セキュリティ上の脆弱性についてコードをレビューし、修正を含む PR を作成する!migrate— 標準化されたマイグレーション（依存関係のアップグレード、API バージョンの更新）を実行する