breeze-automation

breeze-automation skill の概要

breeze-automation でできること

breeze-automation は、Composio の Rube MCP server を通じて Breeze のプロジェクト管理タスクを自動化するための Claude skill です。MCP tools を呼び出せるエージェント向けに設計されており、利用可能な Breeze actions の探索、認証状態の確認、そしてハードコードされた例に頼らず現在の tool schema に基づいた Breeze 操作の実行を支援します。

Workflow Automation ユーザーに向いているケース

breeze-automation skill は、すでに Breeze を使っていて、反復的なプロジェクト操作に AI 支援の Workflow Automation を取り入れたいチームに適しています。たとえば、タスクの検索、レコードの更新、プロジェクトデータの整理、複数ステップのタスク管理フローの構築などです。特に、エージェントが Rube MCP にアクセスでき、より安全な tool 利用パターンを取りたい場合に有効です。つまり、まず tools を探索し、Breeze connection を確認し、実行してから結果を検証する流れです。

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

breeze-automation の重要な設計上の特徴は、Breeze action を実行する前にエージェントへ RUBE_SEARCH_TOOLS を呼び出させることです。これは、Composio tool schemas が変更される可能性があるため重要です。記憶にある parameter 名を推測するのではなく、実行時に現在の Breeze tool slugs、input fields、execution guidance、既知の注意点を取得する前提になっています。

導入に必要なものと制限

これは単体で動作する Breeze API client ではありません。MCP 対応 client、https://rube.app/mcp に設定された Rube MCP、そして RUBE_MANAGE_CONNECTIONS で管理される有効な Breeze connection が必要です。repository path には SKILL.md のみが含まれているため、scripts、examples、完全な reference library ではなく、コンパクトな運用手順書として捉えるのが適切です。

breeze-automation skill の使い方

breeze-automation のインストールとセットアップ前提

対応する skills 環境に skill をインストールします。例:

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

次に、client configuration に Rube MCP を server として追加します。

https://rube.app/mcp

エージェントに Breeze data の変更を依頼する前に、RUBE_SEARCH_TOOLS が利用可能であることを確認してください。続いて、toolkit breeze を指定して RUBE_MANAGE_CONNECTIONS を使います。connection が ACTIVE でない場合は、返された authorization flow を完了し、続行前に status を再確認します。

skill に渡すべき入力

「update Breeze tasks」のような曖昧な prompt では不十分です。breeze-automation を有効に使うには、エージェントが適切な tools を探索し、曖昧な編集を避けられるだけの文脈を渡す必要があります。

• Breeze object type: 分かる場合は project、task、comment、person、status、milestone
• 対象 records または filters: project name、task title、assignee、due date、status、tag
• 実行したい action: search、create、update、assign、comment、summarize、verify
• 安全ルール: 一括編集前に確認する、候補を preview する、確認なしに tasks を close しない
• 出力形式: 簡潔な summary、変更 records の table、または follow-up questions

prompt 例:

“Use breeze-automation to find all open Breeze tasks in the Website Redesign project assigned to Maya and due before Friday. First discover the current Breeze tools with RUBE_SEARCH_TOOLS, confirm the Breeze connection is active, show me the matching tasks, and ask for approval before changing dates or statuses.”

安定した結果を得るための実用ワークフロー

信頼性の高い breeze-automation の使い方は、次の順序に沿います。

1. “find and update Breeze tasks by project and due date” のように、具体的な use case で tools を検索する。
2. connection の確認や関連 actions の実行時に、返された session ID を再利用する。
3. Breeze toolkit connection が ACTIVE であることを確認する。
4. required fields や expected IDs を含め、探索で得られた tool schema を正確に使う。
5. 破壊的な変更や広範囲の変更では、まず records を preview し、確認を求める。
6. 実行後に follow-up の read/search call で結果を検証する。

このパターンは単発の直接 command より時間がかかりますが、call の失敗や意図しない編集を減らせます。

最初に読むべき repository files

まず composio-skills/breeze-automation/SKILL.md を確認してください。提供されている tree には rules/、resources/、references/、scripts/ のような support folders は見当たらないため、この skill の挙動はその 1 ファイルに集約されています。特に prerequisites、setup、tool discovery、core workflow の各セクションに注意して読むとよいでしょう。

breeze-automation skill FAQ

Rube MCP なしで breeze-automation は使えますか？

いいえ。breeze-automation skill は Rube MCP tools、特に RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS に依存しています。client が MCP servers に接続できない、または Rube tools を呼び出せない場合、この skill で実用的な automation は行えません。

通常の Breeze prompt と比べて何が優れていますか？

通常の prompt では、model が API fields を作り出したり、古い tool names を前提にしたりする可能性があります。breeze-automation はエージェントに discovery step を必須化するため、実行前に現在の Composio Breeze tool schemas を取得する動きが期待できます。tool definitions の最新性が正確性に直結する live Workflow Automation では、この点が重要です。

初心者にも向いていますか？

はい。ただし、初心者でも MCP 対応 client を用意でき、Breeze connection flow を完了できることが前提です。skill 自体は短く、運用に必要な指示に絞られています。主な学習ポイントは Breeze そのものではなく、エージェントがいきなり実行せず、tools を探索し、認証を確認し、結果を検証する必要があるという考え方です。

この skill を使わないほうがよい場面は？

breeze-automation は、オフラインの計画作成、一般的なプロジェクト管理アドバイス、live connection を認可できない Breeze workflows には向きません。また、大規模な一括更新に使う場合も、prompt で preview、確認、変更後の検証を必須にしていないなら避けるべきです。

breeze-automation skill を改善する方法

Breeze 固有の制約で prompts を改善する

breeze-automation の結果を改善する最短の方法は、曖昧な目標を具体的な運用制約に置き換えることです。project name、task filters、変更したい fields、触れてはいけない対象を含めてください。たとえば “move overdue tasks” はリスクがあります。一方で “list overdue open tasks in Project X, grouped by assignee, and ask before changing due dates” なら、はるかに安全です。

よくある失敗パターンを防ぐ

よくある問題には、Breeze authentication の未完了、tool discovery の省略、record matches の曖昧さ、確認なしの広範囲編集があります。prompt の中で直接対策してください。たとえば、 “Call RUBE_SEARCH_TOOLS first,” “confirm the Breeze connection is active,” “show matching records before updates,” “verify the final state after execution.” のように明示します。

最初の出力後に絞り込む

複雑な task では、初回実行を discovery として扱います。変更を加える前に、利用可能な Breeze tools、required fields、提案される execution plan を返すようエージェントに依頼してください。最初の結果を見たあとで、assignee、status、date range、project ID などの filters を調整します。これにより意図しない操作を減らし、Rube から返された正確な schema をエージェントが使いやすくなります。

チーム利用向けに skill file を改善する

breeze-automation の local copy を管理している場合は、SKILL.md にチーム固有の examples を追加します。承認済みの project naming conventions、安全な bulk-edit rules、必須の confirmation steps、標準の output formats などです。ただし、core rule は維持してください。つまり、最初に tools を検索し、現在の schema を使い、Breeze connection を確認し、実行し、検証する、という流れです。