---
# System prepended metadata

title: 4. Amazon Q Developer Workshop - 探索專案及文件生成

---

# Amazon Q Developer Workshop - 探索專案及文件生成

## 目錄

[1. 實驗環境準備](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/HknuyDk--e)
[2. 基本功能介紹](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/B1xH4Xeb-x)
[3. 提示詞工程](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/B1v1v4l--e)
[4. 探索專案及文件生成](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/SJ-sUOxWZx)
[5. 開發功能](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/HyVLCOgZ-g)
[6. 生成測試](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/rJROwse-Zl)
[7. 程式碼掃描](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/SJzMislZbx)
[8. 轉換 SOAP 架構成 RESTFul 架構](https://hackmd.io/@Zx9gc3B9R76nDuN1qqwwcA/H1eag2l-Wl)

---

### 理解專案

#### 1. 說明專案 
```
請協助我理解這份專案。
```
:::spoiler 範例回應
![image](https://hackmd.io/_uploads/r18zKugWZe.png)
:::

#### 2. 說明關鍵專案檔案
```
@pom.xml 請說明這份檔案裡面的內容。
```
:::spoiler 範例回應
![image](https://hackmd.io/_uploads/rkw9KOl-Ze.png)
:::

#### 3. 說明應用程式邏輯
```
@GameController 類別的用途是什麼?它如何與其他元件互動?
```
:::spoiler 範例回應
![image](https://hackmd.io/_uploads/HJ76tOgWbx.png)
:::

### 文件生成
```
我希望對這份專案生成 SA/SD 文件，首先請你生成 Prompt 讓我可以重複使用，分別生成 SA_Prompt.md 及 SD_Prompt.md，並儲存至 @prompts 目錄當中。
```
:::spoiler 範例回應
![image](https://hackmd.io/_uploads/HkdgjulZbx.png)
:::

#### 檢視生成文件 Prompt

- `SA_Prompt.md`
![image](https://hackmd.io/_uploads/rylPiug--x.png)

- `SD_Prompt.md`
![image](https://hackmd.io/_uploads/B12Fo_lZbg.png)

#### 執行文件生成
##### 透過 @ 執行 SA 文件產生提示詞
```
@SA_Prompt.md
```
![image](https://hackmd.io/_uploads/S14no_eWZx.png)

##### 輸出結果
![image](https://hackmd.io/_uploads/B1Men_xbWx.png)


##### 透過 @ 執行 SD 文件產生提示詞
```
@SD_Prompt.md
```
![image](https://hackmd.io/_uploads/H1Yp2Ogbbl.png)


##### 輸出結果
![image](https://hackmd.io/_uploads/BJ7hh_lWZx.png)

---

> [!Tip] 優化圖表生成
> 在 Rules 中增加一條規則 `Diagram`
> `請在生成文件時使用 Mermaid 語法生成圖表`

:::spoiler 輸出結果
![image](https://hackmd.io/_uploads/rJCs6_ebZl.png)
![image](https://hackmd.io/_uploads/B1CWROgZZx.png)
:::