miro

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Miro Skill

Miro Skill

Overview

概述

Enables Claude to use Miro for visual collaboration including creating and editing boards, adding shapes and content, managing templates, and organizing brainstorming or planning sessions.
让Claude能够使用Miro进行可视化协作,包括创建和编辑白板、添加形状与内容、管理模板,以及组织头脑风暴或规划会议。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/miro/install.sh | bash
Or manually:
bash
cp -r skills/miro ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/miro/install.sh | bash
或手动安装:
bash
cp -r skills/miro ~/.canifi/skills/

Setup

配置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置:
bash
undefined

First, ensure canifi-env is installed:

首先,确保已安装canifi-env:

canifi-env set MIRO_EMAIL "your-email@example.com" canifi-env set MIRO_PASSWORD "your-password"
undefined
canifi-env set MIRO_EMAIL "your-email@example.com" canifi-env set MIRO_PASSWORD "your-password"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭据,由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1:手动浏览器登录(推荐)

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭据:
  1. 使用CDP模式完成浏览器自动化配置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用你的已认证会话,全程不会获取你的密码

Option 2: Environment Variables

选项2:环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭据,可以将其存储在本地:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意:存储在canifi-env中的凭据仅能在你的本地机器上访问,绝不会被传输。

Capabilities

功能

  • Create and navigate Miro boards
  • Add shapes, sticky notes, and text
  • Create flowcharts and diagrams
  • Apply templates for various workflows
  • Export boards as images or PDFs
  • Manage board sharing and permissions
  • 创建和导航Miro白板
  • 添加形状、便签和文本
  • 创建流程图和图表
  • 为各类工作流应用模板
  • 将白板导出为图片或PDF
  • 管理白板共享和权限

Usage Examples

使用示例

Example 1: Create Mind Map

示例1:创建思维导图

User: "Create a mind map for our Q1 planning"
Claude: I'll create a mind map board for Q1 planning.
1. Opening Miro via Playwright MCP
2. Creating new board with mind map template
3. Adding central topic "Q1 Planning"
4. Creating branches for key initiatives
5. Sharing board link with you
用户:“为我们的Q1规划创建一份思维导图”
Claude:我将为Q1规划创建一个思维导图白板。
1. 通过Playwright MCP打开Miro
2. 使用思维导图模板创建新白板
3. 添加中心主题“Q1规划”
4. 为关键举措创建分支
5. 与你共享白板链接

Example 2: Export Board

示例2:导出白板

User: "Export the product roadmap board as PDF"
Claude: I'll export your roadmap board.
1. Navigating to the product roadmap board
2. Opening export options
3. Selecting PDF format with high quality
4. Downloading the exported file
用户:“将产品路线图白板导出为PDF”
Claude:我将导出你的路线图白板。
1. 导航至产品路线图白板
2. 打开导出选项
3. 选择高质量PDF格式
4. 下载导出文件

Example 3: Add Flowchart

示例3:添加流程图

User: "Add a user flow diagram to my UX board"
Claude: I'll add a user flow to your board.
1. Opening the UX board in Miro
2. Adding flowchart shapes
3. Creating connections between steps
4. Labeling each flow step
5. Organizing layout for clarity
用户:“在我的UX白板中添加一个用户流程图”
Claude:我将在你的白板中添加用户流程图。
1. 在Miro中打开UX白板
2. 添加流程图形状
3. 创建步骤间的连接
4. 为每个流程步骤添加标签
5. 整理布局以提升清晰度

Authentication Flow

认证流程

  1. Navigate to miro.com via Playwright MCP
  2. Click "Log in" and enter email
  3. Enter password
  4. Handle SSO if configured
  5. Complete 2FA if required (via iMessage)
  6. Maintain session for board operations
  1. 通过Playwright MCP导航至miro.com
  2. 点击“登录”并输入邮箱
  3. 输入密码
  4. 若已配置,处理SSO单点登录
  5. 若需要,完成双因素认证(通过iMessage)
  6. 维持会话以进行白板操作

Error Handling

错误处理

  • Login Failed: Retry up to 3 times, notify via iMessage
  • Session Expired: Re-authenticate automatically
  • Rate Limited: Implement exponential backoff
  • 2FA Required: Send iMessage for verification code
  • Board Not Found: Search boards or prompt for correct name
  • Permission Denied: Notify about access restrictions
  • 登录失败:最多重试3次,通过iMessage通知
  • 会话过期:自动重新认证
  • 速率限制:实现指数退避策略
  • 需要双因素认证:发送iMessage请求验证码
  • 白板未找到:搜索白板或提示输入正确名称
  • 权限不足:通知访问限制

Self-Improvement Instructions

自我改进说明

When Miro updates its interface:
  1. Document new tools and template locations
  2. Update board navigation patterns
  3. Test shape creation and editing workflows
  4. Log any selector or UI changes
当Miro更新界面时:
  1. 记录新工具和模板的位置
  2. 更新白板导航模式
  3. 测试形状创建和编辑工作流
  4. 记录任何选择器或UI变更

Notes

注意事项

  • Large boards may have performance impacts
  • Real-time collaboration shows other users
  • Some templates require paid plans
  • Export quality varies by format choice
  • Embedded content may not export fully
  • 大型白板可能会影响性能
  • 实时协作会显示其他用户
  • 部分模板需要付费计划
  • 导出质量因格式选择而异
  • 嵌入内容可能无法完全导出