1. 為什么需要一張“提問(wèn)急救卡”寫代碼這件事卡住的時(shí)候往往不是不會(huì)寫而是不知道該問(wèn)什么。我見(jiàn)過(guò)太多同行包括我自己早期遇到報(bào)錯(cuò)就把整段代碼甩進(jìn)對(duì)話框配一句“這為啥報(bào)錯(cuò)”然后等一個(gè)不知道能不能用的答案。結(jié)果要么對(duì)方回一句“信息不夠”要么給出一段看似合理但跑不通的代碼來(lái)回拉扯半小時(shí)問(wèn)題還在原地。Codex 類工具本質(zhì)上是一個(gè)“按你給的上下文推理”的系統(tǒng)。它不會(huì)讀心也不會(huì)主動(dòng)去翻你的項(xiàng)目結(jié)構(gòu)。你給它的信息越模糊它只能靠猜猜錯(cuò)了你就得花更多輪對(duì)話去糾正。所以真正決定效率的不是模型多強(qiáng)而是你怎么問(wèn)。這張“提問(wèn)急救卡”就是解決這個(gè)問(wèn)題的。它是一套可以隨身帶著用的提問(wèn)模板覆蓋了日常開發(fā)里最高頻的 7 種場(chǎng)景報(bào)錯(cuò)排查、代碼解釋、重構(gòu)建議、補(bǔ)測(cè)試、寫正則、性能優(yōu)化、跨語(yǔ)言翻譯。每個(gè)模板都規(guī)定了“必須給什么信息、按什么順序給、要它輸出什么格式”。再配合組合寫法把兩三個(gè)模板疊在一起用就能應(yīng)付絕大多數(shù)復(fù)雜需求。適合誰(shuí)來(lái)參考如果你是剛接觸 AI 輔助編程的新手這套模板能幫你少走很多彎路避免“問(wèn)了等于沒(méi)問(wèn)”如果你已經(jīng)用了一段時(shí)間但總覺(jué)得回答質(zhì)量忽高忽低那問(wèn)題多半出在提問(wèn)結(jié)構(gòu)上這套東西能幫你把輸出穩(wěn)定下來(lái)。下面我按“設(shè)計(jì)思路—模板拆解—組合寫法—排查技巧”的順序把這張卡完整拆開講。2. 整體設(shè)計(jì)思路把提問(wèn)當(dāng)成一次接口調(diào)用2.1 提問(wèn)的本質(zhì)是構(gòu)造上下文我習(xí)慣把每一次提問(wèn)看成一次函數(shù)調(diào)用。你傳進(jìn)去的參數(shù)決定了返回值的質(zhì)量。參數(shù)太少函數(shù)只能返回默認(rèn)值或者拋異常參數(shù)結(jié)構(gòu)清晰返回值才穩(wěn)定可控。一個(gè)高質(zhì)量的提問(wèn)通常包含四個(gè)部分角色設(shè)定、任務(wù)描述、上下文材料、輸出約束。角色設(shè)定告訴它“你現(xiàn)在是誰(shuí)”比如“你是一個(gè)熟悉 Python 異步編程的資深工程師”任務(wù)描述說(shuō)清楚“要干什么”比如“幫我找出這段代碼里的競(jìng)態(tài)條件”上下文材料是代碼、報(bào)錯(cuò)、環(huán)境信息輸出約束則是“用表格列出來(lái)”“只給修改后的代碼不要解釋”。很多人只給了任務(wù)描述其余三塊全缺。這就好比調(diào)用一個(gè)函數(shù)只傳了一個(gè)參數(shù)剩下的全靠默認(rèn)值結(jié)果自然不可控。2.2 為什么是這 7 個(gè)模板這 7 個(gè)模板不是拍腦袋定的是我統(tǒng)計(jì)了自己和身邊同行過(guò)去半年里高頻提問(wèn)類型之后歸納出來(lái)的。排在前面的分別是看不懂報(bào)錯(cuò)、看不懂別人寫的代碼、想重構(gòu)但怕改壞、不想手寫測(cè)試、正則寫不出來(lái)、跑得太慢、要把一段邏輯換語(yǔ)言實(shí)現(xiàn)。這七類基本覆蓋了日常開發(fā) 80% 以上的求助場(chǎng)景。每個(gè)模板的設(shè)計(jì)都遵循一個(gè)原則把“它需要猜的東西”降到最低。比如報(bào)錯(cuò)模板里強(qiáng)制要求貼完整堆棧和最小復(fù)現(xiàn)代碼就是為了避免它去猜你的運(yùn)行環(huán)境重構(gòu)模板里要求先說(shuō)明“不能改變的外部行為”就是為了防止它順手把你的接口簽名改了。2.3 模板不是死規(guī)矩是骨架需要強(qiáng)調(diào)一點(diǎn)模板是骨架不是鐐銬。真正用起來(lái)的時(shí)候你完全可以根據(jù)情況增減。比如一個(gè)特別簡(jiǎn)單的報(bào)錯(cuò)可能不需要貼完整項(xiàng)目結(jié)構(gòu)一個(gè)復(fù)雜的性能問(wèn)題可能要在模板基礎(chǔ)上再加一段壓測(cè)數(shù)據(jù)。模板的價(jià)值在于給你一個(gè)“不會(huì)漏掉關(guān)鍵信息”的檢查清單而不是讓你機(jī)械填空。我自己的習(xí)慣是先把模板背個(gè)大概用熟之后就不再逐字對(duì)照而是形成條件反射一遇到報(bào)錯(cuò)手就自動(dòng)去復(fù)制堆棧、圈出出錯(cuò)行、寫一句預(yù)期行為。這個(gè)反射建立起來(lái)之后提問(wèn)效率會(huì)有質(zhì)的提升。3. 七個(gè)常用模板逐個(gè)拆解3.1 模板一報(bào)錯(cuò)排查模板這是使用頻率最高的一個(gè)。核心結(jié)構(gòu)是“環(huán)境 報(bào)錯(cuò) 最小復(fù)現(xiàn) 預(yù)期行為”?！经h(huán)境】語(yǔ)言/框架版本、操作系統(tǒng)、依賴版本 【報(bào)錯(cuò)】完整堆棧信息不要截?cái)?【最小復(fù)現(xiàn)】能觸發(fā)該報(bào)錯(cuò)的最短代碼 【預(yù)期行為】我原本希望它做什么 【已嘗試】我已經(jīng)試過(guò)哪些方法結(jié)果如何為什么要求“最小復(fù)現(xiàn)”因?yàn)橥暾?xiàng)目里往往有幾十個(gè)文件模型很難判斷哪一行才是關(guān)鍵。你把范圍縮到最小它就能精準(zhǔn)定位。我試過(guò)同一個(gè)報(bào)錯(cuò)貼整個(gè)文件時(shí)它給了五個(gè)可能原因貼最小復(fù)現(xiàn)后它直接指出是某個(gè)庫(kù)的版本不兼容。“已嘗試”這一欄也特別重要。它能避免模型重復(fù)推薦你已經(jīng)試過(guò)的方法也能讓它在你失敗的方向上換思路。實(shí)測(cè)下來(lái)加上這一欄之后有效回答的比例明顯上升。注意堆棧信息一定要貼全尤其是最底部的Caused by部分。很多人只貼第一行結(jié)果模型只能給出泛泛的猜測(cè)。3.2 模板二代碼解釋模板接手老項(xiàng)目或者讀開源代碼時(shí)特別有用。結(jié)構(gòu)是“代碼 關(guān)注點(diǎn) 輸出格式”?！敬a】需要解釋的代碼段 【背景】這段代碼在項(xiàng)目里大概負(fù)責(zé)什么 【關(guān)注點(diǎn)】我最想搞懂的是哪部分如這個(gè)裝飾器的作用、這個(gè)狀態(tài)機(jī)怎么流轉(zhuǎn) 【輸出格式】按執(zhí)行順序逐段解釋每段配一句“它在干什么”關(guān)鍵在于“關(guān)注點(diǎn)”。如果你只說(shuō)“解釋這段代碼”它可能從第一行變量聲明開始講講了一堆你早就懂的東西。你明確說(shuō)“我只關(guān)心這個(gè)回調(diào)為什么是異步的”它就會(huì)把火力集中在那里。我個(gè)人的經(jīng)驗(yàn)是解釋模板配合“讓它畫一個(gè)執(zhí)行順序的文字版”效果很好。雖然不能用圖表但讓它用編號(hào)列表把調(diào)用順序列出來(lái)理解起來(lái)比純文字快得多。3.3 模板三重構(gòu)建議模板重構(gòu)最怕的是改出 bug。所以這個(gè)模板的核心是“約束邊界”?！粳F(xiàn)狀】當(dāng)前代碼 我覺(jué)得哪里不好如嵌套太深、重復(fù)邏輯多 【約束】不能改變的外部行為如函數(shù)簽名不變、返回結(jié)構(gòu)不變 【目標(biāo)】希望達(dá)到的效果如降低圈復(fù)雜度、提取公共函數(shù) 【輸出】給出重構(gòu)后代碼 改動(dòng)點(diǎn)說(shuō)明 潛在風(fēng)險(xiǎn)提示“約束”這一欄是靈魂。你不說(shuō)清楚它可能為了“優(yōu)雅”把你的同步函數(shù)改成異步或者把返回值從列表改成生成器調(diào)用方直接崩掉。我踩過(guò)這個(gè)坑后來(lái)每次都把“不能動(dòng)的東西”寫在最前面。“潛在風(fēng)險(xiǎn)提示”也很有價(jià)值。好的重構(gòu)建議會(huì)告訴你“這個(gè)改動(dòng)在并發(fā)場(chǎng)景下需要額外注意”而不是只給你一段漂亮代碼就完事。3.4 模板四補(bǔ)測(cè)試模板寫測(cè)試枯燥但必要。這個(gè)模板幫你把這件事變得省力?！颈粶y(cè)代碼】需要測(cè)試的函數(shù)或類 【測(cè)試框架】用的什么如 pytest、jest 【覆蓋要求】需要覆蓋哪些分支正常、邊界、異常 【輸出】可直接運(yùn)行的測(cè)試代碼 每個(gè)用例的意圖說(shuō)明“覆蓋要求”決定了測(cè)試的完整度。你只說(shuō)“寫測(cè)試”它可能只給一個(gè)正常路徑的用例。你明確要求“邊界值和異常輸入都要覆蓋”它才會(huì)把空值、超長(zhǎng)輸入、類型錯(cuò)誤這些情況考慮進(jìn)去。我通常還會(huì)加一句“用參數(shù)化方式組織用例”這樣生成的測(cè)試更簡(jiǎn)潔后續(xù)加 case 也方便。3.5 模板五正則表達(dá)式模板正則這東西寫出來(lái)容易寫對(duì)難。模板結(jié)構(gòu)是“樣本 規(guī)則 邊界”?！緲颖尽啃枰ヅ涞淖址纠辽俳o 3 個(gè)正例和 3 個(gè)反例 【規(guī)則】用自然語(yǔ)言描述匹配規(guī)則 【邊界】哪些情況不應(yīng)該匹配 【輸出】正則表達(dá)式 逐段解釋 測(cè)試用例給正例和反例是關(guān)鍵。只給正例它可能寫出一個(gè)“能匹配但也會(huì)誤傷”的表達(dá)式。我試過(guò)匹配日志時(shí)間戳只給正例時(shí)它給的正則會(huì)把版本號(hào)也匹配進(jìn)去補(bǔ)了反例之后立刻就修正了?！爸鸲谓忉尅蹦軒湍泸?yàn)證它是不是真的理解了你的規(guī)則而不是碰巧湊出一個(gè)能跑的表達(dá)式。3.6 模板六性能優(yōu)化模板性能問(wèn)題最忌諱瞎猜。這個(gè)模板要求先量化?！粳F(xiàn)象】慢在哪里有多慢如這個(gè)接口 P99 是 800ms 【代碼】相關(guān)代碼段 【數(shù)據(jù)規(guī)?！枯斎霐?shù)據(jù)量級(jí)如單次處理 10 萬(wàn)條記錄 【已定位】是否已經(jīng)用工具定位到熱點(diǎn) 【約束】不能引入哪些新依賴、不能改變哪些行為 【輸出】?jī)?yōu)化方案 預(yù)期收益 代價(jià)分析“數(shù)據(jù)規(guī)?！苯?jīng)常被忽略但它直接影響方案選擇。處理一千條和處理一百萬(wàn)條優(yōu)化手段完全不同。你不說(shuō)規(guī)模它可能給你一個(gè)在小數(shù)據(jù)量下更快、在大數(shù)據(jù)量下反而更慢的方案?！按鷥r(jià)分析”是我特別看重的一欄。任何優(yōu)化都有代價(jià)可能是內(nèi)存換時(shí)間可能是代碼復(fù)雜度上升。讓它把代價(jià)說(shuō)清楚你才能做取舍。3.7 模板七跨語(yǔ)言翻譯模板把一段邏輯從一種語(yǔ)言搬到另一種語(yǔ)言時(shí)用?！驹凑Z(yǔ)言】如 Python 【目標(biāo)語(yǔ)言】如 Go 【源代碼】需要翻譯的代碼 【保留點(diǎn)】哪些習(xí)慣要保留如錯(cuò)誤處理風(fēng)格、命名規(guī)范 【注意】目標(biāo)語(yǔ)言里需要特別處理的點(diǎn)如并發(fā)模型差異 【輸出】翻譯后代碼 差異說(shuō)明“保留點(diǎn)”和“注意”是精髓。不同語(yǔ)言的慣用法差別很大直譯往往寫出“用 Python 思維寫的 Go 代碼”。你明確說(shuō)“按目標(biāo)語(yǔ)言的慣用寫法來(lái)”它才會(huì)用地道的寫法實(shí)現(xiàn)。我一般還會(huì)要求它“指出源語(yǔ)言里哪些寫法在目標(biāo)語(yǔ)言中不推薦”這能幫我順便學(xué)到目標(biāo)語(yǔ)言的最佳實(shí)踐。4. 組合寫法把模板疊起來(lái)用4.1 為什么需要組合真實(shí)場(chǎng)景很少只涉及單一需求。比如你遇到一個(gè)報(bào)錯(cuò)排查完發(fā)現(xiàn)是性能問(wèn)題優(yōu)化完又想補(bǔ)個(gè)測(cè)試防止回歸。這時(shí)候單個(gè)模板就不夠用了需要把幾個(gè)模板按順序組合起來(lái)。組合的核心邏輯是前一個(gè)模板的輸出作為后一個(gè)模板的輸入。這樣每一輪對(duì)話都有明確的產(chǎn)出不會(huì)發(fā)散。4.2 三種高頻組合套路第一種是“排查 重構(gòu)”。先用報(bào)錯(cuò)模板定位問(wèn)題確認(rèn)是代碼結(jié)構(gòu)導(dǎo)致的再切到重構(gòu)模板把“約束”設(shè)為“修復(fù)該報(bào)錯(cuò)的同時(shí)不改變其他行為”。這樣一輪下來(lái)問(wèn)題解決了代碼也順帶優(yōu)化了。第二種是“解釋 補(bǔ)測(cè)試”。讀不懂的代碼先解釋清楚理解之后立刻讓它基于解釋生成測(cè)試。因?yàn)榻忉屵^(guò)程中它已經(jīng)理解了代碼意圖生成的測(cè)試會(huì)更貼合真實(shí)邏輯而不是只覆蓋表面分支。第三種是“性能 翻譯”。一段慢代碼優(yōu)化完如果打算遷移到別的語(yǔ)言可以直接接翻譯模板把優(yōu)化后的版本作為源材料。這樣遷移過(guò)去的就是優(yōu)化后的邏輯而不是把老問(wèn)題一起搬過(guò)去。4.3 組合時(shí)的銜接話術(shù)組合的關(guān)鍵在于銜接。不要重新開一段對(duì)話而是在同一輪里說(shuō)“基于上面的分析接下來(lái)……”。這樣模型能保留前面的上下文不用你重復(fù)貼代碼。我常用的銜接句式是“基于你剛才定位到的這個(gè)熱點(diǎn)現(xiàn)在幫我按目標(biāo)語(yǔ)言的慣用寫法重寫注意保留原有的錯(cuò)誤處理邏輯。”一句話就把上下文和約束都帶上了。提示組合模板時(shí)輪次不要太多。一般兩到三個(gè)模板疊加就夠了超過(guò)三個(gè)容易讓上下文變得混亂模型反而抓不住重點(diǎn)。5. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 回答質(zhì)量忽高忽低怎么辦最常見(jiàn)的原因是上下文不一致。同一段代碼你第一次貼了完整文件第二次只貼了片段模型的理解就會(huì)漂移。解決辦法是在同一輪對(duì)話里保持材料一致需要補(bǔ)充信息時(shí)用“補(bǔ)充”而不是“重新開始”。另一個(gè)原因是提問(wèn)里混入了太多無(wú)關(guān)信息。比如你問(wèn)一個(gè)報(bào)錯(cuò)卻把整個(gè)項(xiàng)目的目錄結(jié)構(gòu)都貼上去模型可能被無(wú)關(guān)文件干擾。這時(shí)候要果斷做減法只留最小必要信息。5.2 它給的代碼跑不通怎么排查先看它有沒(méi)有遵守你的“約束”。很多時(shí)候跑不通是因?yàn)樗那母牧撕瘮?shù)簽名或者依賴版本。其次看它假設(shè)的環(huán)境和你的是否一致比如它默認(rèn)用了某個(gè)新版本才有的語(yǔ)法。我的習(xí)慣是拿到代碼后先不急著跑而是快速掃一遍它有沒(méi)有引入新依賴、有沒(méi)有改動(dòng)接口。確認(rèn)這兩點(diǎn)沒(méi)問(wèn)題再放進(jìn)項(xiàng)目里測(cè)試。5.3 常見(jiàn)問(wèn)題速查表問(wèn)題現(xiàn)象可能原因處理方式回答很泛沒(méi)重點(diǎn)缺少關(guān)注點(diǎn)或輸出約束補(bǔ)上“我最關(guān)心的是……”和輸出格式代碼跑不通約束沒(méi)寫清它改了接口把“不能改變的行為”寫在最前面反復(fù)推薦已試過(guò)的方法沒(méi)寫“已嘗試”補(bǔ)上已嘗試列表和結(jié)果測(cè)試覆蓋不全沒(méi)寫覆蓋要求明確要求正常、邊界、異常都覆蓋正則誤匹配只給了正例補(bǔ)上反例和邊界說(shuō)明優(yōu)化方案不適用沒(méi)給數(shù)據(jù)規(guī)模補(bǔ)上輸入量級(jí)和已定位信息翻譯不地道沒(méi)寫保留點(diǎn)和注意事項(xiàng)明確要求按目標(biāo)語(yǔ)言慣用法5.4 幾個(gè)我踩過(guò)的坑第一個(gè)坑是“一次問(wèn)太多”。我曾經(jīng)在一個(gè)提問(wèn)里同時(shí)要求排查報(bào)錯(cuò)、重構(gòu)、補(bǔ)測(cè)試、寫文檔結(jié)果它每樣都只做了一半。后來(lái)我改成一次只聚焦一個(gè)主任務(wù)用組合寫法分輪推進(jìn)質(zhì)量立刻上來(lái)了。第二個(gè)坑是“不給反例”。寫正則和寫校驗(yàn)邏輯時(shí)只給正例幾乎必然導(dǎo)致誤匹配?，F(xiàn)在我養(yǎng)成了習(xí)慣任何匹配類需求都至少給三個(gè)反例。第三個(gè)坑是“忽略版本”。同一個(gè)庫(kù)不同版本行為可能完全不同?，F(xiàn)在我每次都會(huì)在環(huán)境里寫清楚版本號(hào)省去了大量“在我這能跑”的扯皮。6. 把急救卡變成肌肉記憶這套模板用熟之后你會(huì)發(fā)現(xiàn)提問(wèn)這件事變得像呼吸一樣自然。遇到問(wèn)題腦子里自動(dòng)就彈出對(duì)應(yīng)的結(jié)構(gòu)報(bào)錯(cuò)先貼堆棧和最小復(fù)現(xiàn)重構(gòu)先說(shuō)約束性能先給數(shù)據(jù)規(guī)模。整個(gè)過(guò)程不需要刻意回憶模板因?yàn)榻Y(jié)構(gòu)已經(jīng)內(nèi)化了。我個(gè)人的體會(huì)是提問(wèn)能力的提升本質(zhì)上是對(duì)“自己到底卡在哪”這件事的認(rèn)知提升。很多時(shí)候你以為自己不會(huì)問(wèn)其實(shí)是沒(méi)想清楚問(wèn)題出在哪。模板強(qiáng)迫你把問(wèn)題拆開、把信息補(bǔ)齊這個(gè)過(guò)程本身就在幫你理清思路。最后分享一個(gè)小技巧把你最常用的兩三個(gè)模板存成代碼片段或者輸入法快捷短語(yǔ)需要的時(shí)候一鍵調(diào)出只改中間的具體內(nèi)容。這個(gè)動(dòng)作能再省下不少時(shí)間尤其是報(bào)錯(cuò)排查這種高頻場(chǎng)景效果立竿見(jiàn)影。