dovetail-automation

dovetail-automation skill の概要

dovetail-automation の用途

dovetail-automation は、Composio の Rube MCP toolkit を通じて Dovetail の操作を自動化するための Claude skill です。すでに Dovetail をリサーチ、フィードバック、インタビュー、インサイトリポジトリに利用しているチームが、プロダクト画面を手作業で移動せずに、反復的な Dovetail タスクを AI エージェントに実行させたい場合に向いています。

dovetail-automation skill の実用的な価値は、固定された API 仕様を覚えていることではありません。重要なのは、まず Rube tools を検索し、現在の Dovetail tool schema を取得し、アクティブな Dovetail connection を確認してから実行する、という運用ルールにあります。

向いているユーザーとワークフロー

この skill は、Claude に Dovetail のプロジェクト検索、リサーチ記録の作成・更新、データ整理、Rube MCP で公開されているその他の Dovetail toolkit アクションを手伝わせたいユーザーに適しています。MCP 対応の Claude 環境を使い、Composio/Rube を自動化の橋渡しとして利用しているチームに合います。

特に相性がよいのは、分析よりも運用寄りのタスクです。たとえば「この Dovetail item を作成する」「一致する Dovetail records を探す」「この workspace object を更新する」「schema を確認したうえで、利用可能な Dovetail workflow を安全に実行する」といった用途です。

主な差別化ポイント: schema-first automation

dovetail-automation で最も重要な挙動は、tool discovery が必須であることです。この skill は、実行前に RUBE_SEARCH_TOOLS を呼び出し、現在の tool slugs、input schemas、execution plans、pitfalls を取得するようエージェントに指示します。MCP tool schemas は変わる可能性があり、パラメータを推測することは自動化失敗のよくある原因なので、この点は重要です。

導入要件と制限

クライアントで Rube MCP が接続されており、RUBE_MANAGE_CONNECTIONS を通じて管理される有効な Dovetail connection が必要です。リポジトリには単一の SKILL.md のみが含まれ、追加のスクリプト、例、参照ファイルはありません。そのため、導入の成否は MCP 環境が正しく設定されているかに依存します。Dovetail を使っていない場合、または Rube MCP を有効化できない場合、この skill は適していません。

dovetail-automation skill の使い方

dovetail-automation のインストール前提

skill manager を使い、GitHub source から skill をインストールします。例:

npx skills add ComposioHQ/awesome-claude-skills --skill dovetail-automation

次に source file を確認します。

composio-skills/dovetail-automation/SKILL.md

skill 自体は、Rube MCP が https://rube.app/mcp で利用できることを前提にしています。Claude 互換クライアントにその MCP server を追加し、RUBE_SEARCH_TOOLS が利用可能であることを確認してください。Dovetail connection は、toolkit dovetail を指定した RUBE_MANAGE_CONNECTIONS を通じてアクティブになっている必要があります。

実行前に skill が必要とする入力

dovetail-automation を安定して使うには、Claude に曖昧な依頼だけを渡さないことが重要です。以下を含めてください。

• 実現したい Dovetail 上の具体的な結果
• 関連する project、workspace、note、tag、person、research object の名前
• 先に検索するのか、新規データを作成するのか、既存データを更新するのか、計画案だけを作るのか
• 「重複を作らない」「records を変更する前に確認する」などの制約
• Dovetail content を追加・更新する workflow の場合、使用する元データ

弱いプロンプトの例: “Update Dovetail.”
よりよいプロンプトの例: “Use dovetail-automation to search available Dovetail tools, confirm the Dovetail connection is active, find the project named ‘Q4 onboarding research,’ and prepare a safe update plan for adding these three interview summaries. Do not write changes until I approve the target records.”

安全に実行するための推奨ワークフロー

各セッションは tool discovery から始めます。

RUBE_SEARCH_TOOLS with a use case such as “find Dovetail projects and update research notes.”

次に Dovetail connection を確認します。

RUBE_MANAGE_CONNECTIONS with toolkit dovetail.

connection が ACTIVE になってから、Claude は検出済みの schema に従って、返された Dovetail tool slugs を呼び出すべきです。records が変更される可能性がある場合は、実行前に、選択した tool、必須 fields、予定している action をエージェントに表示させてください。

この流れが dovetail-automation ガイドの中核です。tools を検出し、connection を確認し、タスクを現在の schema に対応づけ、実行し、最後に結果を検証します。

リポジトリで最初に読むべきファイル

まず SKILL.md を読んでください。skill 全体がこのファイルに含まれています。この skill directory には、同梱スクリプト、rule folders、reference examples、metadata files はありません。Prerequisites、Setup、Tool Discovery、Core Workflow Pattern という見出しのセクションに特に注意してください。Dovetail schema を決め打ちせず、必ず先に Rube に問い合わせる、という運用上の契約が定義されています。

dovetail-automation skill FAQ

dovetail-automation は Workflow Automation 向けか、リサーチ分析向けか

dovetail-automation for Workflow Automation と捉えるのが適切です。この skill は、エージェントが MCP tools を通じて Dovetail を操作するためのものです。定性的リサーチの判断、インサイトの統合、調査設計を置き換えるものではありません。分析的なプロンプトと組み合わせることはできますが、本来の目的は tool に裏付けられた Dovetail 操作です。

通常の Claude プロンプトより何が優れているのか

一般的なプロンプトでは、Dovetail の操作手順を文章で出したり、API fields を推測したりする可能性があります。dovetail-automation skill は、Claude に Rube MCP を使わせ、現在の tool schemas を検出し、connection を確認し、利用可能な Dovetail tools 経由で実行するよう指示します。これにより推測が減り、実際の MCP 環境に基づいた自動化になりやすくなります。

dovetail-automation skill は初心者にも使いやすいか

MCP client がすでに設定済みである、または MCP server の追加に慣れているなら、初心者にも扱いやすい skill です。Dovetail 側の workflow はわかりやすい一方で、セットアップには、利用している client が MCP configuration をどこに保存するか、返された Rube connection flow を通じて Dovetail toolkit をどう認証するかを理解している必要があります。

この skill をインストールしないほうがよい場合

単体で動く Dovetail exporter、ローカルスクリプト、完全なリサーチ分析フレームワーク、MCP なしで動作する skill を探している場合はインストールしないでください。また、実行前の確認ステップや tool inputs のレビューを必須にするつもりがないなら、リスクの高い一括編集にも向いていません。

dovetail-automation skill を改善する方法

よりよいプロンプトで dovetail-automation の結果を改善する

最も効果が大きい改善は、タスクの切り出し方を明確にすることです。広い Dovetail action を依頼するのではなく、object type、desired operation、matching criteria、approval policy を明示します。

よいパターン:

“Use dovetail-automation. First run RUBE_SEARCH_TOOLS for tools that can search and update Dovetail notes. Confirm the Dovetail connection is active. Find records matching [criteria]. Show me the matched records and proposed changes before making updates.”

このように指定すると、エージェントは live schema に従いながら、安全に tools を選ぶための十分な構造を得られます。

書き込み操作にガードレールを追加する

create、update、delete、tagging、一括整理のタスクでは、計画と実行を分けるよう Claude に指示してください。役立つガードレールには次のようなものがあります。

• “Search before creating anything.”
• “Do not modify records until I approve.”
• “Show the exact tool slug and required fields.”
• “If multiple records match, stop and ask.”
• “After execution, verify the changed record.”

これらの制約により、重複 records、誤った更新、気づかないままの失敗を減らせます。

注意すべきよくある失敗パターン

最も多い失敗は、RUBE_SEARCH_TOOLS を省略して古い schema を前提にしてしまうことです。次に多いのは、Dovetail connection が active になる前に実行しようとすることです。3つ目は、record 名が曖昧で、エージェントが誤った project や note を選んでしまうケースです。

実行に失敗した場合は、どの段階で失敗したのかを Claude に報告させてください。tool discovery、connection management、schema mapping、execution、verification のどこで止まったのかを切り分けると、タスク全体をやり直すよりも早くトラブルシュートできます。

skill を実用面で拡張する方法

このリポジトリは、よくある Dovetail workflows 向けの example prompts、inactive connections に関する短い troubleshooting section、書き込み操作向けの approval-first patterns のサンプルがあると、さらに使いやすくなります。「find a project」「add interview notes」「update tags after review」のようなタスク別レシピがいくつかあれば、schema-first design を弱めることなく、dovetail-automation skill を導入しやすくできます。