跳到正文

Haonan S004 HLD

编写或审查多端 AI 系统 HLD,完成需求交接、系统边界、C4、ADR、Agent 分工、上下文缓存、生命周期、运行时治理、通信、容灾与安全设计。

个人 Skill产品研发4 个文件浏览次数 0
开始使用

下载前阅读 SKILL.md 中的使用条件,并确认所用工具支持对应能力。

输入资料
在开始编写架构文档之前,你必须作为主导者确保输入材料的完整性和准确性。当用户输入需求或 PRD 时,绝不能直接开始写文档,必须先执行以下前置评估并向用户进行确认: 意图对齐与防“懒汉外包”:深入分析用户提供的 PRD,提炼核心业务闭环。拒绝含糊不清的“由 AI 自行判断”需求,必须界定明确的 API 边界与物理执行路径。 多端触点与基建分析 (Multi-Client Topologies):梳理涉及几个端(如高并发 App、长连接 P… 阅读本节完整说明
交付内容
保留以下三阶段及全部八节设计。已有完整授权时连续完成,各阶段执行检查并报告进度;仅未解决的关键架构决策需要用户确认。 第零阶段 (Phase 0 - 准备与对齐):接收输入后,先输出简短的《需求交接与可行性评估简报》(含:核心理解、触点分析、爆炸半径评估、技术雷区)。输出后暂停并询问:“请问上述系统边界划分与技术风险评估是否准确?是否还有遗漏的隐性约束?确认后我将正式开始输出 HLD 核心架构蓝图。” 第一阶段 (Phase 1 - 蓝… 阅读本节完整说明
  1. 获取完整包,保留配套文件的目录结构。
  2. 按照原文准备所需工具、依赖与输入资料。
  3. 阅读对应使用步骤与输入输出说明,在自己的环境中验证结果。

使用提示摘自原文,配套文件保留来源版本;实际运行条件以各包说明为准。

正文

获取原文件

references/architecture-workflow.md

保留完整需求。选择架构由项目约束决定,不默认微服务、Kubernetes、BFF、多 Agent 或自部署模型。存在需要取舍的关键选择时比较成立的方案并记录 ADR,不为固定数量编造候选。

设计要求

  1. 定义系统内外范围、角色、外部系统、信任边界和组件责任。
  2. 将 FR/NFR 映射到组件及完整业务流程;需求中缺少实现的部分维持待实现状态。
  3. 对关键对象、配置和事件说明产出方、存储、使用方、读取或触发时机、版本、失效和业务终态。
  4. 明确同步调用、异步任务、事务边界、数据所有权、重复处理、失败恢复和状态可见性。
  5. 配置管理、业务执行与审计记录分别设计;有配置页面或记录表不能证明存在执行能力。
  6. 定义权限、数据分类、保留、加密、租户隔离和审计要求,注明依据与适用环境。
  7. 描述本地、测试、生产的源码、构建、配置、数据和秘密流向,持久数据与临时测试环境分别管理。
  8. 明确 SLO、容量、RTO/RPO、成本变量、超时和有依据的恢复策略。失败保持可观察,不能用替代结果伪装成功。
  9. 外部服务及模型按实际接入方式设计:API 服务记录供应商与接口边界,本地部署补制品、引擎和资源要求。

版本和平台能力有变化风险时查当前官方资料;推导和测量分别标注。详见 架构检查。

验证与交接

设计中每个组件均能关联需求,每个关键产出有使用方或合法终态。适用实验以实际命令和测量证明,不能将设计吞吐、成本或合规目标写为当前事实。

向 S005 各分支提供组件边界、所有权、接口类别、配置与事件关联、身份要求、NFR 和风险。向 S007/S009 提供业务流程验收点,交给 S006 检查范围完整性和跨模块一致性。多阶段状态遵循 交付记录。

Haonan S004 HLD · 原理图

查看原图
Haonan S004 HLD 原理图

CONTACT HAONAN

联系haonan

医疗 AI · 产品与独立开发

刘浩南

关注医疗 AI 从 demo 到真实落地,聚焦产品化、商业化与院内工作流效率提升。

12年医疗产研经验,大湾区头部医疗AI公司前产品总监,独立开发者

医疗 AI 产品化医疗 AI 商业化院内工作流效率
刘浩南的微信联系二维码
微信扫一扫,联系 haonan