Shortcut Automation

Shortcut Automation skill の概要

Shortcut Automation でできること

Shortcut Automation skill は、Rube MCP server を使いながら、自然言語で Shortcut のプロジェクト作業を管理するための Claude Code skill です。開発環境から離れずに、ストーリーの作成、作業項目の一括作成、タスクやコメントの追加、既存ストーリーの一覧化、Shortcut の workflow state の操作を行いやすくします。

プロジェクト管理チームに向いているケース

この Shortcut Automation skill は、すでに Shortcut を使っていて、Claude Code からプロジェクト管理作業をより速く進めたいエンジニア、テックリード、プロダクトマネージャー、デリバリーチームに向いています。計画メモ、バグ報告、スプリント目標、実装方針などを、見積もり、ラベル、epic、iteration、workflow state を含む構造化された Shortcut stories に変換したい場合に特に役立ちます。

一般的なプロンプトとの違い

一般的なプロンプトでもチケット文面の下書きは作れますが、Shortcut 内で確実に操作できるわけではありません。この skill は、SHORTCUT_CREATE_STORY のような Shortcut 固有のアクションを前提に設計されており、workflow_state_id、story_type、estimate、epic_id、iteration_id、labels などのパラメータを扱います。主な価値は、単に読みやすいチケットを書くことではなく、認証済みの MCP 接続を通じて、自然言語を実行可能な Shortcut 操作に変換できる点にあります。

Shortcut Automation skill の使い方

Shortcut Automation のインストールと設定の前提

Shortcut Automation を使うには、たとえば次のように Claude skills 環境へ skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill "Shortcut Automation"

次に、必要な MCP 依存関係を設定します。この skill には Rube MCP server が必要なため、Claude Code の MCP 設定に https://rube.app/mcp を追加し、求められたら Shortcut アカウントで認証します。認証が完了していない場合、Claude は依頼内容を理解できても、Shortcut データの作成や取得の段階で失敗することがあります。

確実に操作するために必要な入力

Shortcut Automation は、曖昧なゴールだけでなく、Shortcut の構造化された情報を渡すほど安定して動作します。ストーリーを作成する場合は、可能であれば title、story type、workflow state、description、estimate、labels、epic、iteration を含めてください。上流の skill では project_id より workflow_state_id の利用が推奨されているため、本番の作業項目を Claude に作成させる前に、ワークスペースで使っている ID を確認しておくと安全です。

弱いプロンプト:

Create tickets for the onboarding work.

よりよいプロンプト:

Use Shortcut Automation to create three feature stories for onboarding. Put them in workflow_state_id 500000001, estimate each at 3 points, label them "onboarding" and "frontend", and attach them to epic_id 12345. Include acceptance criteria for each story.

初回利用におすすめの進め方

いきなり大量のレコードを作成するのではなく、まずは読み取り専用または低リスクの操作から始めます。MCP 設定が対応している場合は、Claude に既存の Shortcut stories を一覧表示または確認させ、その後、明確な title と label を持つテスト用ストーリーを 1 件だけ作成します。出力が意図した workflow state に入ることを確認してから、一括作成に進むのが安全です。大きめの計画セッションでは、まず Claude に提案する stories を markdown で下書きさせ、名前や見積もりをレビューしてから、Shortcut に作成するよう指示します。

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

この skill はコンパクトです。重要なファイルは composio-skills/shortcut-automation/SKILL.md です。まず Setup セクションで Rube MCP の要件を確認し、次に Core Workflows セクションで対応している Shortcut 操作とプロンプト例を確認してください。現在の skill フォルダには追加の rules/、resources/、references/、scripts はないため、実装上の期待値の多くは SKILL.md と、そこからリンクされている Composio Shortcut toolkit documentation に直接基づきます。

Shortcut Automation skill FAQ

Shortcut Automation はプロジェクト管理用ですか、それともコーディング用ですか？

Shortcut Automation for Project Management が主な用途です。この skill 自体がアプリケーションコードを書いたり、リポジトリを管理したりするわけではありません。計画やデリバリー上の判断を、Shortcut の records、comments、tasks、estimates、labels、workflow の移動、その他のプロジェクト追跡アクションへ変換するために使います。

Shortcut の管理者権限は必要ですか？

依頼する操作を実行できる権限を持つ Shortcut アカウントが必要です。stories の作成、comments の追加、workflow 上の配置変更ができるかどうかは、Shortcut ワークスペースの権限と、認証済みの Rube MCP 接続に依存します。Claude が操作を完了できない場合は、アカウントのアクセス権、MCP 認証、指定した ID がワークスペース内に存在するかを確認してください。

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

大規模な backlog 変更、機密性の高い roadmap 変更、本番運用中の Shortcut ワークスペースに影響し得る bulk updates について、唯一のレビュー手段として使うのは避けてください。影響の大きい操作では、まず Claude に計画を下書きさせ、story list を手動で確認し、そのうえで小さな単位に分けて作成または更新するのが安全です。

手作業で Shortcut チケットを書くより何がよいですか？

単発の作業であれば、手作業のチケット入力の方が安全なこともあります。ただし、繰り返しの計画作業では時間がかかります。Shortcut Automation は、関連する stories が多数ある場合、ラベル付けのルールが一貫している場合、繰り返し使う workflow states がある場合、会議メモをすばやく構造化された Shortcut work items にしたい場合に特に有効です。

Shortcut Automation skill を改善する方法

文脈を増やして Shortcut Automation の出力を改善する

Shortcut Automation の出力を最も早く改善する方法は、チームのワークスペース運用ルールを渡すことです。有効な workflow state IDs、label names、epic IDs、iteration IDs、estimate scale、story-type rules、チームらしい良い story の例を含めてください。Claude はフォーマットを推測できますが、本番作業の ID や担当ルールを推測させるべきではありません。

よくある失敗を防ぐ

よくある問題には、workflow state IDs の不足、story types の曖昧さ、重複チケット、誤った labels、範囲が広すぎる batch creation があります。実行前に、Claude に予定している Shortcut 変更を要約させることでリスクを下げられます。例: Before creating anything, show a table with title, type, estimate, labels, epic_id, iteration_id, and workflow_state_id.

最初の出力後に調整する

Claude が stories を下書きまたは作成したら、acceptance criteria、dependencies、scope boundaries を確認します。次のようなフォローアッププロンプトを使えます: Split any story larger than 5 points、Add QA tasks to each bug、Rewrite descriptions using Given/When/Then acceptance criteria、Move backend-only items to the backend label。1 回のプロンプトで完璧なチケットを求めるより、こうした反復の方がプロジェクトの明確さを高めやすくなります。

チームのワークフローに合わせて skill を拡張する

チームが Shortcut を深く使っている場合は、命名規則、default labels、estimation rules、安全な batch limits についてローカルのガイダンスを追加することを検討してください。チーム固有の軽量な wrapper prompt を用意し、どの workflow states が安全か、どの epics が稼働中か、既存作業を変更する前にいつ確認を求めるべきかを Claude に伝えることで、Shortcut Automation guide の信頼性を高められます。