archifycommit edf158c · v3.2SKILL.md · 架构调优

Archify 架构图

把需求、Mermaid 或代码库证据生成经过校验的独立 HTML 图表，涵盖架构、时序、ERD 等十种类型，也可做成一页式讲解页。

若用户同意开启主动模式，会向全局代理规则文件（如 ~/.claude/CLAUDE.md）写入一行配置。

npx skills add tt-a1i/archify --skill archify

权限: read-repo
write-files
shell
network
兼容工具: Claude Code, Codex, Cursor, OpenCode
GitHub: 92.2k
来源: 社区 · tt-a1i
状态: 扫描通过
许可证: Apache-2.0
分类: 架构调优
代码仓库: github.com/tt-a1i/archify/archify

核心规则

finalize 返回非零退出码就绝不算成功，必须按失败的检查项修复后重新运行。

执行阶段

阶段 01选择图表类型
根据问题在十种原生图表与讲解页之间选择，必要时用 guide 命令辅助判断。
阶段 02阅读规范与证据
读取对应 schema、示例和默认规则；针对真实代码库时追踪源码作为证据。
阶段 03编写候选文件
在 .archify/ 下的独立文件夹中直接写出完整的 candidate.json 或讲解页草稿。
阶段 04运行 finalize
一次运行校验、交付、严格检查和真实浏览器检查；失败则读取回执并修复后重跑。
阶段 05简短交付
以 HTML 链接开头，只补充影响阅读的说明，不罗列命令或检查清单。

权限说明（据 SKILL.md 整理）

能力	是否需要	说明
文件写入	部分需要	在工作目录的 .archify/ 子文件夹中写入候选文件和 HTML；用户同意时还会在全局规则文件中加一行开关。
命令执行	部分需要	运行 node bin/archify.mjs 的 finalize、guide、doctor 等子命令，其中包括真实浏览器检查。
网络外发	部分需要	finalize 会做有限的版本更新检查；仅在用户提供网址时抓取未知品牌图标，不会自动安装更新。

SKILL.md 头部信息（YAML）commit edf158c · v3.2

---
name: archify
description: "Create validated architecture, workflow, sequence, data-flow, lifecycle/state, ERD, class, tree, timeline, and waterfall diagrams as explorable standalone HTML with dark/light themes, motion and image/SVG/WebM export. Accept requirements or Mermaid; inspect repository evidence for code-backed diagrams. Use when visualizing systems, API calls, pipelines, schemas, histories, timings, or everyday steps, parts, relationships and states. Also turn an answer into a one-page explainer, with the conclusion first, structured panels, native diagrams and charts, when the user asks for a page, an explainer or an answer to share (做成一页, 用页面讲), or proactively when the user's rules opt in with an [archify explainer: ...] line. Not for dashboards."
license: Apache-2.0
metadata:
  version: "3.2"
  author: tt-a1i
---

核心规则

执行阶段

阶段 01选择图表类型

阶段 02阅读规范与证据

阶段 03编写候选文件

阶段 04运行 finalize

阶段 05简短交付

权限说明（据 SKILL.md 整理）

SKILL.md 头部信息（YAML）

相关技能