技术方案撰写之道:实用技巧与方法

简介: 本文探讨了如何撰写技术方案,强调了考虑方案的相关方、关键指标、目标受众和预期收益的重要性。文章提出了写作框架应清晰、表达生动、具有美感,并指出好的方案应实现共赢、系统规划和显著效益。写技术方案时,需明确问题、深入分析需求、设定合理目标、设立度量标准、专业设计方案、规划执行路径并有效项目管理,确保方案的成功实施和收益。

读到高飞老师的一篇技术方案怎样写的文档,发现自己做的还是有很多待完善的。

一、技术方案的难点

要考虑清楚以下几个点:

1、技术方案与谁相关

问题是谁带来的,解决谁的问题,谁来解 决问题,谁解决过该问题

2、关键指标是什么

北极星,指标体系,可度量

3、技术方案的观众是谁

不同阶段观众不同,立项,评审,推进, 结项

4、收益是什么,有影响力吗

成本、效率、质量是什么,保障项目收益达成,团队协作可控

二、写的方法

1、写的框架

用很好的形式将要点和思考的框架结合起来,并且思考框架的局限性,避免以下问题:

逻辑不足:内容堆砌,逻辑链条不清晰

文字生硬:表达冗长,概念复杂,理论性强

缺乏美感:少图表,无重点,阅读成本高

2、好的方案优点

合作共赢:方案上下游收益,建立口碑

规划系统:方案无遗漏,平衡阶段性投入

收益显著:效率提升 10x,成本下降 50%

三、怎样写

1、框架

解决什么问题,用什么方案,方案优势,方案的收益

2、深入分析需求

问题从哪里来 ,为什么现在做 ,痛点是什么 ,业务或者技术术语有哪些,案例有什么 ,问题从哪里来

3、合理的目标设定

目标方法 SMART :方案无遗漏,平衡阶段性投入

范围 :涉及什么业务,方案边界

行业差距 :内外对比,了解方案的行业位置

4、度量要点

北极星指标:牵引方案,校准进度,体现收益

指标体系设计

常见指标:复杂度、召回率、准确率、渗透率

5、方案设计要专业

清晰的架构大图:标准的工具、标准名称

数据基建:线上观测、收益统计

技术选型:社区成熟度、团队熟悉度、新技术比例

概要设计与详细设计:合理的抽象层级,逐级推进

评估投入:与人、时间、资源相关

稳定性:风险评估、方案准入,观测、灰度、回滚

6、执行路径

合理的任务拆解要有架构思维

任务拆解:设计与实施,保障有序协作

关键里程碑:对齐方法,设计、开发、提测、灰度、推全

协作范围:外部团队,不同职能,关键接口人

资源统计:投入有预期,事后能总结

7、做好项管

方案才开始,取得收益才是目标

一切围绕目标,从目标出发,围绕目标推进,对齐目标总结,要保证文档系统的及时性、沟通纪要、进度总结

目录
相关文章
|
存储 Java 程序员
如何写好技术文档——来自Google十多年的文档经验
如何写好技术文档——来自Google十多年的文档经验
443 1
如何写好技术文档——来自Google十多年的文档经验
|
JavaScript 搜索推荐 前端开发
软件工程师文档写作最佳实践
软件工程师文档写作最佳实践
137 1
软件工程师文档写作最佳实践
|
敏捷开发 运维 监控
技术分享 | 想测试入门就必须要懂的软件开发流程
技术分享 | 想测试入门就必须要懂的软件开发流程
|
敏捷开发 运维 监控
技术分享 | 想测试入门就必须要懂的软件开发流程
从事软件测试行业,每天面对的被测对象都是软件。如果想要更好的去完成测试工作,首先需要对被测对象,也就是对软件要有基本的了解。 ## 软件 与计算机系统操作有关的计算机程序、可能有的文件、文档及数据。 程序好理解,就是可以操作的产品。比如 wps、微信、QQ、网页等等这些都是程序。比如说需求文档、设计文档、用户手册这些东西都属于文档。在页面中展示的,还有用户输入的内容这些都是数据。 所以说程
|
敏捷开发 架构师 测试技术
【干货合集】12篇文章带你读懂敏捷架构!
流行技术大狂欢,5月29日即将召开的第二届研发效能嘉年华,带来了前沿技术理念及实践技术成果分享。本次峰会将有10位技术大咖进行干货分享,多角度,不同领域的带领大家了解高效研发。
7771 0
|
数据可视化 Linux BI
技术写作中的那些神兵利器
技术写作中的那些神兵利器
166 0
技术写作中的那些神兵利器
|
设计模式 测试技术 程序员
代码整洁之道(一)最佳实践小结
Any fool can write code that a computer can understand. Good programmers write code that humans can understand. 普通的工程师堆砌代码,优秀的工程师优雅代码,卓越的工程师简化代码。如何写出优雅整洁易懂的代码是一门学问,也是软件工程实践里重要的一环。前段时间通读了三本经典书籍《代码整洁之道 》、《编写可读代码的艺术》、《重构:改善既有代码的设计》,本文将重点从注释、命名、方法、异常、单元测试等方面总结了一些代码整洁最佳实践。
302 0
|
搜索推荐 Java
独家下载!《Java开发手册》灵魂13问,深度剖析一线大厂开发思维 | 技术日报(9期)
《〈Java开发手册(泰山版)〉灵魂13问》独家首发!全网千万阅读量技术博主深度剖析Java规约背后的原理,从“问题重现”到“原理分析”再到“问题解决”,下载《Java开发手册》必备的伴读书目!
3107 0
|
前端开发 JavaScript API
如何阅读大型前端开源项目的源码,授人以鱼不如授人以渔
目前网上有很多「XX源码分析」这样的文章,不过这些文章分析源码的范围有限,有时候讲的内容不是读者最关心的。同时我也注意到,源码是在不断更新的,文章里写的源码往往已经过时了。因为这些问题,很多同学都喜欢自己看源码,自己动手,丰衣足食。
1707 0