用途:帮助 marimo 团队成员回顾一次配对会话,找出摩擦点并转化为改进方向。目标始终是 marimo-pair 技能(github://marimo-team/marimo-pair)或底层笔记本元编程 API marimo._code_mode 之一或两者。这是对话式流程,不是自动报告:由技能呈现发现,用户决定哪些重要,再共同决定如何处理。
主要能力与流程:
- 会话分析:回顾当前对话,识别用户挫败(纠正、重复尝试、回退、困惑、语气变化)、低效(一步任务多轮往返、过度设计、错误 API 用法)、错误(编译检查失败、运行时错误、静默失败、错误输出)、变通做法、上下文丢失。以编号列表呈现摩擦点,注明发生了什么、出现位置、初步分类,并询问用户想深入哪些。
- 根因讨论:针对选定摩擦点,从技能结构、技能缺口、误导性文档、API 易用性、缺失 API、API bug、上下文窗口等视角逐一讨论,与用户收敛到最可能的根因。
- 诊断与记录:产出诊断、促成因素、注意事项(权衡与开放问题),默认下一步是记录为 issue 或 discussion,而非立即贡献代码。
- 提交或跟进:默认撰写 issue/discussion 供团队分诊,由用户自行提交,不自动提交。仅当用户明确要求时才起草改动:读取目标文件、展示 diff、获得明确同意后再应用,并确认 SKILL.md 保持在 500 行以内(reference/ 文件无限制)。
限制与护栏:未经用户明确批准,绝不编辑 github://marimo-team/marimo-pair 中的文件;必须从会话分析开始,不得直接跳到解决方案;先呈现摩擦点再谈根因;若用户带具体抱怨调用,聚焦该处但仍扫描其他摩擦。
关键文件:SKILL.md(主技能说明)、reference/execute-code.md(草稿本与单元格操作配方)、reference/rich-representations.md(组件与显示模式)、scripts/(捆绑的发现与执行脚本)。可在笔记本草稿本中运行 import marimo._code_mode as cm 并配合 async with cm.get_context() as ctx 查看公开方法与帮助。