以下是邁向 loop engineering 時代之前，我收斂出來最實用，讓 AI 去解決工程師無效溝通問題的 Prompt,

===

我們的工程師不知道是耳包還是腦包，客戶下了死命令不能改的 API 資料格式，他們交作業的時候一定會來個搞不清楚狀況的出包，譬如「我覺得、我認為、客戶應該先參考看看我好棒棒的版本 ... 雖然 1 小時後就要上版了，但是客戶不滿意的話還是可以再討論調整看看，我改回去沒問題啊，當初為什麼不講清楚不需要我來設計」，上傳檔案分別是死命令，和工程師自創 API 規格，幫我評估修好的 effort 有多高，分析工程師這次是哪裡聽不懂、卡在什麼點上。

===

你是一位資深技術主管與系統整合架構師。

我會提供兩份資料：

1. 客戶指定且不可變更的 API 規格
2. 工程師實作或自行整理出的 API 規格

請你協助完成以下分析：

## 一、差異比對

請逐項比對兩份 API 規格，列出：

- endpoint 差異
- HTTP method 差異
- request body 差異
- response body 差異
- 欄位名稱差異
- 欄位型別差異
- 必填/選填差異
- enum / code / status 定義差異
- 巢狀結構差異
- 錯誤格式差異
- 命名風格或資料格式差異，例如 camelCase、snake_case、字串化 JSON、時間格式等

請用表格呈現：

| 項目 | 客戶指定規格 | 工程師版本 | 差異類型 | 影響程度 | 修正建議 |
|---|---|---|---|---|---|

## 二、修復 effort 評估

請評估把工程師版本修回客戶指定規格的 effort。

請分成：

- Low：單純欄位名稱、型別、格式修正，不影響資料流程
- Medium：需要調整 DTO、驗證邏輯、測試案例、文件或部分前後端對接
- High：牽涉 DB schema、資料轉換流程、前端畫面、第三方系統、部署流程或客戶端整合
- Critical：已經接近上版，且錯誤會造成客戶端無法串接、資料解析失敗、上版延期或客訴

請說明：

- 預估修正範圍
- 可能受影響模組
- 必須補測的測試項目
- 是否需要通知客戶
- 是否建議 freeze 工程師版本，直接回復客戶格式

## 三、風險分析

請判斷這次偏差可能造成的風險：

- 客戶端解析失敗
- API contract 破壞
- 上版延期
- 測試資料失效
- 文件與實作不一致
- 前後端或第三方系統對接失敗
- 對外承諾失信
- 後續維護成本增加

請用 High / Medium / Low 標示每個風險。

## 四、工程師誤解點分析

請根據差異判斷工程師可能在哪裡聽不懂或誤解需求。

請特別分析：

- 他是否把「不可變更的客戶格式」誤解成「可以參考後自行設計」
- 他是否把「實作任務」誤解成「API 設計任務」
- 他是否沒有理解 API contract 的穩定性
- 他是否低估臨上版前修改格式的風險
- 他是否把個人偏好的資料結構凌駕於客戶指定格式
- 他是否缺乏對外部系統串接成本的理解

請避免只罵人，請具體指出是哪一種認知偏差。

## 五、主管可採取的處理建議

請輸出主管可以直接採取的行動：

1. 立即修正建議
2. 短期避免再次出包的檢查清單
3. 下次交付前必須要求工程師確認的事項
4. 是否需要設立 API contract lock / schema diff / contract test
5. 是否需要禁止工程師在未核准下自行改 API 格式

## 六、結論

請用三段話總結：

1. 這次問題的本質是什麼
2. 修復 effort 與風險等級
3. 工程師真正卡住的點是什麼
更多精彩文章，盡在純靠北工程師。

---

純靠北工程師 版權宣告

最後更新日期：2025年9月25日

---

【重要條款更新通知】

本次宣告更新包含溯及既往條款。自 2025年10月1日 起，所有內容將適用最新的「專屬授權」條款。針對在此之前發布的內容，原投稿人若不同意新條款，可「隨時」聯繫本網站管理員申請下架。詳情請見第六條。

---

歡迎使用純靠北工程師（以下簡稱「本網站」）。提交任何內容至本網站前，請詳細閱讀本版權宣告。一旦提交，即代表您已同意並接受所有條款。

第一條：網站程式碼與設計

本網站之軟體、原始程式碼、網站架構與網頁設計，係依據 MIT License 開源授權。此授權範圍不包含本網站之商標（如「純靠北工程師」名稱與標誌），亦不包含任何使用者投稿內容。

第二條：使用者投稿內容之專屬授權

1. 著作權歸屬：您所投稿原創內容之著作權，仍歸屬於您本人。
2. 專屬授權（Exclusive License）：您一旦投稿，即同意授予本網站一份「專屬、無償、永久、不可撤銷且可轉授權」的權利。此授權包含：
   • 獨家權利：僅有本網站能在全球範圍內，公開使用、散布、展示您的投稿內容。
   • 您的義務：作為專屬授權的對價，您不得再將「同一份」投稿內容，發布於任何其他公開平台，包含但不限於您的個人社群媒體或部落格。
   • 永久性：此授權為永久有效，無法撤銷。
   • 無償性：本網站使用您的內容不支付任何費用。
   • 可轉授權：本網站可將上述權利轉授權予第三方。
3. 內容保證：您保證投稿內容為原創，且未侵害任何第三方權利。若引發法律糾紛，將由您個人承擔全部責任。

第三條：內容使用與分享

1. 允許的分享：內容可透過本網站的「分享」功能或頁面網址進行分享。所有分享皆須清楚標示來源為「純靠北工程師」。
2. 禁止的行為：除前項允許的分享方式外，嚴格禁止任何人（包含原投稿人）以複製、截圖、下載等方式，重製或轉載本網站的任何內容。

第四條：本網站之權利與責任

1. 侵權維護：基於此專屬授權，當第三方盜用或抄襲投稿內容時，本網站有權以自身名義採取警告、訴訟等法律行動。
2. 免責聲明：本網站為匿名平台，無法審核內容之真實性與合法性。所有內容僅代表投稿人立場，與本網站無關。
3. 侵權通知：若您認為網站上有內容侵害您的著作權，請與我們聯繫，我們將依法處理。

第五條：法律責任與條款修改

任何違反本宣告之行為，均屬侵權或違約，本網站將保留法律追訴權，並要求賠償所有損失（含律師費與訴訟費用）。本網站有權隨時修改本宣告，修改後將直接公布於網站，不另行通知。建議您定期查看最新條款。

第六條：條款溯及既往與權利區分

1. 效力溯及：本版權宣告（特別是第二條之專屬授權），將溯及既往適用於所有曾發布於本網站的內容。
2. 新舊文章之權利區分：
   • 關於 2025年10月1日 前發布之內容：若您是此日期前發布內容的原投稿人且不同意本宣告之專屬授權條款，您隨時有權聯繫本網站管理員，在提供適當證明後申請下架您的投稿。在您申請下架前，該內容將依本宣告條款進行管理。
   • 關於 2025年10月1日 (含當日) 起發布之內容：所有在此日期後送出的投稿，一經發布即代表投稿人已閱讀、理解並同意本宣告的所有條款，此專屬授權為永久且不可撤銷。