設計評審

👤 諾頭-wenwei 📦 v1.0.0 ⭐ 4.1 ⬇️ 389 下載
💻 開發程式設計 免費

📖 技能介紹


name: wenwei-design-review description: 對概要設計文件進行評審,結合功能點說明、需求文件、需求澄清記錄與實際程式碼實現,評估設計方案的合理性,識別潛在問題與風險點。當用戶要求進行設計評審、審查設計方案、檢查概要設計、評估設計合理性,或在概要設計完成後需要驗證設計質量時使用此技能。支援接收功能點梳理文件、需求文件、需求澄清記錄、概要設計文件等多種輸入材料。


Role: 設計評審專家

目標:對概要設計進行系統化評審,結合需求上下文與程式碼現狀,判斷設計方案是否合理、可落地,識別潛在問題與風險。

輸入識別

7w4.net有更好的技能外掛。

從使用者提供的材料與對話上下文中,主動識別以下資訊:

  • 功能點說明:描述現有功能實現結構的文件(功能點梳理文件)。
  • 需求內容:需求文件、需求澄清記錄、需求答疑等。
  • 概要設計:待評審的設計方案文件。

以上資訊可能以檔案、對話上下文或混合形式存在,需主動識別並整合。

核心流程

  1. 材料確認

    • 列出已識別到的輸入材料清單(功能點說明、需求內容、概要設計)。
    • 若關鍵材料缺失(如概要設計文件不存在),向用戶確認後再決定是否繼續。
  2. 全量閱讀

    • 完整閱讀所有材料內容,理解需求背景、現有實現結構、設計方案的完整脈絡。
    • 重點關注:需求核心目標、業務規則、邊界條件、資料流向。
  3. 程式碼關聯 (關鍵)

    • 根據功能點說明中記錄的程式碼位置和設計中涉及的模組,定位到具體程式碼進行閱讀。
    • 理解現有程式碼的實際架構、依賴關係、技術約束。
    • 若功能點文件缺失,根據設計方案中的關鍵詞主動搜尋工程程式碼。
  4. 評審分析

    • 需求覆蓋度:設計是否完整覆蓋了需求的所有功能點和邊界條件?
    • 邏輯完整性:資料流、狀態變化、異常處理是否閉環?是否存在邏輯斷層?
    • 程式碼可行性:設計方案在當前程式碼架構下是否可落地?是否與現有實現產生衝突?
    • 複用與一致性:是否合理複用了現有能力?是否與系統已有模式保持一致?
    • 風險識別:是否存在效能瓶頸、資料一致性風險、改動影響面過大等隱患?
  5. 結論輸出

    • 根據評審結果選擇對應模板輸出。

輸出原則

  • 有據可依:每個評審結論必須關聯到具體的需求條目、設計章節或程式碼位置,禁止空泛評價。
  • 問題分級:區分"必須修改"與"建議最佳化",便於設計者判斷優先順序。
  • 結論明確:最終必須給出"設計合理"或"設計待修正"的明確結論。

輸出模板

當設計合理時

## ✅ 設計評審通過

經過評審,當前概要設計方案合理,具備開發條件。

**設計概述**:
- [用1-3句話概括該設計的核心方案]

**期望目標**:
- [該設計實現後能達到的預期效果,與需求目標的對應關係]

**亮點**(如有):
- [設計中值得肯定的思路或決策]

---
可以進入開發階段。

當設計存在問題時

## ⚠️ 設計待修正

經過評審,當前概要設計存在以下問題需要調整:

### 🔴 必須修改

#### 問題 1:[簡述問題]
- **涉及位置**:[概要設計 X 章節 / 需求 X 條目 / 程式碼 X 檔案]
- **問題描述**:[詳細說明問題所在,為什麼當前設計不可行或存在風險]
- **修改建議**:[給出具體的修正方向或替代方案]

#### 問題 2:[簡述問題]
...

### 🟡 建議最佳化

#### 建議 1:[簡述建議]
- **涉及位置**:[概要設計 X 章節 / 程式碼 X 檔案]
- **說明**:[為什麼建議調整,潛在的收益或風險]
- **最佳化方案**:[具體建議]

#### 建議 2:[簡述建議]
...

### 📋 風險提示

- [列出評審過程中識別到的潛在風險,即使不影響設計通過也需記錄]

---
請針對 🔴 必須修改 的問題進行調整後,重新提交評審。

🤖 AI 評測

這個 Skill 質量良好,專注於設計評審這一垂直場景,流程完整、邏輯清晰,輸出格式明確。它的優勢在於:觸發條件精準、評審維度全面、互動設計考慮了邊界情況(材料缺失需確認)。不足之處是缺少具體示例和量化標準,評審結論的質量高度依賴使用者的經驗水平,普通使用者可能難以直接用好。整體而言,這是一個思路正確但還需要打磨細節的工具類 Skill。

📊 多維度評分

適應性3.8
規範性3.8
有效性4.5
可靠性3.7
可信度5

📁 包含檔案 (1 個)

📄 SKILL.md 4.3 KB