xmind-generator — 场景→功能拆解→XMind 文件
能力说明
接收任意场景描述(产品需求、业务流程、系统规划等),智能分析并拆解为多层级功能点,每个节点配有清晰的功能说明,最终生成可直接用 XMind 打开的 .xmind 文件。
执行流程(必须按顺序完成)
Step 1:理解场景,确定输出范围
- 仔细阅读用户的场景描述,识别:
- 系统/产品名称(用作根节点标题)
- 核心用户角色
- 主要业务领域/功能模块
- 如描述模糊,可简短追问 1 个关键问题,但通常直接分析即可
Step 2:智能拆解功能点,构建 JSON 结构
拆解原则(按场景复杂度灵活选择):
| 系统规模 | 建议层级深度 | 一级模块数量 |
|---|---|---|
| 简单功能/单一场景 | 2 层 | 3-5 个 |
| 中等复杂系统 | 3 层 | 5-8 个 |
| 复杂平台/多角色系统 | 3-4 层 | 6-10 个 |
拆解视角优先级(依次尝试,选最合适的):
1. 用户旅程视角:按用户完成任务的流程组织模块
2. 业务域视角:按核心业务对象(订单/库存/用户等)划分
3. 系统能力视角:数据层/业务层/展示层/集成层
note 字段撰写要求:
- 根节点:系统定位 + 核心价值(1-2句)
- 一级节点:模块职责 + 覆盖的核心场景
- 二级节点:具体功能描述(用户能做什么)+ 关键业务规则
- 三级节点:操作细节、边界条件(简洁即可)
详细 JSON 结构规范参考:references/xmind_json_schema.md
构建后,将完整 JSON 写入临时文件,路径建议:
<工作目录>/<系统名称>_mindmap.json
Step 3:生成 .xmind 文件
调用内置脚本:
python "<skill_dir>/scripts/gen_xmind.py" "<json文件路径>" "<输出.xmind路径>"
其中 <skill_dir> 为本 skill 所在目录(即 ~/.workbuddy/skills/xmind-generator)。
输出文件路径建议:
- 若用户指定了工作目录,输出到该目录下
- 否则输出到当前工作区根目录,文件名使用系统/产品名称
Step 4:交付结果
- 调用
deliver_attachments将.xmind文件发送给用户 - 在回复中提供功能清单摘要:
- 列出根节点 + 所有一级模块(表格形式)
- 每个模块的子功能数量
- 总功能点数量统计 - 提示用户:双击
.xmind文件即可用 XMind 软件打开;若无 XMind,可使用 XMind 官网 免费下载
注意事项
- 不要安装第三方库:
gen_xmind.py仅使用 Python 标准库(zipfile、xml、uuid、json),无需 pip install - 文件编码:JSON 文件必须使用 UTF-8 编码保存,脚本已内置处理
- XMind 兼容性:生成的文件兼容 XMind 8 及以上版本(Legacy 格式)
- 路径处理:Windows 路径中含空格时,确保用引号包裹完整路径
- 内容质量:功能拆解是核心价值所在,宁可多花时间思考结构,也不要生成空洞的节点名称
- 层级平衡:同一父节点下的子节点数量建议保持在 3-8 个,避免过于稀疏或密集
快速示例
用户输入:「帮我把"企业采购SRM系统"的功能梳理成思维导图」
期望输出结构(简化):
企业采购SRM系统
├── 供应商管理 [注:供应商全生命周期管理,覆盖引入/评估/淘汰]
│ ├── 供应商注册与认证 [注:供应商自助注册,资质审核流程]
│ ├── 供应商评级 [注:综合评分模型,定期自动评估]
│ └── 供应商档案 [注:基础信息/合同/往来记录统一管理]
├── 询比价管理 [注:多种询价方式,支持比价分析]
│ ├── 询价单管理
│ ├── 供应商报价
│ └── 比价分析
├── 合同管理 [注:采购合同全周期管理]
├── 订单管理 [注:采购订单生命周期跟踪]
├── 收货与质检 [注:到货验收、质量检验流程]
└── 数据分析 [注:采购成本、供应商绩效等核心报表]