shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

client-arch-explain

Generate customer-friendly architecture explanations (using plain language to explain the architecture layers, data flow, and technology choices), suitable for presentation and review meetings. To be used when preparing for client presentations or user acceptance.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

client-arch-explain: 客户友好的架构说明

描述

生成客户友好的架构说明（通俗语言解释架构层次、数据流、技术选型），适合演示和评审会议。

适用场景

  • WORKFLOW：准备客户演示或评审会议
  • 沟通场景：需要向非技术人员解释架构
  • 用户验收前：生成客户友好的沟通材料

输入

  • design/ 目录（ARCH/VS/SD/DM）
  • requirements/ 目录（业务上下文）

输出

  • 客户友好的架构说明（markdown）
  • 架构概览（1-2 段通俗语言）
  • 分层说明（每层 1-2 句业务价值）
  • 数据流说明（结合业务场景）
  • 技术选型说明（业务语言）

执行策略

  1. 从 ARCH 提取架构层次
  2. 从 VS 提取核心业务场景
  3. 从 SD 提取数据流
  4. 生成客户友好的架构说明：
    • 架构概览：用类比（如"三层结构类似商店的前台、仓库、财务"）
    • 分层说明：每层的业务价值（如"展示层负责用户看到的界面"）
    • 数��流说明：结合业务场景（如"当用户提交订单时，数据从前台流向仓库"）
    • 技术选型：业务语言（如"PostgreSQL确保订单数据不会丢失"）
  5. 确保业务语言占比 ≥90%

价值

  • SPEC 组织：补充客户沟通材料
  • PM/用户：理解架构设计
  • Dev：清晰的业务上下文