dong90 taiyi-diagram-arch
目的
把 DESIGN.md 里的文字架构落成可读、可版本管理、可导出高清的架构图——组件边界、数据流、部署视图、产品级全景图（Flow-X 风格海报）。
何时使用
| 时机 | 说明 |
|---|---|
taiyi-design 写 Architecture 节 |
默认推荐（与 ASCII/mermaid 并列） |
| 新模块 / 跨服务边界 | 必做 C4 或组件图 |
| 仓库级文档 | docs/*-architecture.svg + PNG |
taiyi-evolve 发现架构漂移 |
同步更新架构图 |
可跳过：纯文案/配置改动、无新组件且无边界变化。
输入
- 优先真源：
diagrams/c4/containers.md或docs/c4/containers.md（由/taiyi:diagram-c4产出） REQUIREMENT.md、DESIGN.md（Decision + Architecture 草稿）CONTEXT.md（既有模块与路径）- （可选）
adr/、docs/ARCHITECTURE.md
流水线第 2 步：加载本 Skill 时同步 C4 真源，勿重新划分模块。总编排：/taiyi:diagram-pipeline。
输出（择一或组合）
| 产物 | 路径 | 适用 |
|---|---|---|
| 变更内架构说明 | .taiyi/changes/<slug>/diagrams/architecture.md |
九阶段工件（mark-aux 检测） |
| 嵌入 DESIGN | DESIGN.md § Architecture 内 mermaid 代码块 |
轻量变更 |
| 矢量海报 | diagrams/architecture.svg + architecture.png |
产品/对外文档 |
| 仓库级 | docs/<name>-architecture.svg |
本仓库参考：docs/taiyiforge-architecture.svg |
mark-aux：独立文件路径时执行 scripts/taiyi-forge.sh mark-aux <slug> taiyi-diagram-arch。
图类型选型
| 问题 | 推荐图型 | 工具 |
|---|---|---|
| 模块谁依赖谁 | graph TB / graph LR |
Mermaid |
| 请求怎么走 | sequenceDiagram |
Mermaid |
| 部署/运行时 | graph + subgraph 环境 |
Mermaid |
| 产品全景（六大标准+九阶段+门禁） | 分栏海报 SVG | Python 脚本或手调 SVG |
| C4 容器级 | Mermaid C4（若渲染器支持）或结构化 graph | Mermaid |
执行步骤
- 若存在
diagrams/c4/containers.md：以其为节点/边界真源；顶部加> C4 真源：diagrams/c4/containers.md - 读 DESIGN Decision：只画「已选定方案」，不把未选 Option 画进主图
- 列节点清单：组件名 = 仓库内真实路径/包名（如
src/core/workflow-engine.ts） - 选视图：默认 1 张组件图 + 1 张关键序列图（有外部 API 时）
- 写 Mermaid（变更内首选）：
# Architecture Diagram
## Component view
\`\`\`mermaid
graph LR
CLI[taiyi CLI] --> Engine[workflow-engine]
Engine --> Manifest[workflow-manifest.yaml]
Engine --> Skills[skills/taiyi-*]
\`\`\`
## Notes
- 与 DESIGN.md §Decision 一致
- 更新日期：ISO8601
- （可选）导出 PNG：
node scripts/render-mermaid.mjs .taiyi/changes/<slug>/diagrams/architecture.md - （产品海报） 宽屏分栏布局参考
docs/taiyiforge-architecture.svg；可 forkscripts/generate-architecture-svg.py改文案后重跑 - 回链 DESIGN.md：Architecture 节写
详见 diagrams/architecture.md或内嵌同一段 mermaid - mark-aux（若写了独立 diagrams 文件）
视觉规范（对齐 Flow-X / TaiyiForge 海报）
- 画布：宽屏 16:9 或 3:2（如 2800×1880 SVG viewBox）
- 背景：深色
#060b16，面板#0d1528，文字#eef2ff - 结构：顶栏标准 → 左 ARTIFACT → 中 CORE + 九阶段 → 右门禁 → 底 Skill 全景 → 页脚价值
- 导出清晰度：SVG 真源 + PNG ≥5×（本仓库：
python3 scripts/generate-architecture-svg.py→ 16800×11280）
质量自检
- 每个框可映射到 REQUIREMENT AC 或 DESIGN 组件表
- 箭头方向与数据/控制流一致（无「悬空节点」）
- 图例或 Notes 说明缩写与边界（Trust boundary、DB、外部 SaaS）
- Mermaid 在 GitHub / Cursor 预览可渲染（避免实验语法）
- 若与旧图冲突，在 Notes 标 supersedes 路径
与主流程
taiyi-requirement → taiyi-design
↓
taiyi-diagram-arch（推荐）
taiyi-diagram-flow（流程细节）
↓
DESIGN.md + diagrams/
禁止
- 无 DESIGN 决策就画「最终架构」
- 架构图代替 ADR（边界决策仍走
taiyi-architect） - 仅截图无源文件（须保留
.md/.svg可 diff 真源）