Archify 技术架构绘图技能
把系统与流程需求变成可交互、可导出的技术图。
源文件显示技能主要生成本地 HTML/SVG，并明确说明无依赖、导出和本地存储行为，未见恶意外传、凭据窃取或破坏性默认设置；但未明确用户确认、敏感数据处理、权限边界、回滚机制或依赖来源审计，且安装命令依赖外部 npx，因此扣除。
文档提供 doctor、demo、render、validate、check 流程，且 CI 声称覆盖 Node 20/22、归档包冒烟测试和无效输入校验；但本次仅静态阅读，未执行，且未提供测试文件内容或完整异常行为证据，因此按静态评估保守计分。
名称、受众、图表类型、触发短语、输入格式和输出格式描述清晰，并声明 Mermaid 边界、非通用绘图编辑器定位及 CJK 文本测量；但中文文档支持有限，仍依赖 Node、现代浏览器和部分浏览器能力，环境兼容性与非适用边界证据不完整。
具备结构化安装、使用、参考、示例、限制、版本、CHANGELOG/ROADMAP、MIT 许可证、原项目归属和贡献说明；但维护责任人、稳定更新渠道和版本一致性仍主要依赖仓库流程，且仅提供单个技能源文件作为审查对象，因此扣分。
目标是将自然语言或 Mermaid 结构转换为可直接打开和导出的单文件 HTML，文档给出多种模式、示例和导出格式，核心价值明确；但没有静态可核验的实际产物质量或独立使用结果，输出可能仍需人工布局复核，因此未超过静态上限并扣分。
CI 配置、版本信息、示例路径、验证命令和归档新鲜度检查提供了有限的可审计证据；但本次未执行，缺少测试套件正文、第三方运行结果和多来源交叉验证，因此未达到更高等级。
- 本次仅审阅提供的静态文件，未执行 CLI、测试或浏览器导出；不能确认声称的渲染、验证和多格式导出在目标环境中均可用。
- 使用外部 npx 安装和可能的 Google Fonts 网络加载前，应确认网络、供应链和组织策略；离线环境需依赖本地字体与已打包文件。
- 涉及真实系统、PII 或安全边界时，生成的图表应由用户人工核对，不应把技能输出视为事实或安全审计结果。
这个 Skill 能做什么，适合哪些场景？
Archify 是一个面向 Claude、Codex CLI 和 opencode 的 Agent Skill，可根据自然语言或 Mermaid 输入生成架构、工作流、时序、数据流和生命周期图。它输出单文件 HTML，支持深浅色主题、缩放、搜索、关系追踪以及 PNG、JPEG、WebP 和 SVG 导出。生成过程使用 typed JSON specification、JSON Schema 验证、布局检查和 HTML/SVG 产物检查。需要运行 CLI 时，使用 Node.js；Claude.ai 上传 ZIP 通常可用，但能力取决于沙箱是否允许 Node.js。
读取用户的系统、流程或 Mermaid 描述；必要时检查仓库证据；将内容编写为架构、workflow、sequence、dataflow 或 lifecycle 类型的 JSON 规格；通过 node bin/archify.mjs validate 执行 schema、布局和产物检查；通过 deliver 生成并提交单文件 HTML；在浏览器中提供主题切换、平移缩放、搜索、关系追踪和 PNG/JPEG/WebP/SVG 导出。
- 软件工程师需要根据真实仓库代码绘制运行时组件、外部依赖和信任边界时。
- 平台或基础设施团队需要展示云服务、网络拓扑、安全边界和数据库连接时。
- 开发团队需要解释 API 调用链、缓存未命中、异步追踪和返回路径时。
- 数据团队需要展示 ETL/ELT、PII 隔离、数据血缘和下游消费者时。
- DevOps 团队需要绘制 CI/CD、审批、回滚和事故响应流程时。
- 产品或工程团队需要说明任务、部署或 Agent 运行的状态转换、重试和终止状态时。
这个 Skill 有哪些优点和局限？
- 支持五类技术图，覆盖架构、工作流、时序、数据流和生命周期。
- 输出零运行时依赖的自包含 HTML，可直接分享并切换深浅色主题。
- 支持 PNG、JPEG、WebP、SVG 导出，以及剪贴板复制 PNG。
- 包含 schema、布局和 HTML/SVG 产物检查，便于在交付前发现问题。
- 可使用 React、PostgreSQL、AWS Lambda、Kafka 等语义技术标签辅助样式和布局。
- 生成和修复依赖 Agent 编写及迭代 JSON 规格；不是自动 Mermaid 解析器。
- 完整 CLI 工作流需要可运行 Node.js 和 shell/filesystem 访问。
- WebP 导出和图片剪贴板复制取决于浏览器能力。
- 源材料没有提供独立测试结果、平台覆盖矩阵或实际运行验证证据。
- Claude.ai 项目知识模式仅支持架构模式，不能执行代码。
如何安装这个 Skill？
全局安装可运行：npx skills add tt-a1i/archify -g。也可以临时使用：npx skills use tt-a1i/archify@archify --agent codex。Claude.ai 可上传 archify.zip 到 Settings → Capabilities → Skills；其他安装目录和 Claude Code、Codex CLI、opencode 的命令见仓库 README。
如何使用这个 Skill？
安装后直接向 Agent 提出具体请求，例如：Use archify to draw a sequence diagram: User opens a page, the frontend calls the API, the API verifies JWT, reads Redis, falls back to Postgres on cache miss, and returns JSON. 对真实仓库可使用：Analyze this repository, then use archify to create an architecture diagram of its runtime components, data flow, external dependencies, and trust boundaries. 生成候选 JSON 后运行 node bin/archify.mjs validate <type> <candidate.json> --quality showcase --json，最终用 deliver 生成 HTML。
这个 Skill 与同类方案有什么区别？
相较于 Mermaid，Archify 更强调 Claude 判断布局后的主题化、自包含 HTML、交互和图片/SVG 导出，并加入验证与产物检查；但 Mermaid 输入需要由 Agent 重新布局，仓库明确说明不提供自动 Mermaid 解析路线。