登录 注册
AI 应用与 AI Agent网络与基础设施开发者工具 agent-skillsarchitecturearchitecture-diagramasyncapibpmnc4-model
10,710
Stars
732
Forks
23
Watchers
0
Open Issues
MIT
许可证
Python
语言
2026-03-03
创建时间
2026-11-10
最近更新

项目能做什么

将自然语言、代码、Terraform/K8s、SQL 及多种 API 转为可编辑 draw.io 架构图的 Agent skill
来源:AI 基于仓库事实生成 · 内容以仓库实际 README 为准

使用说明 查看原始 README 原仓库文档

中文使用说明暂未生成。下面保留原仓库 README 摘录,命令与配置均以原文为准。
原始 README 摘录(英文原文,节选前 3000 字符)
# drawio-skill — From Text to Professional Diagrams

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/Agents365-ai/drawio-skill?style=flat&logo=github)](https://github.com/Agents365-ai/drawio-skill/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/Agents365-ai/drawio-skill?style=flat&logo=github)](https://github.com/Agents365-ai/drawio-skill/network/members)
[![Latest Release](https://img.shields.io/github/v/release/Agents365-ai/drawio-skill?logo=github)](https://github.com/Agents365-ai/drawio-skill/releases/latest)
[![Last Commit](https://img.shields.io/github/last-commit/Agents365-ai/drawio-skill?logo=github)](https://github.com/Agents365-ai/drawio-skill/commits/main)

[![SkillsMP](https://img.shields.io/badge/SkillsMP-listed-1f6feb)](https://skillsmp.com/skills/agents365-ai-drawio-skill-skills-drawio-skill-skill-md)
[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-2ea44f)](https://agentskills.io)

**English** · [中文](README_CN.md) · [日本語](README_JA.md) · [📖 Online Docs](https://agents365-ai.github.io/drawio-skill/)

A skill that turns natural language and real system sources into maintainable `.drawio` architecture models. Beyond generation and export, it incrementally synchronizes without discarding manual layout, projects multiple views from one model, enforces architecture contracts, queries dependencies, simulates failure propagation, and publishes dependency-free interactive walkthroughs. Works with **Claude Code, Cursor, Copilot, OpenClaw, Codex, Autohand Code, Hermes**, and any agent compatible with the [Agent Skills](https://agentskills.io) format.

<p align="center">
  <img src="assets/hero-demo.gif" width="900" alt="Hero demo: Terraform source becomes an architecture diagram with official icons; the v2 change renders as an updated diagram">
</p>

## ✨ Highlights

**From a prompt**

- **Describe it, get an editable `.drawio`** — the skill plans the layout, writes the XML, exports, then self-checks its own PNG and auto-fixes overlaps, clipped labels, and stacked edges (up to 2 rounds), with up to 5 rounds of your feedback
- **Mermaid → native .drawio** (draw.io ≥ 30) — author 28 standard types as Mermaid text (**mindmap, gantt, timeline, journey, pie, sankey, kanban**…) and the CLI converts them into a laid-out, editable `.drawio`: structure in, layout free
- **Whiteboard photo / screenshot → editable diagram** — snap a legacy PNG or a physical whiteboard, let vision extract the graph, and `raster2drawio.py` rebuilds it as a real, editable `.drawio` honouring the original layout
- **11 diagram type presets** — ERD, UML Class, Sequence, C4, Architecture, ML/Deep Learning, Flowchart, SysML, BPMN, Network Topology, Cross-Functional Swimlane

**From real sources**

- **Visualize a codebase** — import graphs for Python / JS-TS / Go / Rust and Python class hierarchies, with Graphviz placement, transitive reduction, and nes
阅读完整原文

商业机会分析 AI 生成

架构防漂移与合规检测 GitHub/GitLab Action(CI/CD商业插件)

产品构想基于项目的 drift diff 和 CI architecture tests 特性,将其封装为开箱即用的 CI 质检与文档自动化机器人,在 PR 中对比架构变更并拦截违规架构改动。
核心功能PR 架构自动对比(Diff View)、架构约束规则校验(如禁止跨层直接调用)、自动更新并提交最新 draw.io/SVG 图表至仓库或 Confluence。
目标用户重视架构合规的中大型研发团队、SRE团队、DevOps工程师。
难度/周期中等 · 3-5周 · 成本:极低(极少云资源,主要是 Action 封装及自动化测试环境成本)
收费模式Freemium 模式:开源基础 PR 注释功能,高级架构合规规则引擎、跨多仓库架构依赖分析按仓库/席位收取月费。
竞争风险复杂大仓的代码/配置静态解析准确率存在边界;依赖用户 CI 运行开销。
依据 已验证事实(README提及drift diff及CI architecture tests特性)与数据支持的判断

托管式 Architecture MCP Server(面向 AI 编程客户端的付费增值服务)

产品构想作为标准 MCP (Model Context Protocol) 插件服务,为 Claude Code、Cursor 等桌面 AI 客户端提供高可用、免配置的架构生成与反向工程后端引擎。
核心功能自然语言一键转专业 draw.io/C4 模型、支持白板图片反栅格化为可编辑矢量节点、多源统一导入(OpenAPI/Terraform/Protobuf)、交互式 PPTX/HTML 导出。
目标用户高频使用 AI Agent 编写代码与方案的独立开发者、技术总监、咨询顾问。
难度/周期低至中等 · 2-4周 · 成本:低(轻量 API 代理网关与少许格式转换算力)
收费模式订阅制(Pro 订阅每月 9-19 美元,提供高频图片矢量化解析、专有云端渲染与高保真模板库)。
竞争风险开源版本直接本地运行即可满足极客用户,商业托管需要提供显著的性能、模板或多端同步差异化优势。
依据 数据支持的判断(主题包含 mcp-server 与 claude-code,部署特征显示为轻量纯Python服务)

手绘/旧图一键转 draw.io 矢量架构图 Web 应用(垂直生产力工具)

产品构想将 whiteboard derasterize(白板反栅格化)和 image-to-diagram 特性单独包装为无需配置编程环境的 Web 端工具,专攻图片/截图转可编辑矢量图场景。
核心功能图片拖拽上传识别(支持拍照白板、低分辨率截图)、自动转为标准 draw.io XML/C4 模型/Mermaid、一键在线编辑与导出 PPTX。
目标用户售前架构师、产品经理、技术文档撰写者、外包咨询顾问。
难度/周期低 · 1-3周 · 成本:低至中等(主要是调用视觉多模态大模型的 API 成本)
收费模式按量额度包或单次付费(Token 包)/ 月度订阅(如 $15/月无限次转换与导出)。
竞争风险手绘图和复杂连线的识别还原率依赖多模态大模型表现,边缘复杂图可能需要较多人工修正。
依据 AI推测(基于主题中 whiteboard derasterize 与 image-to-diagram 关键词分析出的非开发者向外溢需求)
AI 基于仓库公开数据分析生成,含推测成分,不构成收益承诺。
报告会保存到 个人中心

竞品与相似项目 GitHub Search 真实检索

项目中文简介Stars语言
morluto/rea 中文介绍暂未生成
Reverse engineer anything with agents, from app behavior dow
449,702 TypeScript
mattpocock/skills 中文介绍暂未生成
Skills for Real Engineers. Straight from my .agents director
320,798 Shell
obra/superpowers 中文介绍暂未生成
An agentic skills framework & software development methodolo
315,702 Shell
affaan-m/ECC 中文介绍暂未生成
The agent harness performance optimization system. Skills, i
300,734 JavaScript
anthropics/skills 中文介绍暂未生成
Public repository for Agent Skills
192,193 Python
DietrichGebert/ponytail 中文介绍暂未生成
Makes your AI agent think like the laziest senior dev in the
188,334 JavaScript
以上为通过 GitHub 官方 Search API 检索的相似项目,功能差异与优劣势需进一步人工确认,配置 AI 后可生成对比分析。

项目优势与风险

技术成熟度创建于 2026-03-03,近 30 天仍在推送,发布过 47 个 Release
社区活跃Star 10,710 / Fork 732 / Issue 0(数据支持,可自行核实)
许可证MIT
主要风险上游项目方向可能变化;同赛道竞争者较多(见竞品表);热度与需求不完全等价

安装与使用

快速开始(以仓库 README 为准)
git clone https://github.com/Agents365-ai/drawio-skill.git
cd drawio-skill
# 请阅读仓库 README 获取确切安装步骤(依赖、配置、启动命令)
阅读原仓库文档
术语说明:Docker=应用容器(把程序和依赖打包运行);API Key=调用外部服务的密钥;Git Clone=把仓库代码下载到本地。常见错误:API Key 未配置 / 端口占用 / 数据库连接失败,多数项目在 README 的 Troubleshooting 章节有说明。