Marimo交互式笔记本开发技能Skill working-with-marimo

---

name: 使用Marimo description: 在Marimo笔记本中进行交互式开发，使用验证循环。用于创建/编辑Marimo笔记本并验证执行。

使用Marimo

遵循 计划-执行-验证 循环以确保笔记本的正确性。

反馈循环

1. 上下文与计划:

   • 会话: mcp_marimo_get_active_notebooks (查找会话ID).
   • 结构: mcp_marimo_get_lightweight_cell_map (查看单元格ID/内容).
   • 数据状态: mcp_marimo_get_tables_and_variables (检查DataFrames/变量).
   • 单元格详情: mcp_marimo_get_cell_runtime_data (代码、错误、局部变量).

2. 执行:

   • 直接编辑 .py 文件，使用 write 或 search_replace.
   • 规则: 遵循 最佳实践 (例如，@app.cell，无全局状态).

3. 验证（关键）:

   • 代码检查: mcp_marimo_lint_notebook (静态分析).
   • 运行时错误: mcp_marimo_get_notebook_errors (执行错误).
   • 输出: mcp_marimo_get_cell_outputs (视觉/控制台).

常用命令

• 启动/同步: Marimo 自动同步文件更改。
• SQL: 使用 mo.sql 进行DuckDB查询。
• 绘图: 使用 plt.gca() 或返回图形。不要使用 plt.show().

参考

参见 最佳实践 了解代码格式化、反应性规则和UI元素使用。