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 を作成する — 新しいドキュメントページと更新後のサイドバーを含めます
@skills:add-docs ラベルを追加すれば、複数のエンドポイントのドキュメントを並列で生成できます。4
あなたのTeamで使うスキルをさらにbuildする
同じパターンは、あらゆる定期的なタスクに応用できます。スキルを作成してラベルとして同期すれば、チームはどのチケットからでもそのスキルをトリガーできます。活用例をいくつか紹介します。
@skills:write-tests— チケットに記載された機能のテストカバレッジを追加する@skills:refactor— チームの規約に従ってコードをリファクタリングする@skills:security-audit— コードにセキュリティの脆弱性がないかレビューし、修正を含む PR を作成する@skills:migrate— 標準化された移行 (依存関係のアップグレード、API バージョンの更新など) を実行する

