用途:在用户修改 Miro 看板上的“Future Architecture”框架后,读取 Current Architecture 与 Future Architecture 两个框架,对比成对的 Mermaid 图,把差异翻译为代码改动(当足够具体时),并打开 PR,其描述将每个差异映射为代码改动或明确的 TODO。PR 描述是主要产物;差异含糊时,PR 携带结构化实现计划而非猜测代码。用户需提供 Miro 看板 URL,并应已编辑 Future Architecture 框架;否则会检测到空差异并报告。
主要能力:用 board_list_items 或 context_get 定位两个框架并记录 ID;列出各框架子项,按文档首个 H1 配对文档与紧随其后的图;用 doc_get 读取标题、diagram_get_dsl 获取 Mermaid DSL;对每个 H1 计算差异(修改/新增/删除),修改项优先做结构差异(节点增删改名、边增删改向、子图变化),解析失败时回退文本差异并提示;将差异翻译为代码改动,含糊项不猜测,记为 TODO。
使用方式:创建分支 wotc/architecture-<short-hash>(FUTURE_FRAME_ID 前 7 位),提交信息形如 WotC: implement architectural changes from <BOARD_URL>;无改动时用 git commit --allow-empty;推送后经 GitHub MCP 打开 PR,本地无 MCP 时回退 gh pr create;PR 描述按模板列出看板、Future 框架链接、摘要、各节差异、代码改动、待办与验证清单;无可实现差异时标注 architecture-plan 并说明无代码改动。可重复运行,分支已存在则就地更新并 --force-with-lease 强推,PR 描述从头重写。
适用场景:把 Miro 架构图差异低成本地转为代码与 PR 计划。
限制:不验证架构好坏,不替代设计评审;不主动改测试,测试破坏记为 TODO;看板状态异常(标题差异过大、Future 无标题、图无法配对)时在 §3 后停止并报告,不打开 PR。