名称: 映射与可视化框架描述: 当复杂系统需要视觉文档化时使用，映射组件关系和依赖，创建层次结构或分类，文档化流程或决策树，理解系统架构，可视化数据谱系或知识结构，规划信息架构，或当用户提到概念地图、系统图表、依赖映射、关系可视化或架构蓝图时。

映射与可视化框架

目的

创建视觉映射，通过图表、概念地图和架构蓝图使隐式的关系、依赖和结构变得明确。

何时使用

使用映射-可视化框架当您需要：

系统理解：

文档化复杂系统架构（微服务、基础设施、数据流）
映射组件依赖和关系
可视化API端点和集成点
理解遗留系统结构

知识组织：

为学习或教学创建概念地图
构建分类和层次结构
组织研究文献或领域知识
结构化信息架构

流程与流程文档化：

映射用户旅程和工作流
创建决策树和流程图
文档化审批链或升级路径
可视化项目依赖和时间线

战略可视化：

映射利益相关者关系和影响力
可视化组织结构
创建竞争格局图
文档化价值链或商业模式

它是什么

映射框架是一种结构化方法，用于创建视觉表示，显示：

节点（组件、概念、人员、步骤）
关系（连接、依赖、层次结构、流）
属性（属性、状态、元数据）
分组（集群、类别、层）

快速示例：

对于微服务架构：

节点: API网关、认证服务、用户服务、支付服务、数据库
关系:
  - API网关 → 调用 → 认证服务
  - 认证服务 → 验证 → 用户服务
  - 支付服务 → 读/写 → 数据库
分组: 前端层、业务逻辑层、数据层

这创建了一个视觉映射，显示服务如何连接和相互依赖。

工作流程

复制此清单并跟踪进度：

映射可视化进度:
- [ ] 步骤 1: 澄清映射目的
- [ ] 步骤 2: 识别节点和关系
- [ ] 步骤 3: 选择可视化方法
- [ ] 步骤 4: 创建地图
- [ ] 步骤 5: 验证和完善

步骤 1: 澄清映射目的

询问用户目标：需要映射什么系统/概念？受众是谁？这将为哪些决策提供信息？需要什么详细程度？参见常见模式了解典型用例。

步骤 2: 识别节点和关系

列出所有关键元素（节点）及其连接（关系）。识别层次级别、依赖类型和分组标准。对于简单情况（< 20 节点），使用resources/template.md。对于复杂系统（50+ 节点）或协作会话，参见resources/methodology.md获取高级策略。

步骤 3: 选择可视化方法

根据复杂性选择格式：简单列表用于 < 10 节点，树图用于层次结构，网络图用于复杂关系，或分层图用于系统。对于大规模系统或多地图层次结构，咨询resources/methodology.md获取映射策略和工具选择。参见常见模式获取指导。

步骤 4: 创建地图

使用Markdown、ASCII图或结构化文本构建可视化。从高级结构开始，然后添加细节。如果需要，包括图例。使用resources/template.md作为框架。

步骤 5: 验证和完善

使用resources/evaluators/rubric_mapping_visualization_scaffolds.json检查完整性、清晰度和准确性。确保所有关键节点和关系都存在。最低标准：得分 ≥ 3.5 平均。

常见模式

架构图：

系统组件作为节点
服务调用/数据流作为关系
层作为分组（前端、后端、数据）
用于：技术文档、系统设计评审

概念地图：

概念/想法作为节点
“是”、“有”、"导致"作为关系
主题作为分组
用于：学习、知识组织、研究综合

依赖图：

任务/功能/模块作为节点
“依赖于”、“阻塞”、"需要"作为关系
阶段/冲刺作为分组
用于：项目规划、风险评估、并行工作识别

层次结构与分类：

类别/类作为节点
父-子关系
级别作为分组（L1、L2、L3）
用于：信息架构、组织图、技能树

流程图：

步骤/状态作为节点
转换/决策作为关系
泳道作为分组（角色、系统）
用于：流程文档化、用户旅程、决策树

防护栏

范围管理：

专注于对特定目的重要的关系
不要映射一切—映射决策相关的
在适当细节级别停止（通常3-4层深）
对于 > 50 节点的系统，创建多个聚焦的地图

清晰度优于完整性：

优先可理解性而非穷尽性
使用一致的符号和命名
如果 > 3 种关系类型，添加图例
分组相关节点以减少视觉复杂性

验证：

与主题专家验证准确性
测试不熟悉的人是否能理解地图
检查缺失的关键关系
确保方向性清晰（A → B 与 A ← B）

常见陷阱：

❌ 创建具有太多连接的"毛球"图
❌ 混合抽象级别（战略 + 实现细节）
❌ 使用不一致的节点/关系表示
❌ 忘记说明地图的目的和范围

快速参考

资源：

resources/template.md - 用于创建地图的结构化框架
resources/evaluators/rubric_mapping_visualization_scaffolds.json - 质量标准

输出：

文件: mapping-visualization-scaffolds.md 在当前目录
包含: 节点、关系、分组、图例（如果需要）
格式: Markdown 带有 ASCII 图或结构化列表

成功标准：

所有关键节点已识别
关系清晰标记方向性
应用适当的分组/分层
目标受众无需解释即可理解
根据质量评估标准验证（得分 ≥ 3.5）