S

软件架构图生成器

開発v1.0.0
作者:u_2ae8369e✓ 認証済み公開者:昆明秀派科技有限公司更新日 2026-11-05software-architecture-diagram-generator-showapi@showapi/software-architecture-diagram-generator-showapi
コード生成

AlphaMoatによると、2026-10時点で软件架构图生成器のダウンロード数は99,504、スター数は2で、累計ダウンロード数で今回のランキング対象AIスキル10,914件中250位、開発では1,069件中17位です。

一覧の初期表示は累計ダウンロード数順で、スター数順にも並べ替えできます。詳細ページの順位は累計ダウンロード数で計算しています。

ダウンロード数
10万
スター数
2
累計ダウンロード順位
#250
全体の上位 3% · 開発の上位 2%
プラットフォームダウンロード数スター数コメント
SkillHub ↗10万2—

プラットフォームごとに集計方法と集計時点が異なります。

このスキルでできること

通过输入软件说明书或文本,自动深度解析架构意图,结构化抽取组件与层级,生成Mermaid架构代码,进行专业评审与补全,融合输出完整架构设计文档,并渲染高清架构图。适用于软件工程文档编写、架构评审、技术方案输出等场景。

月次の推移

ダウンロード数10万
4.2万7.3万10.4万2026-09 · ダウンロード数 4.6万2026-10 · ダウンロード数 10万26-0926-10
スター数2
1222026-09 · スター数 12026-10 · スター数 226-0926-10
月ダウンロード数前月比スター数
2026-1010万—2
2026-094.6万—1

SKILL.md 原文

作者が公開した元のファイルをテキストのまま表示しています。AlphaMoat による編集や審査はしていません。リンクはクリックできません。コマンドは内容を確認してから実行してください。取得日 2026-11-20。

7.7 KB・SkillHub v1.0.0
---
name: 软件架构图生成器
description: 通过输入软件说明书或软著文本,自动深度解析架构意图,结构化抽取组件与层级,生成Mermaid架构代码,进行专业评审与补全,融合输出完整架构设计文档,并渲染高清架构图。适用于软件工程文档编写、架构评审、技术方案输出等场景。
dependency:
  python: []
---

# 软件架构图生成器

## 任务目标
すべて表示(全 150 行)
- 自动解析软件说明书或软著文本,提取系统架构层级与组件关系
- 生成标准 Mermaid 架构图代码,并渲染输出高清架构图
- 结合专业架构评审模型,输出包含概览、详设、分析与优化建议的完整架构设计文档
- 触发场景:编写软件设计文档、申请软著、技术方案评审、系统重构分析

## 能力组成

### 能力流程描述
该技能以软件说明书或软著文本作为输入,经过以下五个核心阶段串行处理,最终产出图文并茂的架构设计文档:
1. **意图深度解析**:分析输入文本,识别软件的核心架构风格(如 B/S 架构、微服务、前后端分离等)。
2. **结构化抽取**:基于识别的架构风格,从文本中抽取系统层级(如表现层、业务逻辑层、数据访问层)及核心组件。
3. **Mermaid 代码生成**:根据抽取的层级与组件依赖关系,自动生成符合 Mermaid 语法的架构图源代码。
4. **专业评审与建议**:模拟架构师视角对抽取的结构进行评审,生成架构分析报告及高可用、可扩展等方面的优化建议。
5. **文档融合与图像渲染**:将分析报告、优化建议、Mermaid 代码融合为完整设计文档,同时调用图像渲染服务将 Mermaid 代码转化为高清架构图,通过异步轮询获取图片地址。

### 技能能力组成流程图
![技能能力组成流程图](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a266a533c51f2ea2500211c/snapshot/flow_chart/54d08860c1.jpg?t=1783304251)

## 前置准备
- 凭证:配置 ShowAPI AppKey,凭证名称:showapi_appkey
  - **获取方式**:访问 [https://www.showapi.com](https://www.showapi.com) 注册账号(注册即送2元可用余额。),登录后进入 [https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp) 获取 appKey
- 依赖:仅使用 Python 标准库,无需安装第三方包

## 操作步骤
### 标准流程(强制异步执行)
1. **收集用户需求**
   梳理用户提供的软件说明书、需求文档或软著文本,确认生成架构图的宽高比(选填,默认 16:9)。

2. **异步提交生成任务**
   调用脚本异步执行架构解析、文档生成与图像渲染任务,**仅返回唯一 task_id**,不阻塞等待。
   调用示例:
   ```bash
   python scripts/execute_task.py --raw-text "本软件为一款基于B/S架构的电商订单管理系统..." --aspect-ratio 16:9 --async
   ```

3. **轮询查询任务结果(必选)**
   使用 task_id 循环查询任务状态,**每一轮轮询后,即时将当前返回的核心资料同步反馈给用户**,直至获取完整结果。
   调用示例:
   ```bash
   python scripts/query_task.py --task-id "返回的task_id值"
   ```
4. 等待结果完成
   必须轮询直到完成。

5. **结果解析与落地应用**
   提取生成的高清架构图 URL、Mermaid 源代码以及结构化的架构设计文档。可直接应用于技术方案汇报或研发协同。

6. 生成html页面
   生成一个简单的html页面来融合返回的主要信息,特别是图片。

## 使用示例
### 示例1:电商系统架构图生成
- 输入:输入一段关于电商订单管理系统的软件说明书全文
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:B/S架构高清图 + Mermaid代码 + 包含模块职责与优化建议的完整文档
- 配置要点:aspect_ratio 设置为 16:9 适合文档排版

### 示例2:微服务架构设计辅助
- 输入:描述某 SaaS 平台的微服务划分与数据流向文本
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:微服务组件关系图 + 服务解耦度分析报告
- 配置要点:raw_text 需尽量包含完整的模块与交互描述

### 示例3:软著申报材料快速生成
- 输入:软著申请中的系统功能描述文本
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:符合软著技术材料要求的架构图及说明文档
- 配置要点:可配合 aspect_ratio 为 1:1 生成正方形架构图适配表格

## 生成效果示例
### 描述
技能运行后,将输出一张高清的软件架构图、对应的 Mermaid 源代码,以及一份结构化的架构设计文档。文档包含架构概览、详细设计、架构分析与优化计划四个核心模块。架构图直观展示系统层级与组件间的调用关系,可直接嵌入到 Word 或 Markdown 文档中。

### 输出案例
> 说明:若输出结果包含图片,**优先插入对应图片资源**,之后再输出 JSON / Markdown 格式的文本内容。

![生成效果示例1](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a266a533c51f2ea2500211c/snapshot/caseImgs/609a676607.png?t=1781237730)
![生成效果示例2](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a266a533c51f2ea2500211c/snapshot/caseImgs/add75a2b2d.png?t=1781237731)
![生成效果示例3](https://oss.showapi.com/workflow/6a13a91c9e64f2c7637a7564/6a266a533c51f2ea2500211c/snapshot/caseImgs/45155f4f79.png?t=1781237732)

```json
{
  "showapi_res_body": {
    "architecture_diagram_url": "https://oss.showapi.com/.../generated_architecture.png",
    "mermaid_code": "graph TD\n  A[表现层] --> B[业务逻辑层]\n  B --> C[数据访问层]",
    "final_document": {
      "overview": "本系统采用 B/S 架构与前后端分离设计...",
      "detailed_design": "1. 用户中心模块:...\n2. 商品管理模块:...",
      "analysis_section": "系统整体职责清晰,低耦合高内聚,但在高并发场景下需关注数据库事务...",
      "optimization_plan": "建议引入分布式缓存与消息队列解耦订单处理流程...",
      "architecture_diagram_code": "graph TD\n  A[表现层] --> B[业务逻辑层]\n  B --> C[数据访问层]"
    }
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

## 资源索引
- [scripts/execute_task.py](scripts/execute_task.py):异步提交架构图及文档生成任务
- [scripts/query_task.py](scripts/query_task.py):轮询查询异步任务结果

## 响应数据结构
### 1. 异步任务提交响应
```json
{
  "showapi_res_body": {
    "task_id": "唯一任务ID",
    "status": "pending",
    "msg": "任务已提交,正在异步处理中"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

### 2. 任务查询响应(单轮轮询返回数据,需实时同步给用户)
```json
{
  "showapi_res_body": {
    "architecture_diagram_url": "生成的高清软件架构图访问地址",
    "mermaid_code": "生成的Mermaid架构图源代码",
    "final_document": {
      "overview": "架构概览",
      "detailed_design": "详细设计",
      "analysis_section": "架构分析",
      "optimization_plan": "优化计划",
      "architecture_diagram_code": "架构图代码"
    }
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}
```

## 注意事项
1. raw_text 为必填项,需尽可能完整地描述软件功能、架构模式与技术栈,以保证解析准确度。
2. 所有任务**强制异步执行**,不支持同步模式。
3. 轮询查询过程中,**每次获取接口返回数据后,立即将主要内容反馈给用户**。
4. 生成的架构图宽高比支持 1:1、3:4、4:3、16:9、9:16,默认为 16:9。

開発の人気スキル

编程大神.Skill開発

【全栈能力】编程大神.Skill:面向复杂真实项目的高阶全栈编程助手。不止生成代码,而是从一句目标接手陌生代码库,拆解需求、补齐实现、追到根因、完成重构、联调前后端,并把结果推进到能运行、能验证、能交付。覆盖 Web、后端、脚本、iOS、安卓、鸿蒙 ArkUI、微信小程序及其他技术栈,支持中英文工程、疑难 Bug、跨模块任务和长任务续做;用构建、日志、真实入口、设备或接口证据说明结果。仅问概念时直接回答,要求落地时持续推进到验收或明确阻塞。

↓ 1125.9万★ 82u_42bbb65f
编程专家Pro.Skill開発

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

↓ 626.9万★ 32user_47d655f0
编程专家.Skill開発

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

↓ 600.7万★ 378user_741dc82b
dev-expert開発

编程专家.Skill P8级编程助手,25年实战经验技能Skill,全栈:Java/Php网站/软件项目、API设计、Bug诊断、代码生成、代码审查、重构、测试用例、性能基准、技术选型、文档生成、任务拆解、Spec驱动、Karpathy规范、CMS二次开发、前端设计、MySQL/Mariadb、项目知识图谱,以及工程纪律层(根因调试硬闭环、阶段导航、事故复盘/SLO、威胁建模/供应链安全、生产就绪/渐进式发布、AI编码治理、面向Agent代码可读性、LLM应用安全)。支持 @标识 显式调用跳过路由。

↓ 528.1万★ 32user_814dbe54
dev-expert-pro開発

工程专题、鸿蒙与微信小程序开发的集成派生版

↓ 104.7万★ -user_814dbe54
编程专家 Pro開発

编程专家 Pro:融合编程专家 2.0.3 工程专题与编程大神的鸿蒙 ArkTS/ArkUI、微信小程序和小游戏开发资料。用于项目实现、根因调试、审查、重构、测试、架构性能分析及多端开发验证。支持自然语言和 @专题标识,按任务读取包内知识;只问概念时直接回答。

↓ 98.2万★ 1user_28275a78
编程专家.Skill開発

适用场景:全栈编程助手。接到需求先读现有代码和约束,再动手:Java/PHP 开发、接口设计、缺陷定位、代码评审、重构、测试用例、性能排查、技术选型与文档产出,也做 CMS 二次开发、前端页面和 MySQL 调优。每次改动先给方案和影响范围,改完必须跑验证,交付附交接说明。适合要把代码真正跑通、而不是只要片段的场景。写完代码常要配套的造价、法律、工程文档,站内已有现成技能,用「查找技能」按需求找即可。

↓ 70.1万★ 6user_613b33ea
Github開発

gh コマンドラインで GitHub の PR チェック、ワークフロー実行、API 照会を扱うスキルです。

↓ 48万★ 714Peter Steinberger

データ月:2026-10 · ダウンロード数とスター数は公開スキルレジストリ(ClawHub、SkillHub)から月単位で集計しています。詳しくはデータの方法論をご覧ください。