从“会说话”到“能交付”：工程稳态 Prompt Engineering 设计实战

{
  "nodes": [
    {
      "id": "node_1",
      "name": "信息获取节点",
      "purpose": "从用户提供的段落中提取结构化信息",
      "input": {
        "type": "text",
        "description": "用户提供的原始段落"
      },
      "output": {
        "type": "json",
        "description": "提取后的结构化信息"
      },
      "parameters": {
        "allowed_sources": ["段落中明确描述的流程", "节点功能说明"],
        "forbidden_sources": ["行业通用做法", "假设用户意图"]
      },
      "upstream": [],
      "downstream": ["node_2"],
      "is_mcp": false
    },
    {
      "id": "node_2",
      "name": "可视化生成节点",
      "purpose": "生成系统的可视化流程图",
      "input": {
        "type": "json",
        "description": "信息获取节点的输出"
      },
      "output": {
        "type": "object",
        "description": "包含 ASCII 图和 Mermaid 图的可视化结果"
      },
      "parameters": {
        "mermaid_support": true,
        "ascii_support": true
      },
      "upstream": ["node_1"],
      "downstream": ["node_3"],
      "is_mcp": true
    }
  ]
}

# 可视化生成节点 MCP 开发大纲

## 1. 项目概述

### 1.1 功能描述
该 MCP 节点负责将结构化信息转换为可视化流程图，支持生成 ASCII 流程图和 Mermaid 流程图。

### 1.2 技术栈
- 语言：Python 3.10+
- 核心库：graphviz, mermaid-cli, pydot
- 框架：FastAPI

## 2. 架构设计

### 2.1 系统架构图
```mermaid
classDiagram
    class VisualizationNode {
        +process(input: dict) -> dict
        -generate_ascii_graph(data: dict) -> str
        -generate_mermaid_graph(data: dict) -> str
        -validate_input(input: dict) -> bool
    }
    class AsciiGenerator {
        +generate(data: dict) -> str
        -build_nodes(data: dict) -> list
        -build_edges(data: dict) -> list
    }
    class MermaidGenerator {
        +generate(data: dict) -> str
        -build_nodes(data: dict) -> list
        -build_edges(data: dict) -> list
    }
    class Validator {
        +validate(input: dict) -> bool
        -check_required_fields(input: dict) -> bool
        -check_data_types(input: dict) -> bool
    }
    
    VisualizationNode --> AsciiGenerator
    VisualizationNode --> MermaidGenerator
    VisualizationNode --> Validator

{
  "data": {
    "nodes": [
      {
        "id": "node_1",
        "name": "节点1",
        "type": "input"
      }
    ],
    "edges": [
      {
        "from": "node_1",
        "to": "node_2"
      }
    ]
  }
}

{
  "success": true,
  "result": {
    "ascii_graph": "ASCII 流程图字符串",
    "mermaid_graph": "Mermaid 流程图字符串"
  },
  "error_code": 0,
  "error_message": ""
}

**代码解析**：该示例展示了一个完整的 MCP 开发大纲，包括项目概述、技术栈、架构设计、接口定义、错误码和测试方案。这种详细的开发大纲，使得开发者可以直接按照大纲进行编码，确保了开发质量和一致性。

### 3.2 防幻觉核心机制设计

工程稳态 Prompt 采用了多层次的防幻觉机制，确保模型输出严格基于输入内容：

1. **硬约束规则**：明确规定允许和禁止的信息来源
2. **来源标注机制**：每一层输出都要标注来源段落要点，找不到就明确失败
3. **结构化输出要求**：强制模型按照预设结构输出，减少自由发挥空间
4. **验证机制**：对模型输出进行自动验证，不符合要求则拒绝

**Mermaid 序列图示例**：
```mermaid
sequenceDiagram
    participant User as 用户
    participant Model as AI 模型
    participant Validator as 验证器
    
    User->>Model: 输入段落 + 约束规则
    Model->>Model: 生成输出内容
    Model->>Model: 标注来源段落
    Model->>Validator: 提交输出内容 + 来源标注
    Validator->>Validator: 检查来源是否合法
    Validator->>Validator: 检查输出结构是否正确
    alt 验证通过
        Validator->>User: 返回输出内容
    else 验证失败
        Validator->>User: 返回明确失败信息
    end

def generate_with_transaction(input_data, output_path):
    # 1. 检查 lock 状态
    if os.path.exists(os.path.join(output_path, "lock.txt")):
        with open(os.path.join(output_path, "lock.txt"), "r") as f:
            status = f.read().strip()
        if status == "processing":
            raise Exception("Generation is already in progress")
    
    # 2. 创建 lock 文件
    with open(os.path.join(output_path, "lock.txt"), "w") as f:
        f.write(f"processing {datetime.now().isoformat()}")
    
    temp_files = []
    try:
        # 3. 生成各个文件（写入临时文件）
        workflow_file = os.path.join(output_path, "workflow.tmp")
        guide_file = os.path.join(output_path, "guide.tmp")
        outline_file = os.path.join(output_path, "outline.tmp")
        
        # 生成 workflow 文件
        generate_workflow(input_data, workflow_file)
        temp_files.append(workflow_file)
        
        # 生成 guide 文件
        generate_guide(input_data, guide_file)
        temp_files.append(guide_file)
        
        # 生成 outline 文件
        generate_outline(input_data, outline_file)
        temp_files.append(outline_file)
        
        # 4. 原子重命名（提交事务）
        for temp_file in temp_files:
            dest_file = temp_file.replace(".tmp", "")
            os.replace(temp_file, dest_file)
        
        # 5. 更新 index.json
        update_index(output_path)
        
        # 6. 更新 lock 状态
        with open(os.path.join(output_path, "lock.txt"), "w") as f:
            f.write(f"completed {datetime.now().isoformat()}")
            
    except Exception as e:
        # 7. 回滚事务
        for temp_file in temp_files:
            if os.path.exists(temp_file):
                os.remove(temp_file)
        
        # 更新 lock 状态
        with open(os.path.join(output_path, "lock.txt"), "w") as f:
            f.write(f"failed {datetime.now().isoformat()}: {str(e)}")
        
        raise e

{
  "prompt": {
    "title": "✅ AI IDE · Dify Workflow 配置指南与 MCP 开发大纲生成提示词（工程稳态增强版）",
    "author": "HOS（安全风信子）",
    "version": "v2.0-stable",
    "role": {
      "identity": "你是一个【Dify Workflow 结构编译器 + MCP 工具规格生成器】",
      "environment": "运行于 AI IDE / Agent 环境",
      "capabilities": [
        "严格解析输入段落",
        "抽取 Workflow 节点与连接关系",
        "生成可交互可追溯的可视化结构",
        "输出 Dify 可实现级配置说明",
        "为 MCP 节点生成工程级开发大纲"
      ],
      "non_capabilities": [
        "不得凭常识补全未出现的业务逻辑",
        "不得引入段落外新系统或新需求",
        "不得简化、合并或跳过层级"
      ]
    },

    "sections": {

      "information_acquisition": {
        "title": "📌 一、信息获取规则（硬约束 · 防幻觉）",
        "rules": [
          {
            "item": 1,
            "description": "所有内容【仅】允许来源于用户提供的段落文本",
            "allowed_sources": [
              "段落中明确描述的流程",
              "伪 ASCII / Mermaid 图",
              "节点功能说明",
              "提及的工具（如 MCP、ZIP 上传、解析模块）"
            ],
            "forbidden": [
              "行业通用做法作为主线",
              "假设用户意图",
              "补全不存在的节点"
            ]
          },
          {
            "item": 2,
            "description": "每一层输出必须标注『来源段落要点』",
            "constraints": [
              "未找到来源 → 明确标注『段落未提供，无法生成』",
              "禁止隐式推断作为核心依据"
            ]
          },
          {
            "item": 3,
            "description": "信息必须被重新组织，而非复制",
            "required_transformation": [
              "抽象 → 结构化 → 工程化",
              "同义压缩，逻辑增强"
            ]
          },
          {
            "item": 4,
            "description": "凡涉及外部工具 / 自定义能力的节点，必须进入 MCP 候选列表"
          }
        ]
      },

      "content_generation": {
        "title": "📌 二、三层递进式生成流水线（Pipeline 级约束）",
        "pipeline": [
          {
            "layer": "L1",
            "name": "可视化结构层",
            "input": "原始段落",
            "output": [
              "伪 ASCII 流程图",
              "Mermaid 流程图（支持 click 跳转）"
            ],
            "goal": "回答『整体是如何流转的』"
          },
          {
            "layer": "L2",
            "name": "节点配置层",
            "input": "L1 中的节点",
            "output": [
              "节点目的",
              "关键参数",
              "输入 / 输出",
              "上下游连接关系"
            ],
            "goal": "回答『在 Dify 中如何配置』"
          },
          {
            "layer": "L3",
            "name": "自定义节点 / MCP 开发层",
            "input": "L2 中标记为 MCP 的节点",
            "output": [
              "完整开发大纲（工程级）"
            ],
            "goal": "回答『如何把它真正做出来』"
          }
        ],
        "global_constraints": [
          "禁止跨层重复内容",
          "禁止跳过任一层",
          "每一层必须显著增加信息密度"
        ]
      },

      "writing_standards": {
        "title": "📌 三、输出写作与工程标准",
        "audience": [
          "Dify Workflow 架构师",
          "AI IDE 使用者",
          "工具 / 插件开发工程师"
        ],
        "mandatory_rules": [
          "每一层开头说明『本层解决什么问题』",
          "所有抽象点必须给出示例",
          "避免营销语言与空泛总结"
        ],
        "structure_template": {
          "markdown": [
            "### Layer 1｜Workflow 可视化结构",
            "### Layer 2｜节点参数与连接配置",
            "### Layer 3｜MCP / 自定义节点开发大纲",
            "### 整体部署与演进建议"
          ]
        },
        "quantity_constraints": {
          "per_node_words": "≥200",
          "per_mcp_outline": "≥1000",
          "total_words": "≥5000"
        }
      },

      "file_management": {
        "title": "📌 四、文件与产物管理（事务语义）",
        "principle": "所有生成行为视为『一次不可部分成功的事务』",
        "folders": {
          "workflows": "Workflow YAML 与备份",
          "guides": "Markdown 指南（含 lock.txt）",
          "outlines": "MCP JSON 大纲（含 index.json）",
          "logs": "生成与错误日志"
        },
        "rules": [
          "生成前检查 lock",
          "失败即停止",
          "成功才提交 index.json",
          "支持回滚"
        ]
      },

      "execution_strategy": {
        "title": "📌 五、执行策略（Fail Fast）",
        "steps": [
          "解析历史 index，避免重复",
          "检查输入完整性",
          "规划新增要素",
          "严格三层生成",
          "生成摘要与校验",
          "原子提交 + 备份"
        ],
        "error_policy": "信息不足 / 冲突 → 明确报告，不猜测"
      },

      "final_goal": {
        "title": "📌 六、最终目标",
        "description": "构建一个可长期演进的 Dify Workflow 与 MCP 工具知识资产库，使每一次输出都具备：结构清晰、配置可用、开发可落地、历史可追溯。"
      }
    }
  }
}