先问题,后图表

先选对问题,
再得到对的图。

描述受众真正需要理解的内容。Archify 会推荐一个有边界的视觉配方,同时给出证据清单、禁用条件和可复制提示词。

12个真实场景
配方
5种类型化
图表模式
0个运行时
依赖

这张图必须解释什么?

写清场景,不要只写图表类型。系统事实越具体,推荐越可靠。

⌘ / Ctrl + Enter
配方库

12 个小而专的起点。

每个配方只回答一个技术问题。清晰的边界让图更易读、可评审,也不会掩盖证据缺口。

阅读完整配方

一个问题,一份明确的证据边界。

这些配方直接来自当前构建的 CLI 源码。通过源码和成品链接,可以检查每条推荐的具体含义。

architecture · classic

系统总览

系统里有什么、归谁负责、彼此如何连接?

用一张有边界的图展示核心组件、外部依赖、主路径和信任边界。

适用场景
适合新人上手、方案评审、仓库梳理和服务全景说明。
不适用场景
如果重点是精确调用顺序、状态流转或字段级血缘,请换其他配方。

必须包含的证据

  • 8–12 个核心组件
  • 一条主路径
  • 外部依赖
  • 归属或信任边界

可直接复制的提示词

分析这个仓库,然后用 Archify 生成高层系统架构图。展示 8–12 个核心运行时组件、一条主要请求或数据路径、外部依赖、归属或信任边界;支持性细节放进卡片,不要继续堆连线。

architecture · blueprint

部署与归属

每个工作负载运行在哪里,哪些连接跨越了边界?

围绕 Region、网络、集群、工作负载、存储和跨边界机制组织部署图。

适用场景
适合云上评审、生产就绪、多区域规划和基础设施交接。
不适用场景
部署事实不清楚,或真正问题是应用行为而不是资源位置时不要使用。

必须包含的证据

  • 区域与网络
  • 工作负载归属
  • 有状态服务
  • 明确的跨边界机制

可直接复制的提示词

用 Archify 绘制生产部署拓扑。按区域、网络、集群和负责人分组,展示工作负载与有状态服务,并标注每一种跨边界机制。不要编造部署事实,不确定的区域要明确标出。如果用户需要失败即阻断的部署评审,先征得确认,再把 meta.engineering_profile 设为 deployment-ownership;否则不要启用工程画像。

workflow · signal-flow

智能体工具调用

智能体如何规划、获批、执行、恢复并汇报?

用泳道表达策略门、工具执行、异常恢复、证据和最终回复。

适用场景
适合解释 Agent Runtime、MCP/工具编排、审批、重试和可观测性。
不适用场景
如果只想看静态组件,或重点是精确 API 消息时序,请换其他配方。

必须包含的证据

  • 请求与规划
  • 策略或审批门
  • 工具执行
  • 异常与证据路径

可直接复制的提示词

用 Archify 工作流模式解释这段智能体工具调用。把用户界面、Agent Runtime、策略边界、异常处理、工具执行和可观测性分成泳道;突出成功主路径,并明确展示审批、重试、阻塞和证据路径。

workflow · classic

研发交付流程

一次变更如何安全地从提交走到生产?

展示构建、检查、环境、审批、冒烟、回滚和负责人泳道。

适用场景
适合 CI/CD 设计、发布评审、部署治理和研发新人上手。
不适用场景
如果重点是基础设施位置或部署对象的状态集合,请换架构图或生命周期图。

必须包含的证据

  • 触发与构建
  • 阻断检查
  • 审批与环境
  • 回滚与验证

可直接复制的提示词

用 Archify 工作流模式绘制从代码提交到生产发布的流程。拆分开发者、CI、审批、环境和异常泳道;标出阻断检查、冒烟测试、负责人和回滚路径,并保留一条一眼可见的成功主路径。

workflow · signal-flow

事故处置 Runbook

响应者如何发现、分诊、缓解、验证并升级?

把信号、响应者、缓解动作、沟通和恢复证据拆成可执行流程。

适用场景
适合故障预案、On-call 交接、稳定性评审和桌面演练。
不适用场景
如果受众需要实时指标仪表盘或事故后的组件拓扑,而不是响应动作,请换其他视图。

必须包含的证据

  • 发现信号
  • 分诊负责人
  • 缓解与回滚
  • 恢复验证与沟通

可直接复制的提示词

用 Archify 工作流模式把事故处置预案画成响应者泳道。展示发现、分诊、缓解、升级、沟通、回滚和恢复验证;把决策门与操作分开,并让缺失的负责人清晰可见。

sequence · classic

API 请求链

谁调用谁、顺序如何、最终返回什么?

按时间展示鉴权、缓存回退、持久化、返回流量和异步追踪。

适用场景
适合 API 文档、请求耗时排查、鉴权评审和缓存回退说明。
不适用场景
如果顺序不重要,受众只需要稳定的服务拓扑,请用架构图。

必须包含的证据

  • 调用方与被调用方
  • 请求与返回消息
  • 回退或错误路径
  • 异步副作用

可直接复制的提示词

用 Archify 时序模式展示从调用方到最终响应的完整请求。包含鉴权、缓存命中或未命中、持久化回退、返回消息,以及异步 Trace 或事件上报;消息标签保持简短,顺序必须明确。

sequence · signal-flow

异步往返链路

初始请求返回之后,后台还会发生什么?

按时间展示入队、确认、后台处理、回调、重试、超时和最终一致。

适用场景
适合 Webhook、后台任务、队列、支付回调、最终一致和异步 API 契约。
不适用场景
如果重点是 Topic 拓扑和消费者归属,而不是时间顺序,请用事件数据流配方。

必须包含的证据

  • 初始确认
  • 队列或调度器
  • 后台处理
  • 回调、重试与超时

可直接复制的提示词

用 Archify 时序模式解释这段异步往返链路。展示初始确认、入队或调度、后台处理、回调或轮询、重试与超时,以及调用方何时能观察到最终一致结果。

dataflow · classic

数据血缘

数据从哪里来、如何变化、最终被谁消费?

从来源经过同意、转换、敏感存储、数仓直到消费者的治理路径。

适用场景
适合分析架构、ETL/ELT 评审、PII 评估、数仓设计和特征血缘。
不适用场景
如果受众需要请求时序或操作负责人,而不是数据资产,请换其他配方。

必须包含的证据

  • 数据来源与资产
  • 转换阶段
  • 分类或同意边界
  • 存储与消费者

可直接复制的提示词

用 Archify 数据流模式梳理这段数据血缘。为每个数据资产和转换命名,展示用户同意或数据分类边界,区分流式与批处理路径,并标明存储和下游消费者;所有数据流都必须有标签。

dataflow · signal-flow

事件流拓扑

哪些事件经过哪些 Topic、处理器、消费者组和失败路径?

展示生产者、Topic、有序处理器、消费者组、状态、重放和 DLQ。

适用场景
适合 Kafka/事件平台设计、流处理评审、归属、重放和失败处理。
不适用场景
如果 Topic、消费者组和投递语义都不清楚,请先用通用工作流,不要编造事件拓扑。

必须包含的证据

  • 生产者与事件名
  • Topic 与顺序
  • 处理器与消费者组
  • 状态、重放与 DLQ

可直接复制的提示词

用 Archify 数据流模式绘制这段事件流拓扑。命名生产者、事件、Topic、有序处理器、消费者组、状态存储、重放路径和 DLQ;只有在证据充分时才标注归属和投递语义。

lifecycle · classic

对象生命周期

有哪些状态、什么事件触发流转、最终如何结束?

展示执行、等待、重试、取消、失败以及明确终态的状态模型。

适用场景
适合任务、订单、工单、订阅、作业、Agent Run 等带持久状态的对象。
不适用场景
对象没有持久状态,真正问题是参与者随时间的交互时,请使用时序图。

必须包含的证据

  • 开始与执行态
  • 带事件的转换
  • 等待与重试态
  • 所有终态

可直接复制的提示词

用 Archify 生命周期模式建模这个对象。分开主进度、等待或中断状态和终态;用事件标注转换,并在真实存在时展示重试、取消、超时、成功和失败,不能隐藏任何结束方式。

lifecycle · signal-flow

部署生命周期

一次发布当前处于什么状态,下一步可能发生什么?

覆盖排队、构建、验证、审批、晋级、回滚和终态的部署状态模型。

适用场景
适合发布控制器、GitOps 对账、环境晋级和部署状态 API。
不适用场景
如果重点是人员与 CI 的交付动作顺序,而不是部署对象状态,请用交付工作流。

必须包含的证据

  • 排队与执行态
  • 验证与审批
  • 晋级与回滚
  • 成功、失败与取消

可直接复制的提示词

用 Archify 生命周期模式建模部署对象。展示排队、构建、验证、等待审批、晋级、回滚以及所有终态,并标注允许每次状态转换的事件和守卫条件。

architecture · classic

布局修复

现有图为什么仍然溢出、重叠或连线穿过节点,应该先修什么?

保留现有图表模式,依据验证诊断、途经点语义和实测桌面视口预算修复布局。

适用场景
已有架构图、工作流、时序图、数据流或生命周期图需要修复布局;保留原来的图表类型和表现设置。
不适用场景
任务是为新图选择类型时不要使用。不要为了通过检查改变拓扑、删除有意义的标签或隐藏溢出。

必须包含的证据

  • 修复顺序:schema → 重叠 → 方向 → 交叉 → 标签
  • via 契约:绝对 [x, y] 中间点;路径 = [start, ...via, end]
  • 包含标题和必要卡片的整页桌面视口预算
  • 每次修改后 validate,最终在浏览器中检查 HTML

可直接复制的提示词

用 Archify 修复这张现有图,保留图表类型、拓扑、有意义的标签和表现设置。遵循 references/authoring-contract.md 的顺序:(1) schema 错误及缺失或无效的 meta.quality_profile;(2) 节点重叠或越界;(3) 连线穿过节点及端点方向错误;(4) 交叉、含混的共享通道、贴边走线、过度绕行和转弯节奏;(5) 标签与节点、标签与标签、标签与连线的间距。每次修改后运行 validate,依据 diagnostics[] 的 code、subject、evidence 和 supportedFixes,每次只应用一项有诊断依据的几何控制。当前 schema 支持 via 时,它是按顺序排列的绝对 SVG [x, y] 中间点数组:路径为 [start, ...via, end],起终点由节点锚点提供。显式 via 会覆盖自动路由,不是偏移量,也不会请求自动绕障。修复正交走线时,相邻点应共享 x 或 y,首尾线段应遵守 fromSide/toSide;只使用当前模式支持的控制字段。视口预算遵循 references/delivery-contract.md:检查 1440×900、1600×1000、1920×1080 和 2048×1320,要求 document.documentElement.scrollWidth <= window.innerWidth。优先满足 document.documentElement.scrollHeight <= window.innerHeight;如果 browser-check 明确确认 Reader 已达到投影文字下限并接受可读的页面纵向滚动,则保留该滚动。预算覆盖整页,包括标题、主图和必要卡片。其他溢出先通过移除冗余内容或压缩间距修复,不得靠隐藏溢出、裁切、内部滚动区、拉伸 SVG 或缩小字体强行通过。让 finalize 执行必需的浏览器证据;只在用户要求或 delivery contract 规定的升级条件下进行感知视觉审阅。