<p data-line="0" class="code-line">こんにちは。先生向け学習管理用ツールを開発しているQMチームのEM、Itaです。<br>
今回はDevinとAsanaの連携方法についてわかりやすく説明していきたいと思います。</p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="3" class="code-line">この記事はこんな方におすすめ</p>
<ul data-line="4" class="code-line">
<li data-line="4" class="code-line">Devinの管理面の弱さに困っている方</li>
<li data-line="5" class="code-line">DevinとAsanaを両方利用している方</li>
<li data-line="6" class="code-line">Devinに渡すプロンプトの品質を楽に向上させたい方</li>
</ul>
</div></aside>
<h2 id="%E8%83%8C%E6%99%AF" data-line="8" class="code-line">
<a class="header-anchor-link" href="#%E8%83%8C%E6%99%AF" aria-hidden="true"></a> 背景</h2>
<p data-line="9" class="code-line">DevinがLinearとネイティブ連携したと聞いて、めちゃくちゃ「うらやましい・・・！」と思いました。DevinはSlackから気軽にタスクを依頼できる反面、全体としてなにを頼んでいるのかが分かりづらくなるという管理面に弱みがあると思います。そこをタスク管理ツールで補うべく、以前からDevinがAsanaのタスクを読み書きできるようにはしていました。しかしDevin×Asana連携は公式にはサポートされておらず、Asanaから直接Devinに依頼するといったことができていませんでした。CognitionにAsana連携をリクエストしても以下の結果に終わっています。</p>
<div class="code-block-container"><pre class="language-text"><code class="language-text code-line" data-line="10">Ita: I trust you’ll support Asana as well😉
Cognition: Hopefully Asana will be supported soon!
</code></pre></div><p data-line="14" class="code-line">公式対応を待っていると<strong>年が明けてしまう</strong>可能性もあるとみてなんとかして連携できないかと模索することにしました。</p>
<h2 id="%E5%89%8D%E6%8F%90" data-line="15" class="code-line">
<a class="header-anchor-link" href="#%E5%89%8D%E6%8F%90" aria-hidden="true"></a> 前提</h2>
<ul data-line="16" class="code-line">
<li data-line="16" class="code-line">AsanaのPATをDevinのSecretに登録済みで、既にDevinがAsana APIを利用してタスクの読み書きができていること。</li>
</ul>
<p data-line="18" class="code-line">PATの取得方法、Asana APIについては<a href="https://developers.asana.com/docs/personal-access-token" target="_blank" rel="nofollow noopener noreferrer">こちら</a>をご参照ください。<br>
またPATをDevinに渡したことでなにか問題が起きたとしても<strong>すべて自己責任</strong>でお願いします。</p>
<h2 id="%E4%BB%AE%E8%AA%AC" data-line="21" class="code-line">
<a class="header-anchor-link" href="#%E4%BB%AE%E8%AA%AC" aria-hidden="true"></a> 仮説</h2>
<p data-line="22" class="code-line">何かしらの方法でDevinを起動させてAsanaのタスクを伝える必要がありました。<br>
そこで着目したのがAsanaのルール機能です。特定の条件を満たしたときにSlackでDevin宛にタスクのURLを添えてメッセージを送れば、Devinが反応するのでは？という仮説を立てました。<br>
そしてただタスクの内容を実行してもらうだけではなく、プロンプト(タスクの説明)の品質向上もサポートしてくれたら一石二鳥ではないかと思いつき、以下のメッセージを組み立てました。</p>
<div class="code-block-container"><pre class="language-text"><code class="language-text code-line" data-line="25">@Devin
以下のタスクを各観点で評価してください。
# タスク
{タスク}
# 観点
- 完了条件が明確か
- 検証方法が明確か
- 作業リポジトリや仕様や概要などコンテキストは十分か
- 問題は十分にシンプルか
- 参考情報は記載されているか
# 評価方法
各観点10点満点で評価した合計値が総合評価点となります。
総合評価点が8割を超えていたら実行プランを提示してください。
8割を超えていなければ8割を超えるようにタスクの品質改善案を提示してください。
</code></pre></div><p data-line="41" class="code-line">観点は以下の記事を参考にしました。</p>
<ul data-line="42" class="code-line">
<li data-line="42" class="code-line"><a href="https://docs.devin.ai/essential-guidelines/when-to-use-devin" target="_blank" rel="nofollow noopener noreferrer">When to Use Devin</a></li>
<li data-line="43" class="code-line"><a href="https://docs.devin.ai/essential-guidelines/instructing-devin-effectively" target="_blank" rel="nofollow noopener noreferrer">Instructing Devin Effectively</a></li>
<li data-line="44" class="code-line"><a href="https://docs.devin.ai/essential-guidelines/good-vs-bad-instructions" target="_blank" rel="nofollow noopener noreferrer">Good vs. Bad Instructions</a></li>
</ul>
<p data-line="46" class="code-line">果たしてDevinはうまく反応してくれるのか・・・！？</p>
<h2 id="%E8%A9%A6%E8%A1%8C%E9%8C%AF%E8%AA%A4" data-line="47" class="code-line">
<a class="header-anchor-link" href="#%E8%A9%A6%E8%A1%8C%E9%8C%AF%E8%AA%A4" aria-hidden="true"></a> 試行錯誤</h2>
<p data-line="48" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/c1de0553bdef-20250416.png" loading="lazy" class="md-img"><br>
メンションにならず反応してくれませんでした。以前似たルールを作成したことがあり、そのときはちゃんとメンションとしてメッセージされていたので今回のこの挙動は謎でした。<br>
この疑問を解明すべく、<strong>長年の開発で鍛え上げた原因切り分けスキル、調査スキル</strong>を駆使して試行錯誤しました。あと最近手に入れた<strong>Deep Research</strong>をちょっとだけ使いました。</p>
<h2 id="%E6%9C%80%E7%B5%82%E7%B5%90%E6%9E%9C" data-line="51" class="code-line">
<a class="header-anchor-link" href="#%E6%9C%80%E7%B5%82%E7%B5%90%E6%9E%9C" aria-hidden="true"></a> 最終結果</h2>
<p data-line="52" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/6e6a00a964c5-20250416.png" loading="lazy" class="md-img"><br>
できました！成功しました！Asanaのルール上のメッセージ内容は以下の通りです。</p>
<div class="code-block-container"><pre class="language-text"><code class="language-text code-line" data-line="54">@devin
以下のタスクを各観点で評価してください。
(以下略)
</code></pre></div><p data-line="59" class="code-line">そうです。@<strong>d</strong>evinと小文字で記述しなければならなかったのです。どうやら<code>@Devin</code>というのは表示名で内部的には<code>@devin</code>となっているようです。<br>
正しくメンションできたのでSlackに飛んだメッセージにDevinがしっかりと反応し、期待通りに処理してくれました。<br>
また、さらにメッセージを改善したことで、SlackのメッセージのリンクをAsanaのタスクにコメントしてくれるようになり、完全自動の相互接続が実現しました。<br>
最終メッセージは以下の通りです。</p>
<div class="code-block-container"><pre class="language-text"><code class="language-text code-line" data-line="63">@devin
まずこのメッセージのURLを以下のタスクにコメントしてください。
それから以下のタスクを各観点で評価してください。

# タスク
{タスク}

# 観点
・完了条件は明確か
・検証方法は明確か
・作業手順は明確か
・作業リポジトリや仕様や概要などのコンテキストは十分か
・問題は十分にシンプルか
・参考情報は記載されているか

# 評価方法
各観点10点満点で評価した合計値が総合評価点となります。

総合評価点が8割を超えていたら実行プランを提示してください。
8割を超えていなければ8割を超えるようにタスクの品質改善案を提示してください。
</code></pre></div><h2 id="%E6%88%90%E5%8A%9F%E3%81%AE%E8%A6%81%E5%9B%A0" data-line="85" class="code-line">
<a class="header-anchor-link" href="#%E6%88%90%E5%8A%9F%E3%81%AE%E8%A6%81%E5%9B%A0" aria-hidden="true"></a> 成功の要因</h2>
<p data-line="86" class="code-line">今回の成功のカギはなんといっても<strong>Deep Research</strong>です。<br>
ちょっと調べてもヒットしなかったので、調査を継続しつつDeep Researchを走らせました。そこから自分で10分ほど調べても全然ヒットせず諦めかけていたときにDeep Researchが完了して上記の仕様について知ることができました。<br>
調査は完全に人間よりもAIのほうが上手ですね。今後も堂々とDeep Researchにはお世話になり続けようと思います。</p>
<h2 id="%E7%B5%90%E8%AB%96" data-line="89" class="code-line">
<a class="header-anchor-link" href="#%E7%B5%90%E8%AB%96" aria-hidden="true"></a> 結論</h2>
<p data-line="90" class="code-line">Asanaユーザーの皆さん、Devinとの連携はできます！！<br>
Asanaのルール機能とSlack通知、そして少しの工夫を組み合わせれば、Devinをトリガー付きで動かすことが可能です！<br>
本記事ではその方法を完全公開しました。もし同じように「Devinを管理しやすくしたい」と思っていた方の助けになれば幸いです。</p>
<hr data-line="94" class="code-line">
<p data-line="95" class="code-line">最後に、、、</p>
<p data-line="97" class="code-line">株式会社COMPASSでは一緒に教育をより良くしていく仲間を募集しています。</p>
<p data-line="99" class="code-line">少しでも興味を持っていただけた方は、以下よりお気軽にご応募ください。</p>
<p data-line="101" class="code-line"><a href="https://careers.qubena.com/" target="_blank" rel="nofollow noopener noreferrer">株式会社COMPASS採用サイト</a></p>
<p data-line="103" class="code-line">とりあえず話をきいてみたい！という方はぜひカジュアル面談に来ていただけると幸いです。</p>
<p data-line="105" class="code-line"><a href="https://pitta.me/matches/tLPwBNbVWjhn" target="_blank" rel="nofollow noopener noreferrer">COMPASSってどんな会社？お話を聞いてみたい方はぜひ！</a></p>


【完全公開】Devin×Asana連携を自前でなんとかした話

Discussion