tt-a1i/archify
一个能把代码仓库描述变成可验证的可分享架构图的AI智能体技能
Archify是一款智能体技能,可以直接在对话中把代码库或系统描述转换成交互式系统地图。它安装在Cursor、Claude Code、Codex CLI、OpenCode等AI编程工具中,生成结果是一个可分享的独立HTML文件。在交付图表之前,它会先对描述内容做自动校验,确保地图不会凭空编造并不存在的连接。
它做什么
- 支持架构(Architecture)、工作流(Workflow)、序列(Sequence)、数据流(Data Flow)、生命周期(Lifecycle)五种图表类型,并提供深色/浅色主题和四种视觉预设。
- 把自然语言描述转换成带类型的JSON中间表示(IR),随后必须通过模式、布局、HTML/SVG及路径等一系列检查,才能用新结果替换上一个已验证的版本。
- 提供架构差异(Architecture Delta)功能,比较前后两个已验证快照,精确展示新增、删除、变更和移动的内容。
- 节点搜索、上游/下游追踪、路径探测、角色对比、引导式故事播放等交互都只复用图中已记录的真实关系,不会编造新的拓扑结构。
- 最终产物可导出为PNG、SVG、WebM及1200×630分享卡,全部打包在一个独立HTML文件中。
- 附带一个真实案例:对公开仓库mco-org/mco在提交9f1a1cf处进行追踪,并生成了对应的架构图。
为什么重要
开发者不必手绘图表,只需在对话中简单描述,就能获得经过验证的架构图,便于向团队说明复杂系统结构。前后对比功能也有助于代码审查或合并请求中清晰地发现结构性变化。
本仓库术语
- 智能体技能(Agent Skill) · 安装到AI编程助手中、用于执行特定任务的扩展功能
- JSON中间表示(IR) · 存储图表内容的结构化JSON格式,最终图像由此生成
- 独立HTML(self-contained HTML) · 不依赖外部文件、把所有图形和交互都装在一个文件里的网页文件
- 上游/下游追踪(upstream/downstream reach) · 以某个节点为基准,追踪与其前后相连的组件的功能
- 分享卡(share card) · 专为文档或社交媒体分享而设计的1200×630尺寸图片
仓库简介（英文）
Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.
在 GitHub 打开热门仓库
- bookorbit/bookorbit一个自建服务器的读书平台,在网页、Kobo、KOReader之间无缝续读
- ConardLi/garden-skills给Claude Code等AI编程助手装上现成技能包,涵盖设计、视频、生图和知识检索
- browser-use/browser-use让AI像人一样点击网页按钮、输入文字,自动帮你完成网上的各种任务
- K-Dense-AI/scientific-agent-skills把AI编程助手变成科研帮手的163份操作手册
- DietrichGebert/ponytail一套让AI编程助手先想清楚再动手写代码的规则
- liustack/modlens给DeepSeek这类只能读文字的AI装上一双眼睛：粘贴图片就能把内容变成结构化文字数据
- marin-community/marinMarin是一个把训练大语言模型全过程公开出来的开源研究平台
- TauricResearch/TradingAgents多个LLM智能体分别扮演分析师、研究员、交易员和风控经理,通过辩论共同决定股票交易