用途:plan-with-baz 用于在 Baz 索引搜索的帮助下,端到端规划一项功能或变更。待规划的工作来自 $ARGUMENTS,若为空则询问用户。整个过程是只读的:在用户批准计划前,不得编辑项目文件、运行变更类命令或开始实现,唯一允许的写入是计划文档本身。
主要能力:通过 Baz 的 MCP 工具探索相关仓库,包括 repo_search 查找涉及的仓库、remote_grep 按符号或正则查找代码、remote_file_search 按文件名或 glob 查找文件;已知路径的单个文件才用本地读取工具打开。所有搜索都必须走 Baz,不得用读取或 shell 工具列目录、遍历或 grep 仓库。搜索有硬性预算:repo_search 只调用一次且不换措辞;同一(仓库,路径)对搜索 3 次后须先读一个匹配文件;整轮最多 10 次搜索。为已有集合新增一个用例时,需先对已有同类项标识符做一次全仓库搜索,找出枚举、工厂或查找表、switch/match 分支、分发表、路由表和配置等所有接入点,并检查其测试。
使用方式:按固定 schema 生成计划,包含标题、Why、The change(一段不超过四句的说明加 Before/After 表格,单元格标注 (new)、(changed)、(unchanged),最多一个 (unchanged) 行)、可选的 mermaid 图(sequenceDiagram、erDiagram 或 flowchart TD,最多一个)、Affected repos、Decisions(含 Out of scope)、Open questions,以及 --- 之后的 Steps 和 Verification。计划写入会话上下文给出的计划文件路径,该路径由插件私有目录提供;若无此路径,不要自造也不要写入 /tmp,改为内联展示并说明无法暂存计划文件。写入后需内联展示同样内容,并请用户批准。
上传与链接:写入计划文件是本地操作,无需许可;上传则需询问用户并等待答复。同意后调用 mcp__baz__update_plan(须用全限定名),工具结果含可分享的计划链接,可随时运行 /baz:get-plan-comments 拉取评论。每个规划会话只询问一次,同意覆盖整个会话;若用户拒绝则不再提起。实现完成并打开 PR 后,对已上传的计划调用 mcp__baz__link_plan_to_pr,传入仓库 owner/repo 和 prNumber;每个 PR 调用一次,后续计划版本仍保持链接。
限制:未获批准前不得实现;不得把计划写入共享 /tmp;上传绝不自动进行;Cursor 上不会收到 PostToolUse 提示,需自行提出上传问题且不提供 token 计数。资料未提供具体收费、价格或平台支持范围等信息。