Skip to main content
手動で設定するのが面倒な場合は、このページへのリンクを Devin セッションに貼り付けて、セットアップをすべて Devin に任せましょう。
1

ドキュメント作成用のスキルを作る

まず、標準化したいタスク用のスキルを作成します。この例では、チームメンバーがチケットにラベルを付けるたびに API ドキュメントを生成するスキルを作成します。Customize > Skills に移動し、+ (New skill) をクリックします。名前は add-docs とします。具体的な段階的手順を記述します。実際のファイルパスや規約を明記して、Devin がチームの標準に沿って作業できるようにします。スキルの内容が具体的であるほど、出力の質は高まります。チームで実際に使っているドキュメントテンプレート、スタイルガイド、ツールを明記しましょう。詳しくは良いスキルの書き方を参照してください。
2

スキルをLinearに同期

Linear連携をまだ接続していない場合は、設定 > 接続 > Linearに移動し、Connectをクリックします。Devinにアクセスを許可するTeamsを選択します。接続したら、スキルまでスクロールし、Add skillをクリックします。ドロップダウンからadd-docsを選択します。これにより、LinearのDevin Skillsラベルグループにスキル用のラベルが作成されます。スキル一覧には、使用するラベル (同名の同期済みスキルが他にない場合は@skills:add-docs) がコピー用のボタンとともに表示されます。以降は、誰かがチケットにこのラベルを追加すると、Devinがあなたのスキルを使ってセッションを開始します。
スキルのラベルをLinearに自動で同期するには、LinearワークスペースでManage workspace labelsがAll membersに設定されている必要があります (LinearのSettings > Securityで設定できます) 。この設定が有効になっていない場合は、Linearでラベルを手動で作成してください。
3

チケットにラベルを付けてドキュメントを生成する

チームメンバーが次のようなチケットに @skills: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 が自動的にセッションを開始し、ドキュメント作成用のスキルに従って作業します。
  • チケットを読み込む — エンドポイントの説明やパラメータ、リンクされたプルリクエストを取得します
  • ソースコードを特定する — ルートハンドラー、リクエスト検証スキーマ、レスポンス型を探し出します
  • ドキュメントを生成する — 既存のフォーマットに沿って docs/api/ に新しいページを作成します
  • PR を作成する — 新しいドキュメントページと更新後のサイドバーを含めます
一括操作にも便利です。Cmd+A で複数のチケットを選択して右クリックし、@skills:add-docs ラベルを追加すれば、複数のエンドポイントのドキュメントを並列で生成できます。
Linear連携をインストールすると、Devin は Linear のツールにネイティブにアクセスできます。そのため、結果に応じてチケットのラベルやステータスを更新するよう、スキル内で Devin に指示できます。ラベルは他の自動化をトリガーできるので、ワークフローを連鎖させることも可能です。例:ドキュメントの生成後に Docs Ready ラベルを付けて、テクニカルライターにレビュー依頼を通知する、といった使い方ができます。
4

あなたのTeamで使うスキルをさらにbuildする

同じパターンは、あらゆる定期的なタスクに応用できます。スキルを作成してラベルとして同期すれば、チームはどのチケットからでもそのスキルをトリガーできます。活用例をいくつか紹介します。
  • @skills:write-tests — チケットに記載された機能のテストカバレッジを追加する
  • @skills:refactor — チームの規約に従ってコードをリファクタリングする
  • @skills:security-audit — コードにセキュリティの脆弱性がないかレビューし、修正を含む PR を作成する
  • @skills:migrate — 標準化された移行 (依存関係のアップグレード、API バージョンの更新など) を実行する
また、自動化を設定すれば、誰もラベルを付けなくても Devin が自動的に作業を開始します。設定 > 接続 > Linear に移動し、自動化 までスクロールして Add automation をクリックします。次に、チケットが特定のステータスに遷移したとき、または特定のラベルが付与されたときに発生する自動化を設定します。