miro-skill

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

<objective> Create and manage visual collaboration boards in Miro for strategy canvases, architecture diagrams, sprint boards, and competitive analysis. Uses Miro MCP server for programmatic board creation with sticky notes, shapes, connectors, and frames. </objective>

<quick_start>

Add Miro MCP server:

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

Authenticate:
```
/mcp auth
```
Create a board with
```
create_board
```
and populate using workflows below
Use color conventions (yellow=ideas, blue=tech, green=data, red=critical) </quick_start>

<success_criteria>

Miro MCP server authenticated and responding to
```
get_boards
```
calls
Board created with appropriate title and frame structure
Items positioned using grid spacing (250px) without overlap
Color conventions applied consistently across sticky notes and shapes
Board visually communicates the intended strategy, architecture, or sprint plan </success_criteria>

<objective> 在Miro中创建和管理用于战略画布、架构图、冲刺看板及竞品分析的可视化协作看板。通过Miro MCP服务器以编程方式创建看板，可添加便签、形状、连接线和框架。 </objective>

<quick_start>

添加Miro MCP服务器：

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

认证：
```
/mcp auth
```
使用
```
create_board
```
创建看板，然后通过下方工作流填充内容
遵循颜色规范（黄色=想法，蓝色=技术，绿色=数据，红色=关键事项） </quick_start>

<success_criteria>

Miro MCP服务器已完成认证，且能响应
```
get_boards
```
调用
看板已创建，具备合适的标题和框架结构
元素按照网格间距（250px）布局，无重叠
便签和形状统一遵循颜色规范
看板可直观传达预期的战略、架构或冲刺计划 </success_criteria>

Miro Board Interaction

Miro 看板交互

Visual collaboration boards for strategy, architecture, and sprint planning via Miro MCP + AI plugin.

通过Miro MCP + AI插件实现战略、架构和冲刺规划的可视化协作看板。

Setup

配置

MCP Server (Required)

MCP服务器（必填）

bash

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

Then authenticate:

/mcp auth

bash

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

然后进行认证：

/mcp auth

AI Plugin (Optional Enhancement)

AI插件（可选增强）

Install

miroapp/miro-ai

from Miro marketplace for:

Browse board contents
Create diagrams from text
Generate docs from boards
Build tables from data
Summarize board sections

从Miro应用市场安装

miroapp/miro-ai

以获得以下功能：

浏览看板内容
从文本生成图表
从看板生成文档
从数据生成表格
汇总看板章节内容

Quick Start

快速入门

Authenticate with Miro MCP
Create or select a board
Use workflows below to populate it

通过Miro MCP完成认证
创建或选择一个看板
使用下方工作流填充内容

Board Workflows

看板工作流

Strategy Board → Tech Spec

战略看板 → 技术规格

When: GTM planning, product strategy, competitive analysis

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 tools used:

create_board

create_sticky_note

create_shape

create_connector

适用场景： 上市规划、产品战略、竞品分析

1. 创建标题为“Strategy: [Topic]”的看板
2. 添加商业模式画布框架（3x3网格）
3. 按板块添加便签：
   - 价值主张（黄色）
   - 客户细分（蓝色）
   - 渠道通路（绿色）
   - 收入来源（橙色）
4. 在右侧添加技术影响列
5. 用箭头连接战略项与技术需求

使用的Miro工具：

create_board

create_sticky_note

create_shape

create_connector

Architecture → Code Scaffold

架构图 → 代码脚手架

When: System design, service architecture, data flow

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 tools used:

create_shape

create_connector

create_text

create_frame

适用场景： 系统设计、服务架构、数据流

1. 创建标题为“Architecture: [System]”的看板
2. 添加组件形状：
   - 服务（矩形，蓝色）
   - 数据库（圆柱体，绿色）
   - 外部API（云朵形，灰色）
   - 队列（平行四边形，橙色）
3. 用带标签的箭头连接（同步/异步、协议）
4. 为每个组件添加说明（技术栈、扩缩容备注）
5. 导出为规格文档用于开发实现

使用的Miro工具：

create_shape

create_connector

create_text

create_frame

Sprint Board → Tasks

冲刺看板 → 任务管理

When: Sprint planning, task breakdown, capacity planning

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 tools used:

create_frame

create_card

create_sticky_note

create_tag

适用场景： 冲刺规划、任务拆分、容量规划

1. 创建标题为“Sprint: [Name] — [Start] to [End]”的看板
2. 添加列：待办 | 进行中 | 评审 | 已完成
3. 为每个任务创建卡片：
   - 标题（加粗）
   - 故事点（标签）
   - 经办人（头像）
   - 优先级（颜色：红色=P0，橙色=P1，黄色=P2）
4. 添加按团队/工作流划分的泳道
5. 在顶部添加容量条（承诺点数 vs 可用点数）

使用的Miro工具：

create_frame

create_card

create_sticky_note

create_tag

Competitive Analysis → GTM Playbook

竞品分析 → 上市手册

When: Market positioning, competitor mapping, pricing strategy

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 tools used:

create_shape

create_sticky_note

create_connector

create_text

适用场景： 市场定位、竞品映射、定价策略

1. 创建标题为“Competitive: [Market]”的看板
2. 添加2x2矩阵（价值 vs 价格轴）
3. 用便签标注竞品的定位
4. 添加我方产品并标注差异化卖点
5. 用虚线圆圈画出机会缺口
6. 为每个缺口添加行动项

使用的Miro工具：

create_shape

create_sticky_note

create_connector

create_text

MCP Tools Reference

MCP工具参考

Tool	Use For	Example
`create_board`	New board	Strategy canvas, sprint board
`get_boards`	List boards	Find existing board to update
`create_sticky_note`	Ideas, tasks	Brainstorm items, sprint tasks
`create_shape`	Components	Architecture boxes, matrix axes
`create_connector`	Relationships	Data flow, dependencies
`create_frame`	Grouping	Columns, sections, swimlanes
`create_card`	Rich items	Tasks with assignee, due date
`create_text`	Labels	Titles, annotations
`create_tag`	Categories	Priority, status, team
`get_items`	Read board	Parse existing board content
`update_item`	Modify	Change position, color, text
`delete_item`	Remove	Clean up board items

工具	用途	示例
`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`	删除元素	清理看板项

Color Conventions

颜色规范

Color	Meaning
Yellow	Ideas, brainstorm, general
Blue	Technical, engineering
Green	Data, databases, success
Orange	Warning, queues, P1
Red	Critical, blockers, P0
Gray	External, third-party
Purple	Design, UX, creative

颜色	含义
黄色	想法、头脑风暴、通用内容
蓝色	技术、工程相关
绿色	数据、数据库、成功事项
橙色	警告、队列、P1优先级
红色	关键、阻塞项、P0优先级
灰色	外部、第三方相关
紫色	设计、UX、创意内容

Positioning Guide

布局指南

Miro uses x,y coordinates (pixels from top-left):

Standard sticky note: 200x200px
Standard shape: 300x200px
Grid spacing: ~250px horizontal, ~250px vertical
Frame padding: 50px inside edges

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...

Miro使用x,y坐标（从左上角开始的像素值）：

标准便签：200x200px
标准形状：300x200px
网格间距：水平约250px，垂直约250px
框架内边距：边缘内50px

布局示例（3列看板）：
第1列：x=0，元素位置y=0, 250, 500...
第2列：x=350，元素位置y=0, 250, 500...
第3列：x=700，元素位置y=0, 250, 500...

Integration Points

集成点

business-model-canvas-skill → Export canvas to Miro board
blue-ocean-strategy-skill → Strategy Canvas visualization
gtm-pricing-skill → Pricing matrix on Miro
research-skill → Competitive landscape board
workflow-orchestrator-skill → Sprint boards from End Day metrics

business-model-canvas-skill → 将画布导出至Miro看板
blue-ocean-strategy-skill → 战略画布可视化
gtm-pricing-skill → 在Miro中生成定价矩阵
research-skill → 生成竞品格局看板
workflow-orchestrator-skill → 根据每日结束指标生成冲刺看板

Common Mistakes

常见问题

Mistake	Fix
Board too cluttered	Use frames to group, limit items per section
No authentication	Run `/mcp auth` after adding MCP server
Items overlapping	Use positioning guide grid spacing
Lost board URL	Use `get_boards` to list all boards
Stale board	Use `get_items` to verify current state before updates

问题	解决方法
看板过于杂乱	使用框架分组，限制每个板块的元素数量
未完成认证	添加MCP服务器后运行 `/mcp auth`
元素重叠	遵循布局指南的网格间距
丢失看板URL	使用 `get_boards` 列出所有看板
看板内容过时	更新前使用 `get_items` 验证当前状态