Archify 是一款面向 AI 编程助手(Raven、Cursor、Claude Code 等)的代理技能,可将代码库或系统描述转换为可交互的系统架构图。它支持五种技术图表类型、四种视觉预设、明暗主题及可选动画,提供验证驱动的生成工作流、架构变更对比审查、可追溯的节点交互,并输出自包含的 HTML、PNG、SVG 等格式。

- 核心定位: Archify 不是通用绘图工具,而是将技术意图转化为沟通产物的代理技能,强调布局判断优于通用自动布局,所有交互基于作者声明的节点关系而非虚构拓扑。
- 图表类型: 支持架构图(组件与边界)、工作流(CI/CD 与审批)、序列图(API 调用与时序)、数据流(管道与敏感边界)、生命周期(状态与重试)五种模式,各有明确的适用场景和提示词建议。
- 生成工作流: 四步闭环——生成(代理创建类型化 JSON IR)、验证(模式与布局规则检查)、预览(可选的本地桌面循环,仅验证通过后刷新)、交付(原子替换输出文件),失败时返回机器可读的诊断与修复建议。
- 交互与导出: 支持节点聚焦、上下游可达性追溯、精确路径探测、语义角色对比、引导式故事播放;可导出 1200×630 分享卡片、PNG、SVG、WebM,支持深链接恢复特定视图状态。
- 技术特性: 类型化 JSON 中间表示、确定性渲染、原子验证、可选源码证据(Git 验证的文件与行范围)、尊重
prefers-reduced-motion 的有限动画,以及显式的标准/展示级质量配置。
- 项目背景: 为 Cocoon-AI/architecture-diagram-generator v1.0 的分支重写,保留原始视觉语言,新增主题、导出、验证、交互及统一 CLI,采用 MIT 许可证。