SSDLC Prompt 範本使用指南

概述

本文檔提供完整的 SSDLC (Secure Software Development Life Cycle) Prompt 範本使用指南，協助團隊透過 AI 輔助完成各階段的開發任務。

範本結構說明

目錄組織

.github/prompts/
├── SSDLC_專案範本指南.md          # 主要指南文檔
├── 需求分析/
│   ├── 業務需求收集範本.md
│   ├── 功能需求分析範本.md
│   ├── 安全需求識別範本.md
│   └── 使用者故事撰寫範本.md
├── 設計開發/
│   ├── 系統架構設計範本.md
│   ├── API設計範本.md
│   └── [其他設計範本]
├── 測試驗收/
│   ├── 測試策略制定範本.md
│   ├── 自動化測試範本.md
│   └── [其他測試範本]
└── 部署運維/
    ├── CI_CD流程範本.md
    └── [其他運維範本]

快速開始指南

步驟 1: 選擇適當的範本

根據當前專案階段選擇對應的範本：

需求分析階段: 從業務需求收集開始
設計開發階段: 從系統架構設計開始
測試驗收階段: 從測試策略制定開始
部署運維階段: 從 CI/CD 流程設計開始

步驟 2: 填寫專案資訊

每個範本都包含專案背景資訊區塊，需要填入：

### 專案背景資訊
- **專案名稱**: {填入您的專案名稱}
- **專案類型**: {填入專案類型}
- **目標使用者**: {填入目標使用者群體}
- **業務領域**: {填入業務領域}
- **專案規模**: {填入專案規模}

步驟 3: 執行 AI 輔助

複製完整的範本內容
替換所有 {填入...} 佔位符為實際資訊
將完整 prompt 提供給 AI
檢視和調整 AI 的輸出結果

步驟 4: 文檔化結果

將 AI 產生的結果整理成專案文檔並納入版本控制。

範本使用範例

範例 1: 使用業務需求收集範本

原始 prompt 片段:

請協助我完成 {專案名稱} 的業務需求收集工作。

### 專案背景資訊
- **專案名稱**: {填入專案名稱}
- **專案類型**: {填入專案類型}

實際使用時:

請協助我完成 線上學習管理系統 的業務需求收集工作。

### 專案背景資訊
- **專案名稱**: 線上學習管理系統
- **專案類型**: Web應用
- **目標使用者**: 學生、教師、管理員
- **業務領域**: 教育
- **專案規模**: 中型

範例 2: 使用系統架構設計範本

填寫專案技術背景:

### 專案技術背景
- **專案名稱**: 電子商務平台
- **系統類型**: 微服務架構
- **預期使用者規模**: 10萬
- **效能要求**: 響應時間 < 2秒，吞吐量 > 1000 TPS
- **技術棧偏好**: Java/Spring Boot
- **部署環境**: AWS 雲端

最佳實務建議

1. Prompt 撰寫技巧

具體性原則

❌ 模糊：「設計一個系統」
✅ 具體：「為處理10萬使用者的電商平台設計微服務架構」

上下文完整性

包含所有必要的專案背景資訊
說明限制條件和約束
提供相關的業務規則

輸出格式明確

指定所需的文檔格式
明確輸出的結構和章節
要求具體的交付物

2. 品質控制流程

AI 輸出檢視

完整性檢查: 是否涵蓋所有要求的項目
準確性驗證: 技術細節是否正確
一致性確認: 與專案目標是否一致
可行性評估: 建議是否實際可執行

專家審查

由相關領域專家檢視 AI 輸出
結合團隊經驗進行調整
確保符合組織標準和最佳實務

3. 迭代改進策略

持續優化

收集使用回饋
記錄常見問題和解決方案
定期更新範本內容
新增成功案例和範例

知識累積

建立組織專屬的範本庫
分享成功的 prompt 案例
培養團隊的 prompt 撰寫技能

進階使用技巧

1. 組合使用範本

階段性應用

階段1: 業務需求收集 + 功能需求分析
階段2: 系統架構設計 + API設計
階段3: 測試策略制定 + 自動化測試
階段4: CI/CD流程 + 監控設置

交叉驗證

使用不同範本產生的結果進行交叉檢驗：

需求與架構的一致性
測試策略與需求的覆蓋度
部署方案與架構的匹配性

2. 客製化範本

組織特殊需求

根據組織特性調整範本：

加入組織特有的流程
整合既有的工具和標準
反映組織的技術偏好

領域專業化

針對特定業務領域優化：

金融業的合規要求
醫療業的安全標準
電商的效能需求

3. 工具整合

與開發工具整合

將產生的架構圖整合到 draw.io
將 API 規格匯入到 Swagger
將測試案例同步到測試管理工具

與專案管理整合

將需求轉換為 Jira tickets
將測試策略對應到測試計畫
將部署流程整合到 CI/CD 工具

疑難排解

常見問題與解決方案

Q1: AI 產生的內容太過籠統

解決方案:

提供更詳細的專案背景
增加具體的約束條件
要求具體的範例和數據

Q2: 輸出格式不符合期望

解決方案:

明確指定輸出格式範本
提供期望的範例結構
使用 Markdown 格式要求

Q3: 技術建議不符合組織環境

解決方案:

在 prompt 中說明組織的技術限制
指定必須使用的技術棧
要求多個替代方案

Q4: 內容過於複雜或簡單

解決方案:

調整專案規模描述
明確說明團隊技術水平
要求分階段實施建議

效果評估

成功指標

時間節省: 文檔產生時間縮短 50% 以上
品質提升: 文檔完整性和一致性改善
標準化: 輸出格式和內容結構統一
知識傳承: 團隊成員技能提升

持續改進

定期收集使用者回饋
分析常見的調整需求
更新範本以反映最佳實務
建立成功案例資料庫

結論

這套 SSDLC Prompt 範本體系提供了：

結構化的方法: 系統性地處理軟體開發生命週期各階段
可重複的流程: 標準化的範本確保一致性
AI 輔助效率: 大幅提升文檔產生和設計決策效率
品質保證機制: 內建的檢查清單和最佳實務指引
擴展性設計: 可根據組織需求客製化和擴展

透過正確使用這些範本，團隊可以：

提升專案文檔的品質和完整性
縮短專案規劃和設計時間
增強團隊協作和知識分享
建立可重複使用的專案資產

建議團隊從小型專案開始實驗，逐步熟悉範本使用方法，並根據實際經驗持續優化和改進範本內容。

SSDLC Prompt 範本使用指南#

概述#

範本結構說明#

目錄組織#

快速開始指南#

步驟 1: 選擇適當的範本#

步驟 2: 填寫專案資訊#

步驟 3: 執行 AI 輔助#

步驟 4: 文檔化結果#

範本使用範例#

範例 1: 使用業務需求收集範本#

範例 2: 使用系統架構設計範本#

最佳實務建議#

1. Prompt 撰寫技巧#

具體性原則#

上下文完整性#

輸出格式明確#

2. 品質控制流程#

AI 輸出檢視#

專家審查#

3. 迭代改進策略#

持續優化#

知識累積#

進階使用技巧#

1. 組合使用範本#

階段性應用#

交叉驗證#

2. 客製化範本#

組織特殊需求#

領域專業化#

3. 工具整合#

與開發工具整合#

與專案管理整合#

疑難排解#

常見問題與解決方案#

Q1: AI 產生的內容太過籠統#

Q2: 輸出格式不符合期望#

Q3: 技術建議不符合組織環境#

Q4: 內容過於複雜或簡單#

效果評估#

成功指標#

持續改進#

結論#

SSDLC Prompt 範本使用指南

概述

範本結構說明

目錄組織

快速開始指南

步驟 1: 選擇適當的範本

步驟 2: 填寫專案資訊

步驟 3: 執行 AI 輔助

步驟 4: 文檔化結果

範本使用範例

範例 1: 使用業務需求收集範本

範例 2: 使用系統架構設計範本

最佳實務建議

1. Prompt 撰寫技巧

具體性原則

上下文完整性

輸出格式明確

2. 品質控制流程

AI 輸出檢視

專家審查

3. 迭代改進策略

持續優化

知識累積

進階使用技巧

1. 組合使用範本

階段性應用

交叉驗證

2. 客製化範本

組織特殊需求

領域專業化

3. 工具整合

與開發工具整合

與專案管理整合

疑難排解

常見問題與解決方案

Q1: AI 產生的內容太過籠統

Q2: 輸出格式不符合期望

Q3: 技術建議不符合組織環境

Q4: 內容過於複雜或簡單

效果評估

成功指標

持續改進

結論