AgentSkillsCN

c4-diagrams

当您被要求绘制架构图、系统图、C4图,或可视化代码/功能流程时,可使用此技能。默认情况下,该技能会在Context与Container层级生成Mermaid C4图。

SKILL.md
--- frontmatter
name: c4-diagrams
description: Use this skill when asked to create architecture diagrams, system diagrams, C4 diagrams, or visualize code/feature flows. Generates Mermaid C4 diagrams at Context and Container levels by default.

C4 Architecture Diagrams

Generate C4 architecture diagrams using Mermaid syntax.

Default Behavior

  • Always generate: Context (L1) and Container (L2) diagrams
  • Only on request: Component (L3) - user must explicitly ask
  • Output format: Mermaid C4 syntax in markdown code blocks
  • Write to: scratch/plans/ or scratch/context/ depending on purpose

Process

  1. Analyze the code path or feature requested
  2. Identify system boundaries, external actors, containers
  3. Generate Context diagram (L1) - system and external dependencies
  4. Generate Container diagram (L2) - internal structure
  5. Skip Component (L3) unless explicitly requested

Output Structure

markdown
# [Feature/System] Architecture

## Context Diagram (L1)
[mermaid block]

Brief description of external interactions.

## Container Diagram (L2)
[mermaid block]

Brief description of internal structure.

Templates

Reference @templates/context.md and @templates/container.md for Mermaid C4 syntax.

Rules

  • Keep descriptions concise (1-2 sentences per diagram)
  • Use snake_case for IDs in mermaid
  • Label all relationships with action verbs
  • Include external systems and actors
  • Write output to scratch/ per workspace rules