taiyi-diagram-pipeline

name	taiyi-diagram-pipeline
description	TaiyiForge 辅助 — 架构图三步流水线编排（C4 真源 → 工程图同步 → PNG 渲染）。OpenCode / Claude / Codex / Cursor 通用。

taiyi-diagram-pipeline

目的

一条命令串联架构图流水线，避免三个 Skill 各扫一遍代码产出三套不一致的图。

斜杠命令

步骤	命令	Skill
1 C4 真源	/taiyi:diagram-c4 [slug] [--repo] [--scope path]	taiyi-diagram-c4
2 工程图同步	/taiyi:diagram-arch [slug] [topic]	taiyi-diagram-arch
3 导出图	/taiyi:diagram-render [slug] [--repo] [--review]	taiyi-diagram-render
总编排	/taiyi:diagram-pipeline [slug] [--repo] [--scope path] [--skip-render]	本 Skill

何时使用

• 维护仓库级 docs/c4/ + docs/diagrams/architecture.md
• design 阶段一次性产出变更内 diagrams/c4/ + diagrams/architecture.md + PNG
• onboarding：从代码到可评审架构图

不替代 /taiyi:diagram-flow（九阶段/门禁流程图）。

参数

参数	含义
slug	活动变更；省略且仅一个 active 时可推断
--repo	仓库级输出到 docs/c4/、docs/diagrams/（无 mark-aux）
--scope path	C4 扫描子目录（传给 diagram-c4）
--skip-render	只跑 ①②，不导出 PNG
--review	第 3 步优先 diagramming-architecture 视觉审查（较慢）

执行顺序（Agent 必须按序）

Step 1 — /taiyi:diagram-c4

加载 taiyi-diagram-c4（或 c4-codebase-architecture）。产出 diagrams/c4/README.md + containers.md（或 docs/c4/）。

门禁：containers.md 含可渲染 mermaid 且 Observed/Inferred 已分节 → 否则停止，不进入 Step 2。

Step 2 — /taiyi:diagram-arch

加载 taiyi-diagram-arch。以 Step 1 的 containers.md 为真源：

• 同步到 diagrams/architecture.md（或 docs/diagrams/architecture.md）
• 在 architecture 顶部回链：> C4 真源：diagrams/c4/containers.md
• 禁止重新划分模块；可补充序列图、Notes
• mark-aux taiyi-diagram-arch（变更内）

Step 3 — /taiyi:diagram-render（除非 --skip-render）

加载 taiyi-diagram-render。以 Step 1 c4 mermaid 导出 c4/png/*.svg；可选将 Step 2 architecture.md 导出到 diagrams/png/。

• mark-aux taiyi-diagram-render（变更内）

完成摘要

向用户报告：

Pipeline 完成
  C4:     <path/to/containers.md>
  Arch:   <path/to/architecture.md>
  PNG:    <path/to/png/>  (或 skipped)
  mark-aux: diagram-arch [, diagram-c4, diagram-render]

读优先

• docs/diagrams/pipeline.md — 路径约定与示例

与 design 阶段

taiyi-design 推荐：大改/陌生代码用 /taiyi:diagram-pipeline；轻量变更仅 /taiyi:diagram-arch。