安全扫描
OpenClaw
安全
high confidence该技能所请求的操作、无需安装/凭证及指令均与其声明的“从代码库生成 Mermaid 架构图”目的一致;未发现不匹配或无法解释的需求。
评估建议
该技能功能明确:运行代码库分析代理(默认读取项目根目录文件),将结构模型转为 Mermaid 语法,并发送至 MCP 渲染器。使用前请注意:1) 避免在含机密或敏感路径的仓库上运行;2) 尽量限定分析目录范围;3) 确认你信任渲染 MCP/提供商,因为结构数据及生成的 Mermaid 会被发送过去;4) 分享前审查输出。本技能无需凭证或安装。...详细分析 ▾
✓ 用途与能力
名称/描述(从代码库生成 Mermaid 架构图)与运行时指令一致:探索代码库、构建结构模型、生成 Mermaid 流程图语法并渲染。未请求额外二进制文件、凭证或无关资源。
ℹ 指令范围
指令将代码分析委托给“codebase-explorer”代理并调用 MCP 渲染器。这在生成图表范围内,但意味着代理会读取项目文件(默认项目根)并将结构模型/Mermaid 代码发送给渲染器。用户需知悉仓库结构(及任何路径或文件名)将被传输至渲染服务。
✓ 安装机制
无安装规范且无代码文件;技能仅为指令,因此本身不会下载或写入磁盘。
✓ 凭证需求
技能无需环境变量、凭证或配置路径,与声明目的相符。
✓ 持久化与权限
always 为 false,未请求特殊持久化或系统级变更。模型默认可自主调用技能,属平台默认而非本技能提升权限。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/10
- 首次发布“architecture-diagram”技能。 - 从代码库结构生成 Mermaid 架构图。 - 用于新人上手、PR 评审及可视化组件关系。 - 提供代码库探索、图表生成与渲染的工作流。 - 遵循节点分组与形状使用等图表清晰规范。
● 无害
安装命令
点击复制官方npx clawhub@latest install nm-cartograph-architecture-diagram
镜像加速npx clawhub@latest install nm-cartograph-architecture-diagram --registry https://cn.longxiaskill.com
技能文档
Night Market 技能 —— 移植自 claude-night-market/cartograph。如需完整的 agent、hooks 与 commands 体验,请安装 Claude Code 插件。
# 架构图
生成 Mermaid 流程图,展示代码库的高层级组件关系。
何时使用
- 可视化插件/模块之间的关联
- 新人上手时快速了解系统结构
- 为 PR 评审提供架构文档
- 回答“这个系统是如何拼装在一起的?”
工作流程
步骤 1:探索代码库
派遣 codebase explorer agent 分析范围:
`` Agent(cartograph:codebase-explorer) Prompt: Explore [scope] and return a structural model. Focus on packages, modules, and their relationships for an architecture diagram.
若未提供 scope,则使用项目根目录。步骤 2:生成 Mermaid 语法
将结构模型转换为 Mermaid 流程图。
架构图规则:
使用 flowchart TD(自上而下)表示层级系统
使用 flowchart LR(自左向右)表示管道/流式系统
- 按包将相关模块分组为 subgraph
- 用描述性边标签说明关系
- 节点上限 15–20 个(小模块可聚合)
- 用形状区分组件类型:
- [Rectangle] 表示模块/包
- ([Stadium]) 表示入口点/命令
- [(Database)] 表示数据存储
- {Diamond} 表示决策点 示例输出:
mermaid flowchart TD subgraph sanctum[Sanctum Plugin] commit[Commit Messages] pr[PR Preparation] workspace[Workspace Review] end subgraph leyline[Leyline Plugin] git[Git Platform] patterns[Error 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: "Architecture diagram of [scope]" mermaidCode: [generated syntax] diagramType: "flowchart" clientName: "claude-code" ``若渲染失败,根据报错修复 Mermaid 语法并重试(最多 2 次)。
步骤 4:展示结果
向用户展示渲染后的图,并用 2–3 句话简要说明其内容。