Night Market 技能 — 来自 claude-night-market/cartograph。如需完整体验（含智能体、钩子与命令支持），请安装 Claude Code 插件。

架构图

生成一个 Mermaid 流程图，展示代码库中高层组件之间的关系。

适用场景

• 可视化插件/模块之间的依赖与关联关系
• 新成员上手时快速理解系统整体结构
• 在 PR 评审中作为架构文档进行说明
• 回答“该系统各部分如何协同工作？”这类问题

工作流程

步骤 1：探索代码库

调用 codebase explorer 智能体分析作用域：

Agent(cartograph:codebase-explorer)
Prompt: 探索 [scope] 并返回结构化模型。
重点关注包（packages）、模块（modules）及其相互关系，
以支撑架构图生成。

若未指定 scope，则默认使用项目根目录。

步骤 2：生成 Mermaid 语法

将结构化模型转换为 Mermaid 流程图语法。

架构图绘制规范：

• 对具有层级结构的系统，使用 flowchart TD（自上而下）
• 对管道式/数据流系统，使用 flowchart LR（从左到右）
• 按包（package）对相关模块进行分组，使用 subgraph
• 使用具描述性的边标签（edge labels）标明组件间关系
• 节点总数控制在 15–20 个以内（可将小型模块聚合表示）
• 通过不同形状区分组件类型：
  • [矩形] 表示模块或包
  • ([椭圆角矩形]) 表示入口点或命令（entry points / commands）
  • [(圆柱体)] 表示数据存储（data stores）
  • {菱形} 表示决策点（decision points）

输出示例：

flowchart TD
    subgraph sanctum[Sanctum 插件]
        commit[提交信息]
        pr[PR 准备]
        workspace[工作区评审]
    end

    subgraph leyline[Leyline 插件]
        git[Git 平台]
        patterns[错误模式]
    end

    commit --> git
    pr --> workspace
    pr --> git
    workspace --> patterns

步骤 3：通过 MCP 渲染图表

调用 Mermaid Chart MCP 执行渲染：

mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram
  prompt: "[scope] 的架构图"
  mermaidCode: [生成的语法]
  diagramType: "flowchart"
  clientName: "claude-code"

若渲染失败，请根据错误信息修正 Mermaid 语法并重试（最多重试 2 次）。

步骤 4：呈现结果

向用户展示渲染完成的图表，并附上简明摘要（2–3 句话），说明图表所表达的核心结构与关系。