此技能會獲取目前的對話上下文與程式碼庫理解,然後產生一份規格書。請不要面試使用者;只需綜合你已經知道的內容。
問題追蹤器與分診標籤詞彙應已提供給你。如果沒有,請告訴使用者執行 /setup-matt-pocock-skills。
流程
-
探索儲存庫,了解程式碼庫目前的狀態(如果你還沒有這麼做的話)。在整份規格書中使用專案的領域詞彙,並尊重你所觸及區域中的任何 ADR。
-
草擬你將用來測試該功能的接縫。應優先使用現有的接縫。使用最高的接縫。如果需要新的接縫,請在你能達到的最高點提出建議。程式碼庫中的接縫越少越好——理想的數量是一個。
向使用者確認這些接縫是否符合他們的期望。
- 使用下面的模板撰寫規格書,然後將其發佈到專案問題追蹤器。套用
ready-for-agent分診標籤——無需額外的分診。
問題陳述
從使用者的角度來看,使用者面臨的問題。
解決方案
從使用者的角度來看,問題的解決方案。
使用者故事
一個很長、編號的使用者故事列表。每個使用者故事應採用以下格式:
- 身為一個<角色>,我想要一個<功能>,以便<效益>
<使用者故事範例>
- 身為一個行動銀行客戶,我想要檢視我帳戶的餘額,以便我能針對我的支出做出更明智的決定 </使用者故事範例>
這份使用者故事列表應極為詳盡,涵蓋該功能的所有方面。
實作決定
已做出的實作決定列表。這可以包括:
- 將被建構/修改的模組
- 那些將被修改的模組的介面
- 來自開發者的技術說明
- 架構決策
- Schema 變更
- API 合約
- 具體互動
請不要包含具體的檔案路徑或程式碼片段。它們可能很快就會過時。
例外:如果一個原型產生了某個片段,其編碼決策的精確度超越散文(例如狀態機、reducer、schema、型別形狀),請將它內嵌在相關決策中,並簡短註明它來自原型。修剪到決策豐富的部分,不需要一個可運行的展示,只保留重要的部分。
測試決定
已做出的測試決定列表。包括:
- 好測試的定義描述(只測試外部行為,不測試實作細節)
- 將測試哪些模組
- 測試的既有前例(即程式碼庫中類似類型的測試)
超出範圍
對此規格書而言超出範圍的事項描述。
進一步備註
關於該功能的任何進一步備註。