用途:该技能用于指导以 Python 文件形式编写 marimo notebook,marimo 用 Python 而非 JSON 创建 notebook,需要注意正确的文件结构与格式。
主要能力:给出 notebook 的标准结构(PEP 723 脚本依赖块、import marimo、app = marimo.App 与 @app.cell 装饰器定义单元格,函数输入输出即单元格输入输出),marimo 自动处理单元格依赖。说明脚本模式检测(mo.app_meta().mode == "script")、状态与响应式(单元格间变量即定义响应式,避免跨单元格修改对象,谨慎使用 mo.state())、单元格输出渲染(仅渲染最后一个表达式)、PEP 723 依赖声明、marimo check 检查、pytest 测试发现与本地查询 API 文档的方法。
使用方式:以 uv run <notebook.py> 作为脚本非交互运行,uv run marimo run <notebook.py> 在浏览器交互运行,uv run marimo edit <notebook.py> 交互编辑,uvx marimo check <notebook.py> 做检查,pytest <notebook.py> 运行测试,必要时通过 uv --with marimo run python -c "import marimo as mo; help(mo.ui.form)" 查询文档。
适用场景:需要按 marimo 规范创建或维护 notebook、在 CLI 与交互模式间切换、增加测试或做静态检查时参考。
限制:具体细节需结合 STATE.md、PYTEST.md、SQL.md、UI.md、TOP-LEVEL-IMPORTS.md、EXPORTS.md、DEPLOYMENT.md、ANYWIDGET.md、WATCHING.md、EXPENSIVE.md、CONFIGURATION.md、REACTIVITY.md 等补充文档;官方站点与安装来源信息暂未提供。