SuperAPI AI 工具集

archify

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

archify 是一个将带类型的 JSON 转换为独立 HTML 交互图表的智能体技能,输出内联 SVG,默认静态,仅在明确要求时开启动效。其网址为 https://www.skills.sh/syntax-syndicate/archify-agent-skill/archify。

用途与图类型:架构图用于展示组件、服务、云/安全边界和基础设施构成;工作流用于流程、审批门、工具调用、运维手册和 CI/CD;时序图用于 API 调用链、请求生命周期和异步轨迹;数据流用于管道、ETL/ELT、血缘与治理;生命周期用于状态迁移、重试与终态。场景不明确时可运行 node bin/archify.mjs guide "<scenario>" --json 判断。

使用方式:在 .archify/<type>-<slug>-<YYYYMMDD-HHMMSS>/ 目录中存放 candidate.json 与 <slug>.html,设置 meta.output 为对应 HTML 相对路径。生成后运行 node bin/archify.mjs finalize <type> <candidate.json> <output.html> --quality showcase --json;涉及代码库时可加 --repo-root <repo-root>。finalize 依次校验 showcase、deliver、严格检查与真实浏览器检查,首次通过即无需单独预校验。

需注意:非零退出即失败,须依据 stdout 或 summaryReceipt 修复对应关卡并重跑。finalize 与 deliver 的收据含更新提示,若 update.noticeRequired 为 true 应保留一行更新说明,但不得自行安装或更新。无 shell 环境时可手动将架构 SVG 放入 assets/template.html。

适用场景:适合需要可探索、可校验架构与流程图的开发与文档场景。限制:动画、Share Cards、深链等查看器能力为可选且需显式请求;视觉检查默认不执行,只有实际捕获证据后才能声称视觉质量。安装方式、收费与支持平台资料暂未提供。