讓 AI 成為你的除錯小幫手
Antigravity 的優勢：AI 可以直接存取你的專案檔案，更容易理解問題情境
1你想做什麼 - 目標是什麼
2你做了什麼 - 執行的指令
3發生了什麼 - 完整的錯誤訊息
4你期待什麼 - 應該要發生的事
「Pandoc 壞了，幫我修」
問題：沒有任何具體資訊，AI 無從下手
「我執行 pandoc report.md -o report.pdf 時，出現錯誤訊息：pdflatex not found。我的系統是 Windows 11，請問怎麼解決？」
包含：指令、錯誤訊息、環境資訊
我在使用 Pandoc 時遇到問題。
環境：
- 作業系統：[Windows 11 / macOS / Linux]
- Pandoc 版本：[執行 pandoc --version 的結果]
執行的指令：
[你執行的完整指令]
錯誤訊息：
[複製貼上完整的錯誤訊息]
我想要達成的目標：
[說明你想做什麼]
請幫我分析問題並提供解決方法。
我的 Pandoc 指令出現這個錯誤：
pandoc: Could not parse YAML header
我的 Markdown 檔案開頭是：
---
title:我的報告
author: "小明
---
請問哪裡出錯了？
你的 YAML 有兩個問題：
title: 後面沒有空格author 的引號沒有配對正確的寫法是...
這是我執行批次轉換腳本時的錯誤，
請幫我分析問題在哪裡：
At D:\convert.ps1:15 char:1
+ pandoc $file -o $output
+ ~~~~~~~~~~~~~~~~~~~~~~~
CategoryInfo: NotSpecified: (pandoc: ...){}, ParserError
FullyQualifiedErrorId: NativeCommandError
這是我的腳本，執行時會出錯：
```powershell
foreach ($file in Get-ChildItem *.md) {
pandoc $file -o $file.docx
}
```
錯誤訊息是：無法將 ".docx" 繫結到類型...
請幫我修正這個腳本。
技巧：把程式碼用 ``` 包起來，AI 更容易讀懂
請看一下 convert.ps1 這個腳本，
執行時會出錯，幫我找出問題
AI 的建議要驗證後再採用
1先理解 AI 的解釋
2在測試檔案上試驗
3確認結果符合預期
4才套用到正式檔案
我試了你建議的方法，但還是有問題。
新的錯誤訊息是：
[貼上新的錯誤]
我的環境：
- Pandoc 版本是 3.1.9
- PowerShell 版本是 7.4
- 作業系統是 Windows 11
請再幫我看看。
修好問題後，可以請 AI 解釋原因
問題修好了，謝謝！
但我想了解一下，
為什麼 YAML 的冒號後面一定要有空格？
這樣以後我就知道怎麼避免了。
學習思維：不只修好問題，還要理解根本原因
請幫我寫一個 PowerShell 腳本，
可以診斷 Pandoc 的常見問題，
包括：
1. 檢查 Pandoc 是否安裝
2. 檢查 PATH 設定
3. 檢查 LaTeX 是否可用
4. 測試基本轉換功能
腳本要顯示清楚的診斷結果，
讓我知道哪些正常、哪些有問題。
我經常在使用 Pandoc 時遇到問題，
請幫我建立一份檢查清單，
在每次轉換前可以快速確認，
避免常見的錯誤。
包括：
- 檔案準備的檢查項目
- 常見錯誤的預防方法
- 建議的標準作業流程
1遇到錯誤 → 完整複製錯誤訊息
2描述情境 → 說明目標、指令、環境
3詢問 AI → 使用完整的提示詞
4驗證建議 → 先在測試環境試驗
5理解原因 → 請 AI 解釋為什麼
6記錄經驗 → 下次遇到就知道了
這個錯誤訊息是什麼意思？[貼上錯誤]
請幫我修正這段腳本的錯誤：[貼上程式碼]
為什麼會發生這個問題？請解釋背後的原因
如何避免以後再遇到這個問題？
1故意建立一個有錯誤的 Markdown 檔
2嘗試轉換，記錄錯誤訊息
3使用提示詞範本詢問 AI
4根據 AI 建議修正問題
5請 AI 解釋問題的原因
我想建立一個穩健的文件轉換系統，
可以：
1. 自動檢查輸入檔案的問題
2. 在轉換前修正常見錯誤
3. 處理轉換失敗的情況
4. 產生詳細的處理報告
請幫我設計這個系統的架構，
並提供實作的腳本程式碼。
每次解決問題後，記錄下來：
## 問題：YAML 解析失敗
**錯誤**：Could not parse YAML header
**原因**：冒號後沒有空格
**解決**：確保 YAML 的冒號後面有空格
**範例**：`title: 正確` vs `title:錯誤`
向 AI 描述問題時，哪些資訊最重要？
恭喜！你已完成 Part 09 疑難排解的學習！