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

工作流图谱

从代码或文档中生成 Mermaid 流程图，用于呈现处理流程、数据管道或状态机。

适用场景

• 可视化 CI/CD 或部署流水线
• 记录多步骤的开发工作流
• 映射状态机或生命周期流程
• 回答“当 X 运行时，具体执行哪些步骤？”这类问题

工作流

步骤 1：探索代码库

调用代码库探索智能体（codebase explorer agent）：

Agent(cartograph:codebase-explorer)
Prompt: 探索 [scope] 并返回结构化模型。
重点关注流程步骤、条件逻辑、状态转换及流水线阶段，以支撑工作流图谱生成。
重点关注：Makefile、CI 配置文件、钩子链（hook chains）、命令序列、生命周期方法等。

步骤 2：生成 Mermaid 语法

将结构化模型转化为带决策节点与处理步骤的 Mermaid 流程图。

工作流图谱绘制规范：

• 对顺序型流程使用 flowchart TD
• 对含并行分支的流水线使用 flowchart LR
• 使用不同形状区分步骤类型：
  • [矩形] 表示处理步骤
  • {菱形} 表示决策点
  • ([椭圆形]) 表示起始/终止状态
  • [[子程序]] 表示子流程
  • ((圆形)) 表示汇聚/同步点
• 使用 -->|标签| 标注转移条件
• 将并行分支归入子图（subgraph）进行分组
• 按结果类型进行颜色编码：
  • 默认样式表示主路径（happy path）
  • 虚线（-.->）表示错误/回退路径
  • 粗线（==>）表示关键路径（critical path）
• 节点总数不得超过 20 个

输出示例：

flowchart TD
    start([Start: PR Created])
    lint[Run Linters]
    test[Run Tests]
    review{Code Review}
    approve[Approved]
    changes[Request Changes]
    merge([Merge to Main])

    start --> lint --> test
    test --> review
    review -->|pass| approve --> merge
    review -->|fail| changes -.-> lint

步骤 3：通过 MCP 渲染图表

调用 Mermaid Chart MCP 执行渲染：

mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram
  prompt: "Workflow diagram of [scope/process]"
  mermaidCode: [generated syntax]
  diagramType: "flowchart"
  clientName: "claude-code"

若渲染失败，请修正语法后重试（最多重试 2 次）。

步骤 4：呈现结果

展示渲染后的图表，并用 2–3 句简要说明该工作流的关键阶段与决策点。