miro-skill

戦略キャンバス、アーキテクチャ図、スプリントボード、競合分析のために、Miro でビジュアルコラボレーションボードを作成および管理します。Miro MCP サーバーを使用して、付箋、図形、コネクタ、フレームを備えたボードをプログラムで作成します。

<quick_start>

1. Miro MCP サーバーを追加します: claude mcp add --transport http miro https://mcp.miro.com
2. 認証します: /mcp auth
3. create_board でボードを作成し、以下のワークフローを使用して内容を追加します
4. 色の規約を使用します（黄=アイデア、青=技術、緑=データ、赤=重大） </quick_start>

<success_criteria>

• Miro MCP サーバーが認証済みで、get_boards 呼び出しに応答する
• 適切なタイトルとフレーム構造でボードが作成されている
• アイテムが重ならないようにグリッド間隔（250px）で配置されている
• 色の規約が付箋と図形全体で一貫して適用されている
• ボードが意図した戦略、アーキテクチャ、またはスプリント計画を視覚的に伝えている </success_criteria>

Miro ボードの操作

Miro MCP + AI プラグインによる、戦略、アーキテクチャ、スプリント計画のためのビジュアルコラボレーションボード。

セットアップ

MCP サーバー（必須）

claude mcp add --transport http miro https://mcp.miro.com

次に認証します:

/mcp auth

AI プラグイン（任意の拡張機能）

Miro マーケットプレイスから miroapp/miro-ai をインストールすると、以下が可能になります:

• ボードの内容を閲覧する
• テキストから図を生成する
• ボードからドキュメントを生成する
• データから表を構築する
• ボードのセクションを要約する

クイックスタート

1. Miro MCP で認証します
2. ボードを作成または選択します
3. 以下のワークフローを使用して内容を追加します

ボードのワークフロー

戦略ボード → 技術仕様

使用場面: GTM 計画、製品戦略、競合分析

1. Create board with "Strategy: [Topic]" title
2. Add Business Model Canvas frame (3x3 grid)
3. Populate sticky notes per section:
   - Value Props (yellow)
   - Customer Segments (blue)
   - Channels (green)
   - Revenue Streams (orange)
4. Add tech implications column (right side)
5. Connect strategy items → tech requirements with arrows

使用する Miro ツール: create_board、create_sticky_note、create_shape、create_connector

アーキテクチャ → コードの雛形

使用場面: システム設計、サービスアーキテクチャ、データフロー

1. Create board "Architecture: [System]"
2. Add component shapes:
   - Services (rectangles, blue)
   - Databases (cylinders, green)
   - External APIs (clouds, gray)
   - Queues (parallelograms, orange)
3. Connect with labeled arrows (sync/async, protocol)
4. Add notes for each component (tech stack, scaling notes)
5. Export as spec for implementation

使用する Miro ツール: create_shape、create_connector、create_text、create_frame

スプリントボード → タスク

使用場面: スプリント計画、タスクの分解、キャパシティプランニング

1. Create board "Sprint: [Name] — [Start] to [End]"
2. Add columns: Backlog | In Progress | Review | Done
3. Create cards per task:
   - Title (bold)
   - Story points (tag)
   - Assignee (avatar)
   - Priority (color: red=P0, orange=P1, yellow=P2)
4. Add swimlanes per team/workstream
5. Capacity bar at top (points committed vs available)

使用する Miro ツール: create_frame、create_card、create_sticky_note、create_tag

競合分析 → GTM プレイブック

使用場面: 市場ポジショニング、競合のマッピング、価格戦略

1. Create board "Competitive: [Market]"
2. Add 2x2 matrix (Value vs Price axes)
3. Plot competitors as positioned sticky notes
4. Add our product with differentiation callouts
5. Draw opportunity gaps (dashed circles)
6. Add action items per gap

使用する Miro ツール: create_shape、create_sticky_note、create_connector、create_text

MCP ツールリファレンス

ツール	用途	例
create_board	新しいボード	戦略キャンバス、スプリントボード
get_boards	ボードの一覧表示	更新する既存ボードの検索
create_sticky_note	アイデア、タスク	ブレインストーミング項目、スプリントタスク
create_shape	コンポーネント	アーキテクチャのボックス、マトリックスの軸
create_connector	関係性	データフロー、依存関係
create_frame	グループ化	列、セクション、スイムレーン
create_card	リッチな項目	担当者や期限を含むタスク
create_text	ラベル	タイトル、注釈
create_tag	カテゴリ	優先度、ステータス、チーム
get_items	ボードの読み取り	既存のボード内容を解析する
update_item	変更	位置、色、テキストの変更
delete_item	削除	ボード上の項目を整理する

色の規約

色	意味
黄	アイデア、ブレインストーミング、一般
青	技術、エンジニアリング
緑	データ、データベース、成功
オレンジ	警告、キュー、P1
赤	重大、ブロッカー、P0
グレー	外部、サードパーティ
紫	デザイン、UX、クリエイティブ

配置ガイド

Miro は x,y 座標（左上からのピクセル）を使用します:

• 標準の付箋: 200x200px
• 標準の図形: 300x200px
• グリッド間隔: 水平 ~250px、垂直 ~250px
• フレームのパディング: 内側の端から 50px

Layout example (3-column board):
Column 1: x=0,    items at y=0, 250, 500...
Column 2: x=350,  items at y=0, 250, 500...
Column 3: x=700,  items at y=0, 250, 500...

連携ポイント

• business-model-canvas-skill → キャンバスを Miro ボードにエクスポート
• blue-ocean-strategy-skill → 戦略キャンバスの可視化
• gtm-pricing-skill → Miro 上の価格マトリックス
• research-skill → 競合環境ボード
• workflow-orchestrator-skill → End Day 指標からのスプリントボード

よくある間違い

間違い	修正方法
ボードが散らかりすぎている	フレームを使ってグループ化し、セクションごとのアイテム数を制限する
認証がない	MCP サーバーを追加した後に /mcp auth を実行する
アイテムが重なっている	配置ガイドのグリッド間隔を使用する
ボードの URL を紛失した	get_boards を使ってすべてのボードを一覧表示する
ボードが古い	更新前に get_items を使って現在の状態を確認する

結果サイドカーを書き出す

最後のステップとして、~/.claude/skill-analytics/last-outcome-miro-skill.json に書き込みます：

{"ts":"[UTC ISO8601]","skill":"miro-skill","version":"1.0.0","variant":"default",
 "status":"[success|partial|error]","runtime_ms":[estimated ms from start],
 "metrics":{"boards_created":[n],"elements_added":[n]},
 "error":null,"session_id":"[YYYY-MM-DD]"}

一部のステージが失敗しても結果が生成された場合は、ステータスに "partial" を使用します。出力がまったく生成されなかった場合にのみ "error" を使用します。