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

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

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

一、技术方案的难点

要考虑清楚以下几个点:

1、技术方案与谁相关

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

2、关键指标是什么

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

3、技术方案的观众是谁

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

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

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

二、写的方法

1、写的框架

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

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

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

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

2、好的方案优点

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

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

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

三、怎样写

1、框架

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

2、深入分析需求

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

3、合理的目标设定

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

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

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

4、度量要点

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

指标体系设计

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

5、方案设计要专业

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

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

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

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

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

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

6、执行路径

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

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

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

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

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

7、做好项管

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

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

目录
相关文章
|
5天前
|
算法 测试技术 开发工具
编写高效技术文档的艺术:C++项目实践指南
编写高效技术文档的艺术:C++项目实践指南
80 0
|
测试技术 数据库 安全
带你读《C++代码整洁之道:C++17 可持续软件开发模式实践》之二:构建安全体系
如果想用C++语言编写出易维护的、扩展性良好的以及生命力强的软件,那么,对于所有的软件开发人员、软件设计人员、对现代C++代码感兴趣或想降低开发成本的项目领导者来说,本书都是必需品。如果你想自学编写整洁的C++代码,那么本书也是你需要的。本书旨在通过一些示例帮助各个技术层次的开发人员编写出易懂的、灵活的、可维护的和高效的C++代码。即使你是一名资深的开发工程师,在本书中也可以找到有价值的知识点。
|
5天前
|
算法 程序员
代码与哲学:从技术实践中汲取智慧
【2月更文挑战第18天】 在数字世界的构建过程中,代码不仅仅是一种实现功能的工具,它更是连接现实与理想的桥梁。本文将探讨编程实践如何映射出深刻的哲学思考,揭示通过技术探索所能领悟的人生智慧。我们将透过代码的表象,深入其背后的逻辑结构,从而理解编程不仅是一种职业技能,更是一种对世界认知和自我修炼的方式。
30 7
|
JavaScript 搜索推荐 前端开发
软件工程师文档写作最佳实践
软件工程师文档写作最佳实践
142 1
软件工程师文档写作最佳实践
|
敏捷开发 架构师 测试技术
【干货合集】12篇文章带你读懂敏捷架构!
流行技术大狂欢,5月29日即将召开的第二届研发效能嘉年华,带来了前沿技术理念及实践技术成果分享。本次峰会将有10位技术大咖进行干货分享,多角度,不同领域的带领大家了解高效研发。
7787 0
|
消息中间件 存储 缓存
架构之美-软件实现分析之道
理解一个实现,是以对模型和接口的理解为前提。 如果想了解一个系统的实现,应从软件结构和关键技术两个方面着手。无论是软件结构,还是关键技术,我们都需要带着自己的问题入手,而问题的出发点就是我们对模型和接口的理解。 了解软件的结构,其实,就是把分层的模型展开,看下一层模型: 要知道这个层次给你提供了怎样的模型 要带着自己的问题去了解这些模型为什么要这么设计 Kafka的实现主要是针对机械硬盘做的优化,现在的SSD硬盘越来越多,成本越来越低,这个立意的出发点已经不像以前那样稳固了。
118 0
架构之美-软件实现分析之道
|
设计模式 测试技术 程序员
代码整洁之道(一)最佳实践小结
Any fool can write code that a computer can understand. Good programmers write code that humans can understand. 普通的工程师堆砌代码,优秀的工程师优雅代码,卓越的工程师简化代码。如何写出优雅整洁易懂的代码是一门学问,也是软件工程实践里重要的一环。前段时间通读了三本经典书籍《代码整洁之道 》、《编写可读代码的艺术》、《重构:改善既有代码的设计》,本文将重点从注释、命名、方法、异常、单元测试等方面总结了一些代码整洁最佳实践。
312 0
|
C++ 程序员 Java
带你读《C++代码整洁之道:C++17 可持续软件开发模式实践》之一:简介
如果想用C++语言编写出易维护的、扩展性良好的以及生命力强的软件,那么,对于所有的软件开发人员、软件设计人员、对现代C++代码感兴趣或想降低开发成本的项目领导者来说,本书都是必需品。如果你想自学编写整洁的C++代码,那么本书也是你需要的。本书旨在通过一些示例帮助各个技术层次的开发人员编写出易懂的、灵活的、可维护的和高效的C++代码。即使你是一名资深的开发工程师,在本书中也可以找到有价值的知识点。
|
C++ 测试技术
带你读《C++代码整洁之道:C++17 可持续软件开发模式实践》之三:原则
如果想用C++语言编写出易维护的、扩展性良好的以及生命力强的软件,那么,对于所有的软件开发人员、软件设计人员、对现代C++代码感兴趣或想降低开发成本的项目领导者来说,本书都是必需品。如果你想自学编写整洁的C++代码,那么本书也是你需要的。本书旨在通过一些示例帮助各个技术层次的开发人员编写出易懂的、灵活的、可维护的和高效的C++代码。即使你是一名资深的开发工程师,在本书中也可以找到有价值的知识点。
|
JavaScript 前端开发 架构师
做《重构(第2版)》中文版的首批读者
 ​ 作为程序员,要学习很多重要的主题。算法,数据结构,编程语言,数不胜数,代码重构也是其中必备技能之一。 今天小编推荐一本无敌厉害的书,接下来的很长时间你将被这本书刷屏,它将出现在各大畅销书排行榜内,这本书就是《重构(第2版)》。
2477 0