方格精選

如何向工程師說明規格

更新於 發佈於 閱讀時間約 4 分鐘

有時候我們在執行專案的時候會遇到一個狀況,工程師實作的東西跟預期的不一致,因此能夠正確傳達需求是一個重要的技巧。原本我認為應該就是規格說明清楚就沒問題了,實際上事情卻沒有這麼單純。

識別角色

要能正確地說明規格,需要先了解現在我們討論的對象是怎樣的角色。像是專案經理、技術主管或者是負責實作的工程師。

之前有遇過客戶每次給我們的都是 MRD(Market Requirements Document,市場需求文件)因此讓我們的 PM(Project Manager,專案經理)需要花非常多時間了解系統上的需求,再跟工程師傳達。然而,經過這樣一連串的轉述,有非常多訊息都已經消失。

實際上,對負責實作工程師來說比較有幫助的是描述需求跟規格的 PRD(Product Requirement Document,產品需求文件)也就是說,我們卡住的原因是因為需要反覆的從客戶提供的「市場需求」反推「產品」的樣貌,然而這些資訊大部分對工程師來說可能是一種雜訊。

備註:因為客戶自己有專案經理,因此合約中我們的專案經理主要負責時程方面的控管,需求由客戶自己的專案經理處理。

定義產品規格

跟「市場需求」會描述在市場上的需要不同,「產品需求」是根據這些市場的需要,定義一個產品應該具備怎樣的規格。其中一種撰寫方式,就是先以功能面向進行大分類,然後再撰寫 User Story(使用者故事)來描述情境。

在製作的階段,我認為會需要由負責撰寫規格的產品經理或專案經理跟技術主管協作,在確認市場、技術限制跟成本的前提下去描述,這樣的文件不是去限制程式該怎麼寫,而是如同測試去動開發是什麼這篇文章中提到的 BDD(行為驅動開發)用「預期的操作行為」來去定義。

有了這樣的文件,負責實作的工程師就能清楚的依據在什麼情況(When)做了什麼事情(Given)然後得到怎樣的結果(Then)去設定測試,接下來只要將實現的功能符合這個定義即可。

減少溝通成本

假設我們沒辦法很好的提供資訊,那麼就會呈現前面所提到的狀況。需要經過不同人的彙整,然後再傳達給其他人。然而因為資訊非常多,因此會變得無法逐步地縮限範圍直到一個工程師可以理解的範圍,最後就變的需要投入大量的溝通來了解實現的方式。

以一個軟體開發團隊來看,必定會有資深跟資淺等不同程度的工程師,每個人能考量到跟處理的範圍是不同的,為了能夠讓比較不熟練的同事能夠專注在正確的小單元工作,清楚描述的文件就變得非常重要。

單純一篇文章似乎沒辦法完整的說明,我認為在專案團隊中過度溝通(Over-Communication)是一個增進團隊協作品質的方式,同時減少溝通成本也是一個重要的方向,兩者也不衝突。前者是讓團隊成員理解在做什麼,後者是減少理解的成本,因此正確傳達規格給工程師就變得非常重要。


封面圖片使用 UnsplashJoppe Spaa 的作品,有想聽的主題可以透過匿名問卷告訴我,想了解專業的技術主題可以到弦而時習之找找靈感。

留言
avatar-img
留言分享你的想法!
avatar-img
蒼時弦也的沙龍
55會員
40內容數
軟體工程師逐漸變成一個熱門的職業,當我們進入這個職業之後應該要具備怎樣的技能才會在工作上更加順利呢?這系列的專欄會分享日常工作中的經驗以及一些案例分析,讓我們一起努力成為一位更優秀的軟體工程師吧!
蒼時弦也的沙龍的其他內容
2022/04/11
大多數時候,我們在討論壓力測試通常會先想到 ab 這個工具,然而這個工具會一次性的發送請求,有時候不一定符合現實的使用情況,同時也會受限於運行測試機器的限制(例如:Thread 上限)因此可能會得到不太精確的結果,在測試一定請求等級的瞬間壓力是有用的。
Thumbnail
2022/04/11
大多數時候,我們在討論壓力測試通常會先想到 ab 這個工具,然而這個工具會一次性的發送請求,有時候不一定符合現實的使用情況,同時也會受限於運行測試機器的限制(例如:Thread 上限)因此可能會得到不太精確的結果,在測試一定請求等級的瞬間壓力是有用的。
Thumbnail
2022/04/04
在我們要進行壓力測試的時候,必定會需要有「目標」而這個目標大多就是商業考量,也就是我們希望提供多大規模的服務。
Thumbnail
2022/04/04
在我們要進行壓力測試的時候,必定會需要有「目標」而這個目標大多就是商業考量,也就是我們希望提供多大規模的服務。
Thumbnail
2022/03/28
在一個功能完成後,比較嚴謹的方式會進行壓力測試來驗證是否能夠符合業務上的需求,在測試的時候是否能夠準確的測試就變得相當重要。
Thumbnail
2022/03/28
在一個功能完成後,比較嚴謹的方式會進行壓力測試來驗證是否能夠符合業務上的需求,在測試的時候是否能夠準確的測試就變得相當重要。
Thumbnail
看更多
你可能也想看
Thumbnail
家中修繕或裝潢想要找各種小零件時,直接上網採買可以省去不少煩惱~看看Sylvia這回為了工地買了些什麼吧~
Thumbnail
家中修繕或裝潢想要找各種小零件時,直接上網採買可以省去不少煩惱~看看Sylvia這回為了工地買了些什麼吧~
Thumbnail
👜簡單生活,從整理包包開始!我的三款愛用包+隨身小物清單開箱,一起來看看我每天都帶些什麼吧🌿✨
Thumbnail
👜簡單生活,從整理包包開始!我的三款愛用包+隨身小物清單開箱,一起來看看我每天都帶些什麼吧🌿✨
Thumbnail
創作者營運專員/經理(Operations Specialist/Manager)將負責對平台成長及收入至關重要的 Partnership 夥伴創作者開發及營運。你將發揮對知識與內容變現、影響力變現的精準判斷力,找到你心中的潛力新星或有聲量的中大型創作者加入 vocus。
Thumbnail
創作者營運專員/經理(Operations Specialist/Manager)將負責對平台成長及收入至關重要的 Partnership 夥伴創作者開發及營運。你將發揮對知識與內容變現、影響力變現的精準判斷力,找到你心中的潛力新星或有聲量的中大型創作者加入 vocus。
Thumbnail
今天跟大家分享我身為工程師看到 PM 具備哪些特質會覺得很厲害。
Thumbnail
今天跟大家分享我身為工程師看到 PM 具備哪些特質會覺得很厲害。
Thumbnail
這是 30 天寫作挑戰的第 25 天。今天要來回答臉書留言的提問:怎麼和團隊中的 RD 有效溝通?
Thumbnail
這是 30 天寫作挑戰的第 25 天。今天要來回答臉書留言的提問:怎麼和團隊中的 RD 有效溝通?
Thumbnail
產品經理如何跟設計師、工程師說明產品開發需求?或是跟產品團隊的其他人說明你要開發什麼功能?一定都會用到 PRD 文件,本篇將從文件架構、文件內容來分享我在工作常使用的 PRD 範本框架。
Thumbnail
產品經理如何跟設計師、工程師說明產品開發需求?或是跟產品團隊的其他人說明你要開發什麼功能?一定都會用到 PRD 文件,本篇將從文件架構、文件內容來分享我在工作常使用的 PRD 範本框架。
Thumbnail
去年初我從介面設計師 (UIUX Designer) 轉職為產品經理 (Product Manager),在轉職產品經理前,我已有6-7年的軟體產品設計工作經驗。轉職 PM 後已工作了將近一年,這邊來分享一下我在做中學到的事情。
Thumbnail
去年初我從介面設計師 (UIUX Designer) 轉職為產品經理 (Product Manager),在轉職產品經理前,我已有6-7年的軟體產品設計工作經驗。轉職 PM 後已工作了將近一年,這邊來分享一下我在做中學到的事情。
Thumbnail
時間過得飛快,2022 快要結束了,今年也寫了蠻多跟工程師職場相關的文章,從後台數據發現之前這篇「工程師面試二三事」瀏覽量又刷新高,看來大家很關心面試時如何表達自己及與面試官溝通等問題。
Thumbnail
時間過得飛快,2022 快要結束了,今年也寫了蠻多跟工程師職場相關的文章,從後台數據發現之前這篇「工程師面試二三事」瀏覽量又刷新高,看來大家很關心面試時如何表達自己及與面試官溝通等問題。
Thumbnail
有時候我們在執行專案的時候會遇到一個狀況,工程師實作的東西跟預期的不一致,因此能夠正確傳達需求是一個重要的技巧。原本我認為應該就是規格說明清楚就沒問題了,實際上事情卻沒有這麼單純。
Thumbnail
有時候我們在執行專案的時候會遇到一個狀況,工程師實作的東西跟預期的不一致,因此能夠正確傳達需求是一個重要的技巧。原本我認為應該就是規格說明清楚就沒問題了,實際上事情卻沒有這麼單純。
Thumbnail
產品經理 PM 在產品功能的「規劃階段」我們時常有的兩個錯誤:一、全盤接受客戶所期望的單一個案需求。二、考慮的面向不夠多與思考影響範圍不夠廣。如此可能導致沒有達到需求目標,又或造成維運的更加困難。
Thumbnail
產品經理 PM 在產品功能的「規劃階段」我們時常有的兩個錯誤:一、全盤接受客戶所期望的單一個案需求。二、考慮的面向不夠多與思考影響範圍不夠廣。如此可能導致沒有達到需求目標,又或造成維運的更加困難。
Thumbnail
我前陣子在 Linkedin 上看到一篇有趣的推文,表現軟體開發時,從企劃階段到實際成品的巨大落差。這是永遠無法解決的難題嗎?我分享過去做專案和產品的經驗,希望能帶給各位思考解法的參考。
Thumbnail
我前陣子在 Linkedin 上看到一篇有趣的推文,表現軟體開發時,從企劃階段到實際成品的巨大落差。這是永遠無法解決的難題嗎?我分享過去做專案和產品的經驗,希望能帶給各位思考解法的參考。
Thumbnail
做為一個產品經理,撰寫需求文檔可說是產品經理 PM 無可避免的任務,同時要思考如何將產品規劃內容清楚表達給利害關係人 (Stakeholder) 了解並獲得支持。 在探討該問題時,我們回歸到人與人之間如何進行有效的資訊傳遞?口說與文字(文件),本篇文章將介紹常用產品文件,並帶你一步步實作 PRD。
Thumbnail
做為一個產品經理,撰寫需求文檔可說是產品經理 PM 無可避免的任務,同時要思考如何將產品規劃內容清楚表達給利害關係人 (Stakeholder) 了解並獲得支持。 在探討該問題時,我們回歸到人與人之間如何進行有效的資訊傳遞?口說與文字(文件),本篇文章將介紹常用產品文件,並帶你一步步實作 PRD。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News