用途
Mindmap PPT Builder 用于把用户提供的源文档转换为适合本仓库的演示项目文件 project/source.js。源文档可以是对话中的粘贴文本，也可以是用户提供的本地文本或 Markdown 文件路径。输出的产物是一张前序遍历的思维导图，节点简洁、每节点两行，可选配节点图片，并附带与当前浅色 PPT 风格一致的本地素材。
主要能力
- 读取源文档并识别演示主题。
- 默认跟随源语言：中文输入输出中文，英文输入输出英文。
- 构建清晰的逻辑树：根节点为文档或演示主题，主分支通常 2 至 4 个，子节点用于表达原因、结果、证据、示例、流程步骤、对比或补充。
- 每个节点写成一个无序列表项加一条可选延续行，第一行为简短分类标签，第二行为主要信息。
- 节点图片为可选项，通常选取 3 至 8 个高信息量节点配图；短草稿可用 0 至 2 张图。
- 当图像生成不可用时，可用受限配色方案创建简单 SVG 占位图。
使用方式
- 获取用户源文档：优先使用对话中粘贴的文本；若用户给出本地文件路径，只读取该明确提供的文档文件；两者都不可用时，向用户索要文档。
- 阅读文档并识别演示主题。
- 构建逻辑树。
- 按双行节点格式撰写每个节点，每行控制在约 30 个中文字符或 8 个英文单词以内。
- 审慎选择图像节点，用 GPT Image 2 或可用图像生成工具为选定节点生成插图，保存在 project/ 或其子文件夹下。
- 用 sourceMarkdown 替换 project/source.js，并在写入用户文本前转义反引号和 ${...} 序列。
- 运行 npm run check。可选运行 npm run dev 并进行视觉验证。
工作区要求
该技能仅在当前工作目录树内运行，即 cwd 本身或其下的 mindmap-ppt/ 子文件夹。不要搜索父目录、同级目录或主目录中已有的检出。将 https://github.com/agegr/mindmap-ppt 克隆到当前工作目录下的 ./mindmap-ppt/ 并进入该目录。若 ./mindmap-ppt/ 已存在，应停止并询问用户如何处理。不要通过 cd ..、find 等方式探测文件系统或在别处创建检出。应用仓库应保持在技能文件夹之外，不要把 index.html、src/ 或 project/ 复制或克隆到 .agents/skills/mindmap-ppt-builder/。正常技能输出只应修改 project/source.js 和 project/ 下的本地素材文件。
适用场景
适用于需要把一处或多处散文、文章、演讲、报告或笔记整理成结构化思维导图演示的场合。也可以用于从中文或英文文档生成对应语言的双行节点思维导图。
限制
- 思维导图必然会省略大量源文档细节。
- 不应对源文档事实做静默纠正；若源文档有矛盾或存疑说法，应保留或向用户提示冲突。
- 除非用户明确要求清理，否则不要删除已有项目素材。
- 除非用户明确要求实现变更，否则不要编辑 src/、index.html 或应用行为。
- 图像路径默认相对于 project/，仅可使用 PNG、JPG/JPEG 或 SVG 素材，且每个 @image 都必须有对应素材文件存在。
- 若源文档过长或过宽泛，应先保留原章节结构；若材料过于宽泛难以自信地精简，应先起草高层大纲并请用户确认优先级。