---
title: "05 - 實戰提示詞與上手流程"
type: note
specialty: Programming
tags: [codex從0開始使用教學, 05-實戰提示詞與上手流程]
---

# 05 - 實戰提示詞與上手流程

← [[04-權限與安全設定]] | [[00-Index]] | 下一篇 → [[06-進階功能-Skills-Automations-多代理]]

---

## 初學者最需要的不是華麗 prompt

官方在 `Working with Codex` 很明確地說：你不需要完美 prompt，也不需要很技術化的指令。

真正有用的是把這 3 件事講清楚：

1. 你要做什麼
2. 可以用哪些檔案 / 範圍
3. done 長什麼樣

## 一個通用 prompt 模板

你可以直接套這個：

```text
請先檢查 [資料夾 / 專案 / 檔案]，告訴我你看到的重點。
接著提出一個安全、範圍小、可在這次完成的方案。
如果需要修改檔案，請先告訴我你預計會改哪些檔案，以及完成後我會得到什麼。
```

如果你已經準備好要讓它直接做，可以改成：

```text
請在這個 project 內完成以下任務：
1. ...
2. ...
3. 完成後回報你改了哪些檔案、做了哪些驗證、還有哪些風險或待確認事項。
```

## 5 種很適合新手的任務

### 1. 看懂資料夾

```text
請先閱讀這個資料夾的結構與主要檔案，告訴我它大概是做什麼的。
接著列出 3 個我可以安全開始的小任務。
```

### 2. 整理文件

```text
請把這些 Markdown 筆記整理成一份條理更清楚的索引頁。
不要刪原文，只新增整理檔。
```

### 3. 找 bug

```text
請根據這段錯誤訊息找出可能原因。
如果你認為可以安全修正，請實作並說明改了什麼。
```

### 4. 補測試

```text
請先閱讀這個模組與現有測試。
找出一個合理但缺漏的測試情境並補上。
```

### 5. 做固定格式輸出

```text
請閱讀這個資料夾中的內容，整理成一份一頁式摘要。
格式要包含：背景、現況、問題、下一步。
```

## prompt 的實用原則

### 說輸出格式

比起只說「整理一下」，更好的是說：

- 產出一份 Markdown
- 用條列式
- 控制在 1 頁
- 最後列出引用來源
- 回答用繁體中文，專有名詞保留英文

### 說限制條件

例如：

- 不要改原始檔
- 只新增新檔
- 不要碰 production 設定
- 修改前先告知
- 若不確定先停下來問

### 說驗證方式

例如：

- 做完後告訴我你怎麼檢查
- 若有測試請跑測試
- 若沒法驗證請直接說

## 一個穩定的上手流程

可以照這個節奏：

1. 先讓 Codex inspect
2. 讓它提小方案
3. 你確認
4. 它執行
5. 它回報修改與驗證
6. 你 review
7. 再逐步放大任務

這比一開始就丟一個超大需求，成功率高很多。

## 重點整理

- 好 prompt 的重點不是 fancy，而是清楚。
- 目標、範圍、done、限制、驗證，這 5 個元素最實用。
- 新手最穩的流程是 inspect -> propose -> approve -> execute -> review。
- 你越清楚交代輸出格式，Codex 越容易穩定交付。

## 參考資料

- [Working with Codex](https://openai.com/academy/working-with-codex/)
- [How to get started with Codex](https://openai.com/academy/codex-how-to-start/)
- [Codex | OpenAI Academy](https://openai.com/academy/codex/)

---

← [[04-權限與安全設定]] | [[00-Index]] | 下一篇 → [[06-進階功能-Skills-Automations-多代理]]