面向编程智能体的 Archify Skill · tt-a1i

它是什么，不是什么

你用自然语言描述一个系统，或让助手读取代码仓库，Archify 就让助手写出有类型的源数据、校验后交付一个 HTML 文件。上游列出十种图类型（架构、工作流、时序、数据流、生命周期、ERD、类图、树、时间线、瀑布图），另有一页式讲解页。产出是给人看的沟通材料。上游说明它不是通用画图编辑器，也不是 Mermaid 主题，托管分享不在其范围内。

会得到什么：一个 HTML 文件

One .html file

单文件、自包含：在浏览器中打开或发给别人，交互功能随文件一起带走。查看时无需安装 Archify。

Explore

聚焦节点、追踪上下游、查看两点之间的路径，或全屏演示。

Dark / light

在查看器中切换主题和视觉风格（快捷键 T 与 S）。

Export

Export 菜单可复制或下载 PNG、WebP、JPG 图片与分享卡片；PDF 通过浏览器打印生成。

用终端安装

以下命令依据提交 a4065941f12b 的上游 README 与 llms.txt（2026 年 10 月 31 日抓取）。AgentSkillsDir 尚未在任何助手中实测。

llms.txt 的第一步只列出包内容，不会安装任何东西。只有当列表里恰好有一个名为 archify 的技能时再继续：

然后为你的助手安装。各助手命令相同，只有 --agent 参数不同：

• Claude Code

  --agent claude-code
  npx -y skills@latest add https://archify.si --skill archify --agent claude-code --global --copy --yes复制

  安装到 ~/.claude/skills/（全局）或 .claude/skills/（项目）。

• Codex CLI

  --agent codex
  npx -y skills@latest add https://archify.si --skill archify --agent codex --global --copy --yes复制

  安装到 ~/.agents/skills/（全局）或 .agents/skills/（项目）。

• Cursor

  --agent cursor
  npx -y skills@latest add https://archify.si --skill archify --agent cursor --global --copy --yes复制

  README 为 Cursor 给出的正是这条命令；安装器会报告写入的目录。

• OpenCode

  --agent opencode
  npx -y skills@latest add https://archify.si --skill archify --agent opencode --global --copy --yes复制

  安装到 ~/.config/opencode/skills/、.opencode/skills/ 或 .agents/skills/。

• GitHub Copilot

  --agent github-copilot
  npx -y skills@latest add https://archify.si --skill archify --agent github-copilot --global --copy --yes复制

  llms.txt 列为可选 agent id，README 安装表未单列。

• 仅限当前项目：去掉 --global。一次装多个助手：重复 --agent。--copy 表示复制文件而不是建立符号链接。
• 如果安装器报告与 archify 目录中已有文件冲突，上游要求停下并保留这些文件，不要删除。

不安装先试用

你可能见过的简写

一些介绍文章会引用下面这条更短的 skills 命令。它不在上游 README 中，README 用的是上面从 archify.si 安装的命令。建议优先使用 README 命令；两者 AgentSkillsDir 都尚未实测。

npx skills add tt-a1i/archify -g

检查是否装好

上游的检查命令在安装器报告的目录中运行（全局安装通常位于助手已扫描的 skills/archify 目录；项目安装通常位于 .agents/skills/archify）：

最小流程

依据上游 README；AgentSkillsDir 尚未用它实际生成图表。

1. 为你的助手安装技能（发送上面的提示或运行命令），然后运行 doctor 检查。
2. 用自然语言描述一个系统，或打开代码仓库，请助手画出高层运行时架构图。
3. 在任意浏览器打开交付的单个 .html 文件；继续在对话中修改（如“加上 Redis”“高亮回滚路径”）。

README 的第一个示例提示：

Use Archify to diagram a web request: Browser calls the API,
the API checks Redis, and a cache miss queries PostgreSQL and fills the cache.

不需要代码仓库。若要有源码依据的架构图，打开仓库，请助手先分析，再画出包含 8–12 个核心组件的高层运行时架构图。

如何更新

Archify 不会自动安装更新。有新的稳定版时，较新的安装会在交付图表后附一条简短提醒和发布说明链接，并询问你是否需要帮忙更新；何时更新由你决定。上游也建议在 GitHub 选择 Watch → Custom → Releases 订阅发布通知。设置 ARCHIFY_UPDATE_CHECK_DISABLED=1 可关闭提醒检查。

选 Archify 还是 Graphify？

两者用途不同。Archify 给人一份可交互、可分享的架构 HTML；Graphify 把项目文件夹变成智能体通过 /graphify 查询的知识图谱。要给同事讲清一个系统，选 Archify；要让助手理解整个代码库，选 Graphify。

安装前

• 这是会给助手添加指令和 Node 命令行工具的第三方代码。安装前请先阅读 SKILL.md 和源代码。
• 收录不等于安全审查。AgentSkillsDir 没有审查过这些代码。
• 上游说明，名称相似的第三方在线服务和付费方案由各自提供方运营，不代表 Archify。

常见问题

相关

• 浏览目录中的全部 Claude 技能
• Graphify 技能：供智能体查询的知识图谱
• 阅读官方 llms.txt 安装步骤

更正与建议

发现内容过时，或想推荐一个技能？发送更正邮件。若要推荐资源，请提交供人工审核。