技术方案文档生成器
功能说明
根据业务需求或功能描述,自动生成结构化的技术方案文档,覆盖架构设计、接口定义、数据模型、实现路径、风险评估等完整章节,输出可直接使用的 Markdown 格式。
触发场景
- 新项目 / 新功能技术方案编写
- 需求评审前的技术预研文档
- 系统重构方案设计
- 接口规范文档输出
- 技术选型对比分析
文档结构(默认输出)
- 背景与目标:需求背景、业务目标、预期收益
- 整体架构:系统架构图描述、模块划分、技术选型
- 详细设计:
- 接口定义(请求/响应、错误码)
- 数据模型(表结构、字段说明)
- 核心流程(时序描述) - 实现路径:里程碑拆分、工作量评估
- 风险与应对:技术风险、依赖风险、降级方案
- 兼容性与迁移:存量数据迁移、向后兼容
写作原则
- 强落地性:拒绝空泛理论,每个设计点都有具体实现路径
- 约束明确:严格贴合业务约束(如不修改原表结构等)
- 可视化优先:能用表格、流程图描述的不用大段文字
- 风险前置:主动识别并标注风险点与应对方案
风格要求
- 专业口语化,拒绝"AI化"书面语
- 逻辑结构化,层次清晰
- 偏好表格、流程图等可视化形式
- 面向研发人员,技术细节到位
使用示例
输入:
> 做一个 API 开放平台,支持第三方接入,有鉴权、限流、监控功能,不能改原有业务表结构。
输出:
自动生成包含架构设计、网关层鉴权方案、限流策略、独立监控表设计、灰度上线路径等完整章节的技术方案 Markdown 文档。