# Code Review Expert
## Description
執(zhí)行全面的代碼審查，涵蓋安全性、性能、可讀性和最佳實踐。
## When to use
- 用戶提交代碼變更請求時
- Pull Request 創(chuàng)建需要審查時
- 代碼重構(gòu)前的評估
- 合并前的最終檢查
## Instructions
1. **安全審查**
   - 檢查 SQL 注入、XSS、CSRF 等常見漏洞
   - 驗證輸入驗證和輸出編碼
   - 檢查敏感數(shù)據(jù)是否加密存儲
2. **性能分析**
   - 識別 N+1 查詢問題
   - 檢查不必要的循環(huán)嵌套
   - 評估算法復(fù)雜度
   - 建議緩存策略
3. **代碼質(zhì)量**
   - 命名是否清晰自解釋
   - 函數(shù)是否單一職責(zé)
   - 重復(fù)代碼是否可提取
   - 注釋是否準(zhǔn)確必要
4. **最佳實踐**
   - 錯誤處理是否完善
   - 邊界條件是否考慮
   - 日志記錄是否合理
   - 測試覆蓋是否充分
## Output Format
### 嚴(yán)重問題（必須修復(fù)）
- [問題描述]
### 建議優(yōu)化
- [優(yōu)化建議]
### 符合規(guī)范
- [符合規(guī)范]

# Technical Documentation Writer

## Description
按照標(biāo)準(zhǔn)規(guī)范撰寫高質(zhì)量的技術(shù)文檔，包括架構(gòu)文檔、API 文檔、README 等。

## When to use
- 需要編寫項目 README 時
- 創(chuàng)建 API 接口文檔時
- 撰寫架構(gòu)設(shè)計文檔時
- 編寫開發(fā)者指南時

## Instructions
1. **結(jié)構(gòu)規(guī)劃**
   - 明確文檔受眾（開發(fā)者/產(chǎn)品/用戶）
   - 設(shè)計清晰的目錄結(jié)構(gòu)
   - 確定文檔類型和深度

2. **內(nèi)容撰寫**
   - 使用清晰簡潔的語言
   - 提供具體可運行的代碼示例
   - 添加必要的圖表和流程圖
   - 標(biāo)注關(guān)鍵注意事項

3. **格式規(guī)范**
   - 使用 Markdown 標(biāo)準(zhǔn)語法
   - 代碼塊標(biāo)注語言類型
   - 重要信息使用引用塊或警告框
   - 添加目錄導(dǎo)航

4. **完整性檢查**
   - 安裝步驟是否可復(fù)現(xiàn)
   - 示例代碼是否可直接運行
   - 配置項是否完整說明
   - 常見問題是否覆蓋

## Output Format
```markdown
# [文檔標(biāo)題]

## 概述
[簡要說明文檔目的和適用范圍]

## 前置條件
- [環(huán)境要求]
- [依賴工具]

## 快速開始
```bash
[安裝命令]

# Conventional Commits Enforcer

## Description
生成符合 Conventional Commits 規(guī)范的 Git 提交信息，確保提交歷史清晰可追溯。

## When to use
- 用戶執(zhí)行 git commit 時
- 需要規(guī)范化提交信息時
- 生成 CHANGELOG 前的準(zhǔn)備

## Instructions
1. **分析變更內(nèi)容**
   - 識別變更類型（feat/fix/docs/style/refactor/test/chore）
   - 確定影響范圍
   - 提取關(guān)鍵變更點

2. **生成提交信息**
   - 遵循 `<type>(<scope>): <subject>` 格式
   - subject 使用祈使句，不超過 50 字符
   - body 詳細說明變更原因和內(nèi)容
   - footer 關(guān)聯(lián) issue 或 breaking change

3. **多語言支持**
   - 中文項目使用中文描述
   - 國際項目使用英文描述
   - 技術(shù)術(shù)語保持原文

## Output Format
feat(auth): add OAuth2 login support

- Implement Google OAuth2 authentication flow
- Add token refresh mechanism
- Update user session management

Closes

# API Design Reviewer

## Description
審查 RESTful API 設(shè)計是否符合行業(yè)最佳實踐和規(guī)范。

## When to use
- 設(shè)計新 API 接口時
- 評審 API 變更時
- 重構(gòu)現(xiàn)有 API 時

## Instructions
1. **URL 設(shè)計審查**
   - 使用名詞復(fù)數(shù)形式（/users 而非 /user）
   - 層級不超過 3 層
   - 避免動詞，用 HTTP 方法表達操作
   - 使用 kebab-case 命名

2. **HTTP 方法正確性**
   - GET：查詢，冪等，無副作用
   - POST：創(chuàng)建，非冪等
   - PUT：完整更新，冪等
   - PATCH：部分更新，冪等
   - DELETE：刪除，冪等

3. **響應(yīng)格式規(guī)范**
   - 統(tǒng)一使用 JSON 格式
   - 成功響應(yīng)返回適當(dāng)?shù)臓顟B(tài)碼
   - 錯誤響應(yīng)包含錯誤碼和詳細信息
   - 分頁數(shù)據(jù)包含元信息

4. **版本控制策略**
   - URL 版本（/v1/users）或 Header 版本
   - 破壞性變更必須升級版本
   - 舊版本保留合理的廢棄期

## Output Format
### 符合規(guī)范
- [列出符合規(guī)范的點]

### 需要改進
- [問題] → [建議]

### 參考規(guī)范
- [相關(guān)規(guī)范鏈接]

# Requirement Analyzer

## Description
將產(chǎn)品需求轉(zhuǎn)化為清晰的技術(shù)任務(wù)，包括功能拆解、技術(shù)方案、驗收標(biāo)準(zhǔn)。

## When to use
- 接到產(chǎn)品需求需要技術(shù)拆解時
- 編寫技術(shù)方案文檔時
- 評估開發(fā)工作量時

## Instructions
1. **需求理解**
   - 明確核心目標(biāo)和用戶價值
   - 識別功能范圍和邊界
   - 標(biāo)注技術(shù)約束和依賴

2. **任務(wù)拆解**
   - 按照前端/后端/數(shù)據(jù)/測試等維度拆分
   - 識別技術(shù)風(fēng)險點
   - 標(biāo)注任務(wù)依賴關(guān)系

3. **技術(shù)方案**
   - 選擇合適的技術(shù)棧
   - 設(shè)計數(shù)據(jù)模型和接口
   - 考慮性能、安全、擴展性

4. **驗收標(biāo)準(zhǔn)**
   - 定義功能驗收點
   - 明確性能指標(biāo)
   - 列出測試場景

## Output Format
## 需求概述
[一句話總結(jié)需求]

## 功能拆解
### 前端任務(wù)
- [ ] [任務(wù)1]
- [ ] [任務(wù)2]

### 后端任務(wù)
- [ ] [任務(wù)1]
- [ ] [任務(wù)2]

## 技術(shù)方案
[選型和技術(shù)設(shè)計]

## 驗收標(biāo)準(zhǔn)
- [ ] [驗收點1]
- [ ] [驗收點2]

## 風(fēng)險評估
 [潛在風(fēng)險和應(yīng)對方案]