mapping-visualization-scaffolds

映射与可视化脚手架

目录

• 工作流
• 常见模式
• 护栏
• 快速参考

工作流

复制此清单并跟踪进度：

Mapping Visualization Progress:
- [ ] Step 1: Clarify mapping purpose
- [ ] Step 2: Identify nodes and relationships
- [ ] Step 3: Choose visualization approach
- [ ] Step 4: Create the map
- [ ] Step 5: Validate and refine

步骤 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
• 包含：节点、关系、分组、图例（如有需要）
• 格式：使用 ASCII 图示或结构化列表的 Markdown

成功标准：

• 识别出所有关键节点
• 清晰标注关系及其方向
• 采用适当的分组或分层
• 目标受众无需说明即可理解
• 根据质量评分标准验证（得分 ≥ 3.5）