符合台灣
Pull Request 描述自動生成指令|讓 Reviewer 一眼看懂你改了什麼
一句話結論輸入改動目的、影響範圍與測試方式,AI 幫你產出結構完整的 PR 描述,讓 Code Review 不再卡在「這個 PR 到底在幹嘛」的困惑,提升整個團隊的審查效率。
指令介紹
工程師最常被 reviewer 嗆的一句話是:「你這個 PR 在幹嘛?」不是你改錯了,是你沒說清楚。寫一份好的 PR 描述其實比你想的重要得多——它決定了 review 速度、合作品質,甚至未來維護時能不能快速理解當初的決策。這組指令幫你把腦中已經想清楚的事,轉換成讓 reviewer 秒懂的標準格式,省時又專業。
適用情境
PR描述Code Review技術協作GitHub Flow
懶人貼上・複製就能用
已填好範例複製就能直接用
▸ 想換成你自己的內容?點開填一填選填
AI 指令庫編輯的話
編輯實測好的 PR 描述把「決策過程」和「驗證路徑」都寫進去,reviewer 不需要來回問問題就能安心 approve;標準化格式還能讓未來做 rollback 或 postmortem 時,快速重建當初的改動脈絡。 這組「Pull Request 描述自動生成指令|讓 Reviewer 一眼看懂你改了什麼」是 Prompts 編輯團隊實測整理的職場 AI 指令(Prompt),適合用 ChatGPT、Claude 執行,特別適合「0」等台灣在地場景。複製上方指令範本即可使用,免費、免註冊。
模型實測對照
## 📋 Why
舊版使用 session cookie 管理登入狀態,在多服務架構下造成 sticky session 問題,且無法支援行動端 API 呼叫。本次改用 JWT + refresh token 機制,提升擴展性與安全性。
## 🔧 What
- 移除 express-session 與 connect-mongo 依賴
- 新增 `POST /auth/refresh` endpoint,接受 refresh token 換發新 access token
- 更新 auth middleware:攔截 401 並自動 trigger refresh 流程
- 前端 axios interceptor 改為 retry 機制
## ⚠️ 注意事項
- **Breaking change**:舊版 session cookie 在部署後立即失效,所有用戶需重新登入
- 需確認 Redis 環境變數 `REFRESH_TOKEN_SECRET` 已設定
- 若有其他 service 呼叫 `/auth/me`,需確認 header 改為 Bearer token
## ✅ 測試確認清單
- [ ] 登入後 access token 15 分鐘後過期,能自動 refresh
- [ ] refresh token 30 天後過期,回到登入頁
- [ ] 登出後呼叫 `/auth/refresh` 回傳 401
- [ ] Jest unit test 全數通過
## 📸 截圖
請附上 Network tab 顯示 refresh token 自動補發的截圖
實測(ChatGPT):Why/What/注意事項三段清楚拆開,reviewer 能快速判斷風險與合併時機,Breaking change 警示明顯,格式可直接貼 GitHub。
產出標準 PR 描述,含 Why 背景說明、What 改動條列、Breaking change 警示(舊 session 失效、需重新登入)、四項測試確認 checkbox,以及截圖提示位置,格式符合 GitHub markdown。
實測(Claude):把 Breaking change 的用戶影響明確標注,讓 reviewer 在 approve 前就能預先協調部署時機,降低上線風險。
為這個指令評分
常見問題
PR 描述需要中文還是英文?
依團隊習慣。若團隊是台灣本地工程師,可在 body 欄位加上「請用中英混用,技術詞保留英文」;若有外籍成員,改為「全英文」即可。
如果 PR 很小(只改一行),還需要這麼複雜的格式嗎?
小 PR 可縮減為 Why + What 兩段即可,但 Breaking change 與測試確認清單仍建議保留,避免漏掉隱性影響。
相關指令
猜你喜歡
每週 5 組最新台灣 AI 指令,寄到你信箱
免費訂閱電子報,第一時間收到新指令與實測心得;現在訂閱立即領取「50 組必備 AI 指令懶人包」。
訂閱成功!懶人包連結已寄到你的信箱,請收信。
不寄垃圾信,隨時可取消訂閱。