跳到正文

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-checklist.md

架构驱动力

  • FR/NFR、规模、延迟、可用性、数据敏感度、团队能力、预算和期限都有来源。
  • 未知值使用范围、公式或测量计划,不用臆测的生产数字。

边界与接口

  • 系统范围、外部参与者、信任边界和数据所有权清晰。
  • 同步接口、事件、批任务和人工流程职责不重叠。
  • 外部依赖包含认证、超时、重试、幂等、限流、降级和审计。
  • 配置、事件和关键对象的产出方、使用方、版本、生效时机及业务终态明确。
  • 架构目标保留批准需求,代码现状不足时继续记录未实现能力。

数据与安全

  • 数据分类、最小化、加密、保留、删除、备份和租户隔离有要求。
  • AI 输入/输出、RAG 数据、工具调用和人工审批在信任流中可见。
  • 威胁模型、合规映射和残余风险有负责人,不宣称未经认证的合规。

可靠性与运营

  • 关键链路有 SLO/SLI、容量假设、RTO/RPO、故障域和降级顺序。
  • 可观测性覆盖日志、指标、追踪、成本和 AI 质量信号。
  • 部署、迁移、兼容、灰度、回滚和灾备具备可执行验证点。

ADR 最小字段

ADR-ID,context,decision,options,tradeoffs,consequences,validation,status,owner

状态建议:PROPOSED、ACCEPTED、SUPERSEDED、REJECTED。

详细设计交接

每项架构决定引用 决策记录,明确影响的 FR/NFR、接口或组件、接收设计技能及验证条件。ADR 生命周期与决定确认状态分别使用其原有字段;接受架构方案不能代替运行验证。

依照 设计维护责任 指定数据、后端、Agent 和前端规范的维护位置。共同字段或状态存在不同版本时,查证当前批准依据,更新实际受影响设计与任务,不能让后续执行者自行猜测采用哪个版本。

Haonan S004 HLD · 原理图

查看原图
Haonan S004 HLD 原理图

CONTACT HAONAN

联系haonan

医疗 AI · 产品与独立开发

刘浩南

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

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

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