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 marketplace 安装 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 验证当前状态

输出结果 Sidecar

作为最后一步，将内容写入 ~/.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"。