产品实现与执行
技术方案与架构拆解
描述
通过高层架构划分、核心流程映射、数据与接口设计及技术风险分析,判断需求的技术可行性与实现路径,并为开发拆解与排期提供技术依据。
Cursor / Claude Code 指令
在 https://www.zangwei.dev/prompts/product-execution/technical-solution-architecture-design-prompt 有一个提示词指南。请提取并遵循该提示词来创建文件 /docs/handbook/product/{version|feature}/tech.md提示词内容
你是一名资深技术负责人 / 架构师, 为当前版本设计【技术方案与架构拆解】。 【核心定位】 - 本文档的目标不是设计“最优或最复杂的架构” - 而是回答: 1)这个 PRD 是否在当前技术条件下可实现? 2)如何用最小复杂度、可控风险实现? 3)关键技术风险在哪里,如何兜底? - 本文档是 PRD → 开发实现之间的技术决策文档 【前置条件】 - 已有清晰 PRD(功能、交互、逻辑、验收标准) - 已明确产品边界与 MVP 范围 - 技术方案只需覆盖当前版本,不为“未来可能”过度设计 【总体要求】 - 优先选择简单、成熟、可控的方案 - 明确取舍理由,而不是“看起来更高级” - 架构必须支持当前成功判据,而不是假想规模 - 若存在无法接受的技术风险,必须明确指出 --- 【技术方案输出结构】 一、目标与约束 - 本次技术方案支持的 PRD 范围 - 关键非功能性要求(性能、稳定性、安全、合规) - 明确的技术约束(时间、人力、已有系统、预算) 二、总体架构设计(High-Level Architecture) - 系统整体架构概览(可文字描述或模块图说明) - 核心模块及其职责划分 - 模块之间的数据流与调用关系 - 哪些模块是: - 核心路径 - 支撑模块 - 可替换模块 三、核心流程与关键技术点 - 关键业务流程对应的技术实现路径 - 同步 / 异步策略 - 状态管理方式 - 数据一致性与失败处理思路 - 对 PRD 中关键交互与逻辑的技术映射说明 四、数据设计与存储策略 - 核心数据对象与关系 - 数据存储选型(数据库 / 缓存 / 对象存储等) - 数据生命周期与关键约束 - 隐私与安全相关的数据处理策略 五、接口与集成方案 - 内部模块接口设计原则 - 外部依赖或第三方服务(如 API、模型、支付、登录) - 接口稳定性与降级策略 - Mock / Stub / 替代方案(用于开发或兜底) 六、技术风险与应对方案 - 当前版本的主要技术风险点 - 风险发生的可能性与影响范围 - 应对或规避方案(降级、限制、替代、延后) - 哪些风险是可接受的,哪些是不可接受的 七、可扩展性与技术债控制 - 当前方案在短期内的可扩展方式 - 明确哪些地方是“有意留下的技术债” - 后续版本可能的演进方向(不做详细设计) 八、与执行计划的对齐 - 技术方案如何被拆解为可开发任务 - 哪些部分可并行,哪些存在依赖 - 对排期与资源的关键影响 --- 【输出要求】 - 不写具体代码实现 - 不陷入过度细节或未来设计 - 架构说明应能被研发团队理解并据此实现 - 若 PRD 中某需求在技术上不可行或风险过高,必须明确指出并给出建议 请在最后用 3–5 条要点总结: “这个技术方案是否在当前阶段足够简单、可行且风险可控?”