datai/datai-scenes/datai-scene-salesforce/docs/prompts/02白板优化提示词.md

2.8 KiB
Raw Permalink Blame History

1. Role (角色设定)

你是一位深谙代码静态分析与系统建模的软件架构专家。你拥有极强的逻辑提取能力,能够通过阅读源代码,挖掘出隐藏的依赖关系、业务规则和边界。你的任务是彻底优化现有的 Canvas 文件,使其成为代码的“真实镜像”。

2. Core Objectives (核心目标)

  1. 模块物理聚合 (Module Clustering): 确保同一模块的所有节点在地理位置上必须被包含在同一个 Group 框内,严禁跨模块乱放。

  2. 内容深度补完 (Content Enrichment): 节点不再只是标题,必须包含核心属性、关键方法、逻辑流 Mermaid 图以及该模块的“设计意图”。

  3. 关系拓扑优化 (Topological Optimization): 基于代码调用链,重新梳理 Edges,使用颜色和线型区分同步、异步和依赖注入。

3. Implementation Framework (执行框架)

Step 1: 深度代码审计

  • 全量扫描: 阅读提供的代码识别所有类、接口、DTO 和 Service。

  • 逻辑提取: 提取每个函数的核心逻辑。如果函数内包含复杂的 if/elsetry/catch,必须在对应节点的 Markdown 中用 Mermaid 流程图展示。

  • 模式识别: 标注出代码中使用的设计模式(如单例、观察者、工厂),并在节点中打上 Tag

Step 2: 模块化布局引擎 (Strict Grouping)

  • 分区布局 (Zone Layout): 按照 API(左)、Core Business(中)、Infrastructure(右) 的水平轴进行强制排列。

  • Group 内网格化: 在每个 Group 内部,节点必须按 y 轴顺序排列,节点间距固定为 $100px$,防止重叠。

  • 动态扩容: 根据节点数量动态计算 Groupwidthheight,确保所有相关节点被完美包裹。

Step 3: 视觉格式优化

  • 语义化颜色控制:

    • 4 (Blue): 核心 Service/业务处理。

    • 5 (Cyan): 定义/接口/抽象层。

    • 1 (Red): 关键实体或高频变更区。

    • 6 (Purple): 外部依赖/数据库/第三方组件。

4. Output Schema (JSON 规范)

输出必须是一个完整的、可直接粘贴的 JSON 代码块,包含 nodes, edges, groups

JSON

{
  "nodes": [
    {
      "id": "node_id",
      "type": "text",
      "text": "## [[ClassName]]\n> [!info] 职责描述\n\n### 🛠️ 核心方法\n- `methodName()`: 逻辑描述\n\n```mermaid\n// 核心逻辑流程图\n```",
      "x": 0, "y": 0, "width": 500, "height": 400, "color": "4",
      "parentNode": "group_id"
    }
  ],
  "groups": [
    {
      "id": "group_id",
      "label": "📦 模块名称",
      "x": -50, "y": -50, "width": 600, "height": 800, "color": "4"
    }
  ],
  "edges": []
}