写好一篇技术方案到底应该怎么做?

简介: 本模板用于规范产品需求文档,涵盖项目背景、功能模块、流程图、UML图及时序图设计,支持变更记录追溯与多格式资料关联,提升产研协作效率。

变更记录
记录每次修订的内容,方便追溯。
表格视图
项目背景
对本次项目的背景以及目标进行描述,方便开发者理解需求,对齐上下文。
知识库基础能力的升级,解决以下问题:
目录与文档管理分布在不同的页面,用户无法区分两者区别。
目录拖拽体验不够流畅,交互细节体验不佳。
相关资料
PRD、设计稿等相关资料,可以通过插入“语雀内容”卡片快速引入关联的语雀文档
也可以通过“本地文件”、“附件”上传其他资料。

📑 产品需求文档
变更记录记录每次修订的内容,方便追溯。版本号作者修订内容发布日期1.1...去除需求 1.0,增加需求 3.02022-01-301.0...发布 prd 1.0 需求宣讲2021-12-311. 背景介绍1.1 业务背景对本次项目的背景以及目标进行描述,让产研团队了解本需求的价值和收益。1....
官方模板(新)
参与人
项目负责人
...
产品经理
...
设计师
...
工程师
...
功能模块
通过插入“思维图”卡片、“表格”卡片,描述本项目涉及到的功能与场景。
子功能二
子功能一
功能二
子功能三
场景二
场景一
子功能一
子功能二
功能一
产品功能
流程图
通过“流程图”卡片对系统流程进行梳理。
成员
决策者
项目经理
开始
提出想法

验证可行性
项目方案
风险评估



审批
通过
方案设计
审批

通过
项目预算

项目计划

结束
不通过
不通过

UML 图
通过“UML 图”卡片可以绘制类图、组件图等系统架构图,梳理系统架构。
<>
Shape

draw()
erase()
move()
resize()
<>
Circle
radius:float
center:unsigned int
area(in radius:float) + circum()
setCenter()
setRadius()

<>
Retangle

<>
Point

<>
Frame
<>
Window
open()
close()
move()
display()
handleEvent()
<>
Event
<>
ConsoleWindow
<>
DialogBox
<>
DataController

<>
DrawingContext
open()
close()
move()
display()
handleEvent()
Note







时序图
通过“UML 图”卡片可以绘制时序图来梳理系统调用时序。




alt
: Search Page
: Search Results Page
: Customer
: Catalog
: Search Results


1: onSearch(author)
1.1: validateSearchCriteria()

1.2 : searchByAuthor(author)

1.2.1: create()


1.2.1.1 : display()
1.3: displayErrorMessage()


[author not entered]
数据库设计
API 设计
可以借鉴华为API:

查询产品_产品管理API应用侧API参考API参考设备接入 IoTDA-华为云
获取单篇文档
Plain Text
复制代码
1
GET /docs/:id?raw=0
请求参数
参数
类型
描述
id
Integer
文档 id
raw
Boolean
raw=1 返回文档最原始的格式
响应格式

{
"data": {
"id": 100,
"title": "标题",
"description": "描述",
"body": "文档正文内容",
"body_draft": "文档草稿内容",
"status": 0
}
}
排期
通过“日历卡片”或者“思维图”卡片的时间轴视图,对研发时间计划进行排期。

发布阶段
更新帮助文档
全量发布
12.15
灰度引流
12.10
编写帮助手册
内部验收
11.30
整体提测
11.15
服务端提测
10.30
服务端系分
前端系分
10.15
里程碑
前后端联调

需要完成自测

相关文章
|
SQL 关系型数据库 数据管理
Datahub实践——Sqllineage解析Sql实现端到端数据血缘
Datahub实践——Sqllineage解析Sql实现端到端数据血缘
4045 1
|
10月前
|
人工智能 Kubernetes Cloud Native
Higress(云原生AI网关) 架构学习指南
Higress 架构学习指南 🚀写在前面: 嘿,欢迎你来到 Higress 的学习之旅!
3682 1
|
5月前
|
人工智能 弹性计算 JavaScript
养“虾”进阶指南:OpenClaw多Agent+飞书bot实战+阿里云/本地部署+百炼API配置+避坑大全
对于新手来说,最友好的落地路径是:阿里云部署保障7×24小时稳定运行,飞书Bot实现多Agent消息分流,阿里云百炼Coding Plan免费API提供智能支撑。本文基于OpenClaw v2026.02.09最新稳定版,整合全流程资源:详解新手零基础阿里云部署步骤、百炼Coding Plan免费API配置、多Agent飞书绑定实战,补充高频避坑指南,所有代码可直接复制执行,助力新手快速搭建专属AI协作团队,从“单Agent打杂”升级为“多Agent协同作战”。
2427 2
|
5月前
|
人工智能 监控 API
保姆级教程:1分钟阿里云/本地部署OpenClaw+blogwatcher打造智能资讯系统(百炼Coding Plan配置+精准推送)
“信息过载不是问题,问题是你没有一个系统去过滤它。” 2026年,AI工具的爆发让优质内容呈指数级增长,但也让更多人陷入“刷不完、漏关键”的困境——技术博客的重要更新、行业动态的核心资讯、产品发布的关键细节,往往藏在海量信息流中,要么被错过,要么花费大量时间筛选。
1123 5
|
1月前
|
JSON 人工智能 数据可视化
Claude Code 四大定制机制完全指南:CLAUDE.md、Hooks、Skills、Subagents 怎么选怎么用
本文详解Claude Code四大定制机制:CLAUDE.md(持久记忆)、Hooks(硬约束执行)、Skills(按需流程)、Subagents(隔离分工),涵盖配置模板、选型决策表及团队工程化分层实践,全部基于2026年7月2日官方文档。
987 1
|
2月前
|
存储 人工智能 测试技术
Hermes Agent:深度技术剖析报告
Hermes Agent 是Nous Research于2026年开源的自主AI智能体框架,首创“闭环学习回路”,通过五层记忆系统、自主技能生成(Skill)、辩证式用户建模(Honcho)与FTS5跨会话搜索,解决LLM“失忆症”。MIT许可,Python构建,支持多平台、多模型Provider及MCP双向集成,GitHub星标超1.7万。
1053 1
|
5月前
|
人工智能 机器人 BI
3 步搞定!在飞书批量创建小龙虾对话框,每个对话框各司其职、自动执行不同任务。保姆级教程,一看就会!
本文详解如何用飞书+OpenClaw高效管理“小龙虾”AI助手:通过创建专属飞书群、添加角色化Agent(如“内容高手”)、绑定群ID三步,实现任务隔离与精准响应。无需编程基础,1小时即可完成配置,提升执行准确率与响应速度。
|
人工智能 JSON 自然语言处理
我终于成为了全栈开发,各种AI工具加持的全过程记录
本文从一个需求出发,全程记录如何进行全栈开发。
3196 51
我终于成为了全栈开发,各种AI工具加持的全过程记录
|
8月前
|
前端开发 API 数据库
如何写好一篇技术方案
本文档为项目需求说明模板,涵盖背景目标、功能模块、流程图、UML设计、API与数据库设计等内容,支持表格、思维导图、时序图等多种视图,便于团队协作与排期管理,提升产研效率。
|
8月前
|
机器学习/深度学习 人工智能 自然语言处理
NeurIPS 2025 | Code Graph Model (CGM):图融合架构重塑代码大模型,探索AI代码研发新范式
代码图模型(CGM)通过专用适配器将仓库代码图集成到LLM的注意力机制中,在 SWE-Bench Lite 基准上实现了44.00%的问题解决率,相比先前开源方法提升了12.33%
1099 9