用途:面向 Beautiful Mermaid 实时编辑器本身的源码改动,而不是生成普通 Mermaid 图。任务若只是写 Mermaid 内容或语法问题,应改用普通文档/写作流程,不适用本技能。
前置条件:若 $ARGUMENTS 含仓库路径,以此作为起点;改前先读目标仓库的 AGENTS.md、package 脚本与当前编辑器源码。editor.ts 为唯一真实来源,不要直接改生成的 editor.html,除非目标仓库明确要求提交构建产物。
主要能力与流程:
- 定位真实改动面:找到仓库根与生成 editor.html 的 editor.ts,读构建/开发入口(package.json、dev.ts、Bun 脚本等),再定位相邻源码(src/browser.ts、src/types.ts、src/theme.ts、src/styles.ts、samples-data.ts)。
- 按任务类型加载参考:配置面板/颜色/滑块/样例预设看 references/CHANGE_PATTERNS.md;渲染管线/主题/深色模式/缩放/导出/剪贴板看 ARCHITECTURE.md;重建命令/冒烟检查/产物审查看 VERIFICATION.md;渲染器支持或新增 RenderOptions 字段看 ARCHITECTURE.md 加 CHANGE_PATTERNS.md。
- 改前追踪真实代码路径:editor.ts 中的 UI 控件或动作处理器、本地编辑器状态、buildOptions()/render 调用、SVG 后处理、主题同步、缩放或导出路径,优先扩展现有流程而非新建并行状态。
- 按既有模式实现:配置项需串联 UI、状态、readConfig() 与事件;SVG 覆盖遵循渲染后注入样式模式并在每次渲染后重跑;渲染器支持需把字段加入 RenderOptions 并贯穿主题/渲染辅助;主题保留自动与手动行为;缩放保留基于 viewBox 的宽高更新,不要改用 CSS transform: scale(...);导出与剪贴板需保持 SVG/PNG/剪贴板行为一致并检查缩放;样例应改编辑器样例来源与分类行为。
- 交接前验证:按 VERIFICATION.md 至少从源码重新生成编辑器产物、运行最小相关检查、涉及 UI/渲染/导出/主题/缩放时在浏览器冒烟测试,并确认生成的 editor.html 是否应进入最终 diff。
规则与限制:不要假设目标仓库仍符合旧架构说明,先重读当前源码;不要暴露渲染器实际不支持的新 UI 选项;不要把通用 Mermaid 编写当作编辑器维护任务。具体安装命令、版本或价格信息暂未提供。