1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | archify |
| 项目自述名称 | Archify（README 标题大小写与正式名称略有差异，不作为名称使用） |
| 作者/维护者 | tt-a1i（个人开发者；基于 Cocoon-AI/architecture-diagram-generator v1.0 二次开发） |
| 来源链接 | https://github.com/tt-a1i/archify |
| 许可证 | MIT（GitHub API 与 SKILL.md 均确认） |
| GitHub Stars | 5,508（GitHub API 实测，2026-07-17；openagentskill.com 第三方目录交叉验证约 5.5K） |
| Forks | 358（GitHub API 实测） |
| 最新版本 | 2.11.0（取自 SKILL.md 版本号） |
| 安装方式 | npx skills add tt-a1i/archify -g（或手动解压仓库内 archify.zip） |
2. 功能介绍与亮点
- 把一段文字描述转换为 5 种专业技术图：架构图、工作流程图、时序图、数据流图、生命周期图，无需设计技能
- 输出为单文件自包含 HTML（内嵌 CSS/SVG/JS），内置明暗主题切换
- 一键复制 PNG 到剪贴板；支持 PNG/JPEG/WebP/SVG 导出，最高 4 倍分辨率
- 内置常见技术组件的语义化图标标签（如 postgres、aws.lambda）
- 附带 doctor / demo / render / validate / check / inspect 等命令行工具，便于自检与批量生成
- 主要亮点：上线约 3 个月即突破 5,500 star，MIT 完全开源、零外部网络依赖、近 24 小时内仍有提交
3. 适用场景
所属分类：数据分析与可视化
- 需要在技术文档、PR 描述、周报中快速插入架构图/流程图的工程师
- 需要为团队梳理系统全貌的技术负责人或架构师
- 需要绘制审批流程、CI/CD 流程或状态机图的 DevOps/SRE
- 撰写技术博客、培训材料需要配图的内容创作者
4. 跨 Agent 兼容性
- Claude Code：原生支持——README 明确列出
~/.claude/skills/安装路径 - Codex：原生支持——README 注明 “Tested with Claude Code, Codex CLI, and opencode”，并提供
--agent codex参数 - OpenClaw：未验证——README 中出现的 “opencode” 是另一款独立的开源编码 agent，与 OpenClaw 并非同一产品，不能作为兼容性证据
- Hermes Agent：未验证——官方材料未提及
5. 推荐理由
把文字描述秒变可编辑技术图，纯本地渲染、零外联、零密钥，上线约 3 个月即冲到 5,500+ star 的黑马技能。对经常要产出架构图/流程图的 Claude Code、Codex 用户而言，它省去了专业绘图软件的学习成本，且成果是可自由编辑的标准 HTML/SVG，不锁定在某个 SaaS 平台里。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 5,508 star（API 实测，第三方目录交叉验证），3 个月内快速增长 |
| 可用性 | 8 | MIT 开源、自包含 HTML 输出、独立文档站+中英文 README、近 1 天内仍有提交；项目历史约 3 个月，长期规模待观察 |
| 安全性 | 8 | 纯本地渲染无外联、无需 API Key、SKILL.md 全文审查未见可疑指令、Shell 执行范围明确可审计、License 清晰 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：
① Shell 命令与权限范围：有，但仅限本地 Node 脚本渲染/校验图表（doctor/demo/render/validate/check/inspect），无系统级或危险操作 ② 联网外发：无，SKILL.md 与脚本均未见网络请求或遥测 ③ API Key/凭据：不需要 ④ 可疑指令（prompt injection）：全文抓取 SKILL.md 未发现试图越权指挥助手行为的文字 ⑤ 作者信誉：个人开发者，基于知名度较低的上游项目二次开发，尚无长期履历可查，信誉中性 ⑥ License：MIT，清晰明确 ⑦ 最近维护：最近一次提交距本报告日期约 1 天，活跃
7. 跟同类 Skills 相比的优势
| 产品 | 定位 | Star 数 | 核心差异 |
|---|---|---|---|
| archify（本推荐） | 多类型技术图：架构/流程/时序/数据流/生命周期 | 5,508 | 5 种图类型 + 语义化组件库，零外联本地渲染，4 倍分辨率导出 |
| oh-my-mermaid | 代码库→架构图（基于 Mermaid） | 1,783 | 聚焦“代码库可视化”单一场景，依赖 Mermaid 语法表达能力 |
| 同类 draw.io 生成型技能（如 flowforge-skill 等） | 生成可编辑 draw.io 格式图 | 百级 | 产出为 draw.io 专有格式，需配合 draw.io 软件二次编辑；规模远小于 archify |
archify 在“文字生成技术图”这一细分赛道中 star 数与更新活跃度均明显领先，且是少数同时覆盖 5 种图类型、并以自包含 HTML（而非依赖第三方绘图软件专有格式）交付成果的方案。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价：openagentskill.com 等第三方技能目录的收录页显示“暂无 agent 运行数据”“暂无用户评论”；Reddit、Twitter、Hacker News 等渠道也未见已发表的独立评价。可参考的客观采用信号是 3 个月内积累的 5,508 star（见第一章）。
9. 其他补充
项目是在 Cocoon-AI/architecture-diagram-generator（MIT，v1.0）基础上的二次开发与深度扩展，README 提供英文与中文两个版本，仓库内维护有 CHANGELOG.md 与 ROADMAP.md，迭代记录透明可查。
10. 安装使用方式
- 推荐（持久安装）：
npx skills add tt-a1i/archify -g - 临时试用（不写入本地）：
npx skills use tt-a1i/archify@archify --agent codex（--agent参数可替换为claude-code或opencode） - 手动安装：下载仓库内 archify.zip，解压到对应 agent 的 skills 目录（如
~/.claude/skills/或~/.agents/skills/） - 安装后无需重启，对话中用自然语言描述系统结构即可触发生成；首次使用建议执行
node bin/archify.mjs doctor自检环境
11. 注意事项
- 项目上线约 3 个月，历史较短，长期维护性与社区生态规模仍需观察
- 官方仅明确测试过 Claude Code、Codex CLI 与 opencode 三者，OpenClaw 与 Hermes Agent 的兼容性未经验证
- 复杂大型架构图的自动布局质量依赖输入描述的结构化程度，过于笼统的描述可能需要多轮调整才能得到理想效果
- 依赖 Node.js 运行环境执行渲染脚本，纯浏览器/纯 Web 环境需额外适配