技能介绍

解决什么问题

工程师画架构图通常有两种妥协：在绘图工具里拖半小时贴贴，得到一张改不了的静态截图；或者写 Mermaid，得到的拓扑能用但样式千篇一律。Archify 补上第三条路：用一小段类型化 JSON 描述系统拓扑，直接产出一个自包含、可交互的 HTML 文件。图的语义来自你的规范，而不是某个渲染器的默认审美。

核心能力

五种图类型，各有语义约束：architecture（组件与边界）、workflow（流程与审批）、sequence（调用链与返回）、dataflow（管线与血缘）、lifecycle（状态迁移）。类型路由决定了 schema、示例和布局规则。
创作优先：按问题确定类型后，只需阅读一份匹配的 schema 和一份示例 JSON，立刻写候选规范——先产出工件，再谈校验，不要在散文里规划精确坐标。
可验证的交付：候选规范先过 9 项 artifact checks（showcase 要求 0 composition errors、0 warnings）；deliver 会把规范字节冻结成同目录快照、原子提交 HTML，并报告 SHA-256 与字节数。
交付后取证：visual-check 在 1440×900、1600×1000、1920×1080、2048×1320 四档检查 containment，采集明暗截图并生成 contact sheet。recipe 里的 pending 是诚实状态——截图供人检查，不宣称自动打磨。

适用边界

默认静态：只有用户明确要 demo 或 presentation 时才启用动效；meta.visual_preset、meta.subtitle、meta.engineering_profile 默认都省略——色彩模式与视觉预设相互独立，切深色不会换预设。
结构纪律：一条清晰的主路径、短侧枝、稀疏标签、最多 12 个主节点。先删除低价值边，再考虑 via、channelX/Y、labelAt 等几何控制；每次修复最多应用一处诊断出的控制项。
修复轮次有限制：只派已诊断的对象；supportedFixes 只从已验证的候选项中选；非零退出永远不算成功，连续两轮没有改善就停止并如实报告未解决的 diagnostics。
Mermaid 输入：把 Mermaid 当作拓扑语义的来源而不是样式模板——stateDiagram 进入 lifecycle，保留状态与迁移的含义，丢弃 Mermaid 视觉风格。
语言与命名：图内所有面向读者的字符串跟随用户语言；产品名、API path、命令、环境名保持原样。Emoji 只允许 ✅。环境要求 node >= 18，运行时只用 Node 内置模块，无需 npm install。