archify Skill 技能
在 AI 编程助手中用自然语言生成精美架构图的 Agent Skill
archify 是一款专为 AI 编程助手设计的开源 Agent Skill,能够根据自然语言描述或代码仓库结构,自动生成可交互、可分享的专业技术图。
用户只需在 Cursor、Claude Code、Codex CLI 或 OpenCode 中安装 Skill,然后输入一条描述性指令,例如「分析这个代码库并生成运行时架构图」,archify 就会自动解析代码结构,生成包含组件、服务、数据库、缓存、外部依赖和安全边界的可视化图表。整个过程完全在聊天窗口内完成,无需切换工具或手动绘制。
生成的图以独立的 HTML 文件输出,支持深色/浅色主题一键切换、节点搜索、路径探索和引导式演示。导出方面支持复制 PNG 到剪贴板,或下载最高 4 倍分辨率的 PNG/JPEG/WebP 图片,以及双主题自包含 SVG 文件,可直接嵌入 GitHub README 并自动跟随读者系统主题。
archify 提供五种图表类型:架构图(Architecture)用于展示系统组件和云资源拓扑;工作流图(Workflow)适合 CI/CD 流水线、审批流和工具调用链;时序图(Sequence)清晰呈现 API 调用顺序和缓存穿透路径;数据流图(Data Flow)追踪数据从源到存储再到消费者的完整生命周期;状态机图(Lifecycle)则展示订单、任务、部署和 Agent Run 的状态转换与终态。
与其他架构图工具相比,archify 的核心差异在于质量验证管道:AI 模型生成结构化的 JSON IR 描述,再由确定性渲染器负责布局和绘制,最后自动运行模式、布局、HTML 和 SVG 检查,确保输出图表的结构一致性和可读性。这条管道避免了传统方案中 AI 直接生成 SVG 坐标导致的随机性质量问题。
安装方式极为简单,运行一条命令即可全局安装:npx skills add tt-a1i/archify -g
支持的 AI 编程助手包括 Cursor、Claude Code、Codex CLI、OpenCode 和 Raven。该项目基于 MIT 协议开源,代码完全透明可审计。
评论与建议
登录 后参与评论或提建议