ComposioHQ/Shortcut-Automation

Shortcut Automation

Claude Code から直接 Shortcut のプロジェクト管理操作を自動化します。ストーリーの作成・一覧表示、タスクやコメントの追加、複数ストーリーの一括作成、ワークフローの操作を、ターミナルから離れることなく行えます。

ツールキットドキュメント: composio.dev/toolkits/shortcut

---

セットアップ

1. Rube MCP サーバーを Claude Code の設定に追加します（URL: https://rube.app/mcp）
2. プロンプトに従い、提供された接続リンクを通じて Shortcut アカウントを認証します
3. 自然言語でプロジェクト管理ワークフローの自動化を開始します

---

コアワークフロー

1. ストーリーの作成

新しいストーリーをフル構成で Shortcut ワークスペースに追加します。

ツール: SHORTCUT_CREATE_STORY

「ダークモード対応」という機能ストーリーを作成し、ワークフロー状態 500000001、見積もり 5、ラベル「frontend」を設定

SHORTCUT_CREATE_STORY の主要パラメーター:

• name（必須） -- ストーリーのタイトル
• workflow_state_id -- ストーリーを配置するワークフロー状態（project_id よりも推奨）
• story_type -- "feature"、"bug"、"chore" のいずれか
• description -- ストーリーの本文・説明
• estimate -- 数値によるポイント見積もり（未見積もりの場合は null）
• epic_id -- エピックとの関連付け
• iteration_id -- イテレーションとの関連付け
• labels -- name（とオプションで color、description）を持つラベルオブジェクトの配列
• owner_ids -- 担当者として割り当てるメンバー UUID の配列
• deadline -- ISO 8601 形式の期限日
• tasks -- description とオプションの complete、owner_ids を持つインラインタスク配列
• comments -- text を持つインラインコメント配列
• story_links -- verb（"blocks"、"duplicates"、"relates to"）を使ってストーリーをリンク

重要: workflow_state_id と project_id はどちらか一方のみ必須であり、両方は指定できません。Shortcut では Projects が廃止予定のため、workflow_state_id を推奨します。

2. 複数ストーリーの一括作成

1 回の API 呼び出しで複数のストーリーを作成します。

ツール: SHORTCUT_CREATE_MULTIPLE_STORIES

3 つのバグストーリーを作成：「ログインページ 500 エラー」「カート合計の丸め問題」「検索結果の空状態が壊れている」

• stories 配列が必要で、各要素は SHORTCUT_CREATE_STORY と同じスキーマに従います
• 配列内の各ストーリーには name が必要です
• 一括インポート、スプリント計画、テンプレートベースのストーリー作成に効率的

3. プロジェクト内のストーリー一覧表示

特定のプロジェクト内のすべてのストーリーを取得します。

ツール: SHORTCUT_LIST_STORIES

プロジェクト 42 のすべてのストーリーを説明付きで一覧表示

• project__public__id（整数のプロジェクト ID）が必要
• オプションの includes_description: true でレスポンスにストーリーの説明を含める
• すべてのストーリーを属性（ステータス、タイプ、見積もりなど）とともに返します

4. ストーリータスクの管理

ストーリー内にタスク（チェックリスト）を作成してサブ作業を追跡します。

ツール: SHORTCUT_CREATE_TASK

ストーリー 12345 にタスク「ダークモードトグルの単体テストを書く」を追加

主要パラメーター:

• story__public__id（必須） -- 親ストーリーの ID
• description（必須） -- タスクの説明
• complete -- ブール値、デフォルトは false
• owner_ids -- タスクを割り当てるメンバー UUID の配列
• external_id -- 外部ツールからインポートされた場合の ID

5. ストーリーコメントの追加

ストーリーにコメントを投稿して議論やドキュメント化を行います。

ツール: SHORTCUT_CREATE_STORY_COMMENT

ストーリー 12345 にコメントを追加：「実装をレビューしました -- 問題ないですが、アクセシビリティテストが必要です」

主要パラメーター:

• story__public__id（必須） -- ストーリー ID
• text（必須） -- コメント本文
• author_id -- メンバー UUID（デフォルトは API トークン所有者）
• parent_id -- スレッド応答のための親コメントの ID

6. ワークフローとプロジェクトの探索

ワークフローとプロジェクトを一覧表示して、ストーリー作成に必要な ID を解決します。

ツール: SHORTCUT_LIST_WORKFLOWS、SHORTCUT_LIST_PROJECTS

Shortcut ワークスペース内のすべてのワークフローを表示して、適切なワークフロー状態 ID を見つける

• SHORTCUT_LIST_WORKFLOWS はすべてのワークフローをその状態（ID、名前、タイプ）とともに返します
• SHORTCUT_LIST_PROJECTS はすべてのプロジェクトをその属性とともに返します
• ストーリーを作成する前に、これらのツールを使用して有効な workflow_state_id と project_id の値を発見します

---

既知の落とし穴

• workflow_state_id と project_id の選択: SHORTCUT_CREATE_STORY はこれらのうち正確に 1 つが必要です。両方を指定するか、どちらも指定しないと拒否されます。Projects は廃止予定のため、workflow_state_id を優先してください。
• Projects は廃止予定: Shortcut は Projects を廃止し、ワークフローベースの組織に移行しています。新しいストーリーには workflow_state_id を使用してください。
• ラベルのインライン作成: labels 配列内のラベルは、存在しない場合にその場で作成されます。各ラベルオブジェクトには name フィールドが必要です。
• ストーリータイプのデフォルト: story_type を省略すると、デフォルトで "feature" になります。バグや chore の場合は明示的に設定してください。
• 一括作成の制限: SHORTCUT_CREATE_MULTIPLE_STORIES はすべてのストーリーを 1 回のリクエストで処理します。非常に大きなバッチはタイムアウトする可能性があるため、バッチは 25 ストーリー未満に抑えてください。
• ストーリーとプロジェクトの整数 ID: ストーリーとプロジェクトの ID は整数であり、UUID ではありません。メンバーとグループの ID は UUID です。これらの形式を混在させるとエラーが発生します。
• move_to の位置指定: move_to フィールド（"first" または "last"）は、ストーリーをワークフロー状態内で移動しますが、状態をまたぐ移動は行いません。

---

クイックリファレンス

ツールスラッグ	説明
SHORTCUT_CREATE_STORY	単一のストーリーを作成（name + workflow_state_id または project_id が必要）
SHORTCUT_CREATE_MULTIPLE_STORIES	複数のストーリーを一括作成（stories 配列が必要）
SHORTCUT_LIST_STORIES	プロジェクト内のストーリーを一覧表示（project__public__id が必要）
SHORTCUT_CREATE_TASK	ストーリー内にタスクを作成（story__public__id、description が必要）
SHORTCUT_CREATE_STORY_COMMENT	ストーリーにコメントを追加（story__public__id、text が必要）
SHORTCUT_CREATE_STORY_FROM_TEMPLATE	テンプレートからストーリーを作成
SHORTCUT_LIST_WORKFLOWS	すべてのワークフローとその状態を一覧表示
SHORTCUT_LIST_PROJECTS	すべてのプロジェクトを一覧表示

---

Powered by Composio