Archify 架构可视化技能
把代码库和系统描述转换成可验证、可分享的交互式架构与流程图。
技能说明
Archify 支持 Raven、Cursor、Claude Code、Codex CLI 和 OpenCode。它用 typed JSON IR 生成架构、工作流、时序、数据流和生命周期图，经过校验后输出独立 HTML、PNG、SVG、WebM 等格式；需要时才引用固定提交的公开源码。MIT 许可。注意：分享前应检查图中是否包含内部系统结构、接口或敏感路径。
关于此技能
把代码库或系统描述转换成可探索、可分享的架构、工作流、时序、数据流和生命周期图，并在交付前用确定性规则校验结果。
核心能力
多种技术图
支持 architecture、workflow、sequence、dataflow 和 lifecycle 五种图类型，适合系统、接口、流水线和状态机。
可验证交付
用 typed JSON IR、schema 和布局检查生成自包含 HTML，并导出 PNG、SVG、WebM 等格式。
基于证据的理解
需要时可打开固定提交中的公开源码和行号，追溯节点与关系；默认不假设真实运行影响。
适用场景
接手陌生代码库
让 Agent 先梳理组件、服务、存储和主要调用路径，快速形成可讨论的技术地图。
评审架构变更
比较 Before、Delta、After 快照，查看新增、删除、变更、移动和重新路由的事实。
制作技术分享材料
把经过校验的系统图导出为独立 HTML、PNG 或 SVG，用于文档、评审和演示。
使用步骤
- 01
第一步：安装
运行 npx skills add tt-a1i/archify -g；Cursor、Codex、Claude Code 和 OpenCode 也有对应安装位置。
- 02
第二步：限定范围
告诉 Agent 要画的图类型、核心节点、主路径、外部依赖和信任边界，先从不超过 12 个主节点开始。
- 03
第三步：校验
运行 node bin/archify.mjs validate ... --quality showcase --json，先修复诊断中指出的具体问题。
- 04
第四步：交付与复核
用 deliver 生成最终 HTML，再检查是否包含内部架构、接口或敏感路径；分享前先做脱敏。
常见问题
支持哪些 Agent？+
README 明确列出 Raven、Cursor、Claude Code、Codex CLI 和 OpenCode；也提供 Claude.ai 上传 ZIP 的方式。
它会读取真实线上基础设施吗？+
不会默认读取线上环境。需要源码证据时，它只打开指定公开提交中的文件和行号；生成的关系仍应按项目事实复核。
生成结果安全吗？+
仓库使用 MIT 许可，预览模式只绑定本机回环地址且无遥测说明；但独立 HTML 可能暴露内部系统结构，公开前必须检查内容。
npx skills add tt-a1i/archify -g