Archify：把代码库或系统描述转换成可交互架构图的 Agent 技能

核心能力与快速开始

★ 62168 · JavaScript

能做什么

作为 Agent 技能，让 Agent 生成有类型 JSON IR，并由 Node.js 渲染与校验系统确定性地编译成自包含 HTML/SVG。支持架构、工作流、时序、数据流、生命周期五类图，四种视觉预设、明暗主题和内置品牌标识。提供架构快照的 Before / Delta / After 对比，可查看新增、删除、变更、移动等变更事实。支持节点搜索、上下游可达性追踪、精确路径探查、角色对比和引导式故事播放。导出 PNG、SVG、WebM 以及 1200×630 分享卡片，并可选择性打开经 Git 校验的源码行范围证据。预览与交付流程包含 schema、布局、HTML/SVG、路径和标签-路径避让等原子校验，失败时给出机器可读的修复提示。

适用场景

在 Agent 对话中把代码库或系统描述转为系统架构图、工作流图、时序图、数据流图或生命周期图；在合并前对比架构快照，审查新增、删除、移动和改线的结构变化；为 README、发布说明或社交分享生成 1200×630 分享卡片；播放由作者定义的引导式故事并追踪上游/下游关系；需源码证据时打开 Git 校验的文件和行范围。

项目形态

可直接使用的工具

部署方式

以 Agent 技能形式通过 npx skills add tt-a1i/archify -g 安装；支持 Cursor、Claude Code、Codex CLI、OpenCode，Raven 可通过手动解压 archify.zip 至 ~/.raven/workspace/skills 安装；DSH 社区需插件方式接入。可通过零依赖 CLI 运行 doctor、demo、guide、validate、preview、deliver 等命令；preview 为仅回环的桌面模式。

主要依赖

Node.js 环境。不强制需要代码仓库，可直接在任意 Agent 对话中描述系统；支持 Cursor、Claude Code、Codex CLI、OpenCode 等 Agent 环境。

使用限制

官方说明 Archify 不是通用绘图编辑器，也不是 Mermaid 主题，定位是把技术意图转为沟通产物；架构的 deployment-ownership 配置在缺少指定信息时会失败关闭，且不检查实时基础设施；架构 Delta 不推断影响、风险或合并安全性；可达性追踪不声称运行时影响；未说明硬件和 API 成本限制。

许可证

MIT

最近推送

2026-09-15 00:15

资料检查：2026-09-15 07:00 · 卡片整理：2026-09-15 07:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容

职业应用

程序员

程序员可将代码库或系统描述转换为架构、工作流、时序、数据流和生命周期五类可交互系统图，用于代码审查、架构变更对比和排错时理解系统结构。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证

产品经理

产品经理可用系统描述生成架构、工作流、时序、数据流和生命周期图，用于需求分析、原型沟通和向团队展示系统结构。

官方使用入口 ↗

由 AI 根据来源材料整理，未进行安装或运行验证