/taiyi-diagram-c4

name: taiyi-diagram-c4
description: TaiyiForge 辅助 — 从代码反推 C4 架构文档（Observed/Inferred 分层 · Mermaid 真源）。OpenCode / Claude / Codex / Cursor 通用。

taiyi-diagram-c4

目的

扫描仓库代码，产出 **C4 架构真源文档**（Scope · Observed · Inferred · Mermaid），供后续 `/taiyi:diagram-arch` 与 `/taiyi:diagram-render` 引用——**不重复猜模块边界**。

何时使用

| 时机 | 说明 | |------|------| | 架构流水线 **第 1 步** | `/taiyi:diagram-pipeline` 自动调用 | | 陌生代码库 / 大重构 | 单独 `/taiyi:diagram-c4` | | design 前需证据级架构 | 先于 `taiyi-diagram-arch` |

可跳过：纯文案改动、模块边界已在 DESIGN 冻结且无代码漂移。

外部 Skill（可选增强）

若已安装开源 **`c4-codebase-architecture`**，加载它并遵循其 Observed/Inferred 纪律；未安装则按本 Skill 执行同等流程。

npx skills add lmammino/c4-codebase-architecture-skill --skill c4-codebase-architecture -a cursor

输入

• 仓库根或 `--scope <path>`（如 `src/core`）
• （变更内）`REQUIREMENT.md`、`DESIGN.md`、`CONTEXT.md`
• `docs/ARCHITECTURE.md`（若有）

输出

| 范围 | 路径 | |------|------| | **变更内**（默认，有 active slug） | `.taiyi/changes/<slug>/diagrams/c4/README.md`、`containers.md`、可选 `context.md` | | **仓库级**（`--repo` 或无 slug） | `docs/c4/README.md`、`docs/c4/containers.md`、可选 `docs/c4/context.md` |

**mark-aux**：`scripts/taiyi-forge.sh mark-aux <slug> taiyi-diagram-c4`（变更内且 `diagrams/c4/containers.md` 有实质内容）。

执行步骤

1. **定范围**：全仓库 / `src/core` / 单服务；写明 in-scope / out-of-scope 2. **扫证据**：入口（`src/cli`、`src/plugin`）、`package.json`、`workflow-manifest.yaml`、部署/CI 描述 3. **写 README.md**：Scope · Observations（Observed）· Assumptions（Inferred）· Open questions 4. **写 containers.md**：`C4Container` 或结构化 `graph TB` Mermaid；节点用真实路径/包名 5. **（可选）context.md**：仅当存在明确外部系统/用户角色时 6. **禁止**：把未确认推断写成 Observed；不要在此步导出 PNG（交给 `/taiyi:diagram-render`）

质量自检

• [ ] Observed 与 Inferred 分节
• [ ] 每个容器可映射到仓库路径
• [ ] Mermaid 在 GitHub 预览可渲染
• [ ] README 注明下游：`/taiyi:diagram-arch` → `/taiyi:diagram-render`

流水线位置

/taiyi:diagram-c4  →  /taiyi:diagram-arch  →  /taiyi:diagram-render
     (本 Skill)          (同步工程图)            (PNG + 视觉审查)

总命令：`/taiyi:diagram-pipeline`