新手推薦路徑摘要在 AI 輔助開發(fā)工具快速普及的今天新手面對(duì)最多的困惑往往不是工具夠不夠強(qiáng)而是我該從哪一步開始用。本文提出一條經(jīng)過實(shí)踐驗(yàn)證的三階段學(xué)習(xí)路徑先從 Ask問答式交互起步熟悉工具的脾氣再用 Plan計(jì)劃模式把控復(fù)雜任務(wù)的節(jié)奏最后信任 Agent智能體去執(zhí)行落地。文章會(huì)結(jié)合可運(yùn)行的代碼示例逐層拆解每個(gè)階段的目標(biāo)、典型用法、常見坑點(diǎn)與過渡信號(hào)幫助新手用最低的試錯(cuò)成本建立起對(duì) AI 編程工具的正確認(rèn)知。引言很多新手第一次打開 AI 編程工具時(shí)會(huì)直接丟一句幫我寫一個(gè)完整的電商后端然后對(duì)著生成的一大坨代碼發(fā)愣——不知道對(duì)不對(duì)、不敢改、更不敢上線。問題不在工具而在使用順序。AI 編程工具的能力大致可以拆成三層Ask 層你問它答。它像一個(gè)隨時(shí)在線的資深同事負(fù)責(zé)解釋、答疑、給片段。Plan 層你給目標(biāo)它拆步驟。它像一位項(xiàng)目經(jīng)理負(fù)責(zé)把模糊需求變成可執(zhí)行的清單。Agent 層你給任務(wù)它自己讀代碼、改文件、跑測(cè)試。它像一個(gè)能獨(dú)立干活的工程師。這三層不是越往后越好而是有先后依賴的。跳過 Ask 直接上 Agent你既看不懂它改了什么也無法判斷它對(duì)不對(duì)跳過 Plan 直接上 Agent復(fù)雜任務(wù)會(huì)跑偏且難以糾偏。本文按這條推薦路徑展開每一節(jié)都配有可直接運(yùn)行的示例。一、為什么新手必須從 Ask 起步1.1 Ask 階段的真正目標(biāo)Ask 階段的核心不是讓 AI 幫我寫代碼而是建立三個(gè)認(rèn)知認(rèn)知一模型的能力邊界。它擅長什么樣板代碼、正則、SQL、解釋報(bào)錯(cuò)不擅長什么涉及時(shí)效性的庫版本、你公司內(nèi)部約定。認(rèn)知二提問的質(zhì)量決定回答的質(zhì)量。模糊問題得到模糊答案這是新手最容易踩的坑。認(rèn)知三如何驗(yàn)證答案。AI 給的代碼不一定對(duì)你需要有能力跑一遍、讀一遍、判斷一遍。1.2 一個(gè)對(duì)比示例模糊提問 vs 結(jié)構(gòu)化提問假設(shè)你想實(shí)現(xiàn)防抖函數(shù)。新手常見的提問是幫我寫個(gè)防抖得到的答案可能是一個(gè)最簡版本沒有取消功能、沒有this綁定、沒有立即執(zhí)行選項(xiàng)。而結(jié)構(gòu)化提問用 TypeScript 實(shí)現(xiàn)一個(gè) debounce 函數(shù)要求1支持立即執(zhí)行選項(xiàng)immediate2返回函數(shù)上掛一個(gè)cancel方法3正確處理this指向4給出使用示例和單元測(cè)試。得到的代碼質(zhì)量完全不同。下面是一個(gè)符合上述要求的完整實(shí)現(xiàn)// debounce.tsexportinterfaceDebouncedFunctionTextends(...args:any[])any{(this:ThisParameterTypeT,...args:ParametersT):void;cancel():void;}exportfunctiondebounceTextends(...args:any[])any(fn:T,wait:number,immediatefalse):DebouncedFunctionT{lettimer:ReturnTypetypeofsetTimeout|nullnull;constdebouncedfunction(this:ThisParameterTypeT,...args:ParametersT){constcontextthis;constlater(){timernull;if(!immediate)fn.apply(context,args);};constcallNowimmediatetimernull;// 每次調(diào)用都重置計(jì)時(shí)器if(timer!null)clearTimeout(timer);timersetTimeout(later,wait);// immediate 模式下首次調(diào)用立即執(zhí)行if(callNow)fn.apply(context,args);}asDebouncedFunctionT;debounced.cancel(){if(timer!null){clearTimeout(timer);timernull;}};returndebounced;}配套的單元測(cè)試使用 Vitest可直接運(yùn)行// debounce.test.tsimport{describe,it,expect,vi,beforeEach,afterEach}fromvitest;import{debounce}from./debounce;describe(debounce,(){beforeEach(()vi.useFakeTimers());afterEach(()vi.useRealTimers());it(延遲執(zhí)行多次調(diào)用只執(zhí)行最后一次,(){constfnvi.fn();constddebounce(fn,100);d();d();d();expect(fn).not.toHaveBeenCalled();vi.advanceTimersByTime(100);expect(fn).toHaveBeenCalledTimes(1);});it(immediate 模式下首次立即執(zhí)行,(){constfnvi.fn();constddebounce(fn,100,true);d();expect(fn).toHaveBeenCalledTimes(1);d();expect(fn).toHaveBeenCalledTimes(1);// 窗口期內(nèi)不重復(fù)執(zhí)行});it(cancel 能取消待執(zhí)行的調(diào)用,(){constfnvi.fn();constddebounce(fn,100);d();d.cancel();vi.advanceTimersByTime(200);expect(fn).not.toHaveBeenCalled();});});1.3 Ask 階段的練習(xí)方法建議每天做三件事拿真實(shí)報(bào)錯(cuò)去問而不是自己猜。把完整堆棧貼進(jìn)去問這個(gè)報(bào)錯(cuò)的原因是什么、怎么修、為什么。要求解釋而非只給答案。追問為什么這樣寫、“有沒有別的寫法”這是積累判斷力的關(guān)鍵。手動(dòng)驗(yàn)證每個(gè)答案。跑一遍、改一個(gè)邊界條件看它會(huì)不會(huì)掛。這一步不能省。1.4 何時(shí)可以進(jìn)入下一階段當(dāng)你發(fā)現(xiàn)自己能預(yù)判 AI 大概會(huì)怎么答、并且能一眼看出答案里的問題時(shí)Ask 階段就基本畢業(yè)了。此時(shí)你會(huì)自然產(chǎn)生新需求“這個(gè)功能涉及五六個(gè)文件一句句問太累了”——這就是進(jìn)入 Plan 階段的信號(hào)。二、Plan 階段用計(jì)劃把控復(fù)雜任務(wù)2.1 什么算復(fù)雜任務(wù)一個(gè)經(jīng)驗(yàn)判據(jù)如果任務(wù)的完成需要改動(dòng)超過 3 個(gè)文件或者需要你先想清楚步驟才能動(dòng)手就屬于復(fù)雜任務(wù)。典型場(chǎng)景包括重構(gòu)一個(gè)模塊、給現(xiàn)有系統(tǒng)加一個(gè)橫切功能如日志、鑒權(quán)、遷移一個(gè)庫的版本。這類任務(wù)的失敗模式高度一致——方向錯(cuò)了越努力越糟。Plan 階段的價(jià)值就是在動(dòng)手前把方向?qū)R。2.2 Plan 的產(chǎn)出物一份可執(zhí)行的任務(wù)清單好的計(jì)劃不是一段散文而是可勾選、可驗(yàn)證、有依賴順序的清單。以給 Express 應(yīng)用加上請(qǐng)求級(jí)日志與耗時(shí)統(tǒng)計(jì)為例一份合格的計(jì)劃長這樣## 任務(wù)為 Express 應(yīng)用添加請(qǐng)求日志與耗時(shí)統(tǒng)計(jì) ### 前置調(diào)研 - [ ] 確認(rèn)現(xiàn)有中間件注冊(cè)順序app.ts 第 20-40 行 - [ ] 確認(rèn)日志庫選型項(xiàng)目已依賴 winston復(fù)用而非新增 ### 實(shí)施步驟 - [ ] 1. 新建 src/middleware/requestLogger.ts - [ ] 2. 在 app.ts 中于路由注冊(cè)之前掛載該中間件 - [ ] 3. 為每個(gè)請(qǐng)求生成 requestId使用 crypto.randomUUID - [ ] 4. 記錄 method / path / status / duration - [ ] 5. 將 requestId 透?jìng)鞯巾憫?yīng)頭 X-Request-Id ### 驗(yàn)證 - [ ] 單元測(cè)試中間件對(duì) 200 與 500 響應(yīng)均能正確記錄 - [ ] 手動(dòng)驗(yàn)證curl 一次接口檢查日志字段完整2.3 計(jì)劃對(duì)應(yīng)的實(shí)現(xiàn)代碼下面是與上述計(jì)劃對(duì)應(yīng)的完整可運(yùn)行實(shí)現(xiàn)// src/middleware/requestLogger.tsimport{Request,Response,NextFunction}fromexpress;import{randomUUID}fromcrypto;importwinstonfromwinston;constloggerwinston.createLogger({level:info,format:winston.format.json(),transports:[newwinston.transports.Console()],});exportfunctionrequestLogger(req:Request,res:Response,next:NextFunction){constrequestIdrandomUUID();conststartprocess.hrtime.bigint();// 透?jìng)鞯巾憫?yīng)頭便于前端排查res.setHeader(X-Request-Id,requestId);// 響應(yīng)結(jié)束時(shí)統(tǒng)一記錄保證能拿到最終 statusres.on(finish,(){constdurationMsNumber(process.hrtime.bigint()-start)/1e6;logger.info(request,{requestId,method:req.method,path:req.originalUrl,status:res.statusCode,durationMs:Number(durationMs.toFixed(2)),});});next();}// src/app.tsimportexpressfromexpress;import{requestLogger}from./middleware/requestLogger;constappexpress();// 關(guān)鍵日志中間件必須在路由之前注冊(cè)否則路由內(nèi)的響應(yīng)不會(huì)被統(tǒng)計(jì)app.use(requestLogger);app.get(/health,(_req,res)res.json({ok:true}));app.get(/boom,(){thrownewError(intentional error);});app.listen(3000,()console.log(listening on :3000));2.4 Plan 階段的三條紀(jì)律先調(diào)研再列步驟。讓 AI 先讀相關(guān)文件、輸出現(xiàn)狀理解你確認(rèn)無誤后再讓它出計(jì)劃。計(jì)劃要能被人讀懂。如果計(jì)劃里出現(xiàn)優(yōu)化一下相關(guān)邏輯這種模糊表述打回去重寫。一個(gè)步驟一個(gè)驗(yàn)證點(diǎn)。沒有驗(yàn)證方式的步驟等于沒有步驟。2.5 何時(shí)可以進(jìn)入下一階段當(dāng)你發(fā)現(xiàn)計(jì)劃本身已經(jīng)足夠清晰、剩下的只是按部就班敲代碼并且你已經(jīng)能信任 AI 在這個(gè)清晰邊界內(nèi)自主執(zhí)行時(shí)就可以進(jìn)入 Agent 階段了。注意信任的是邊界清晰的執(zhí)行不是無腦放手。三、Agent 階段在清晰邊界內(nèi)信任執(zhí)行3.1 Agent 與 Ask/Plan 的本質(zhì)區(qū)別Ask 是你說一句它答一句Plan 是它給你清單你確認(rèn)Agent 是它自己讀文件、改文件、跑測(cè)試、根據(jù)結(jié)果調(diào)整。Agent 的能力來自工具調(diào)用循環(huán)讀 → 想 → 改 → 跑 → 看結(jié)果 → 再改。這也意味著 Agent 的風(fēng)險(xiǎn)點(diǎn)在于它會(huì)真的修改你的文件。所以進(jìn)入 Agent 階段的前提是邊界已經(jīng)由 Plan 階段界定清楚。3.2 一個(gè) Agent 任務(wù)的最小示例假設(shè) Plan 階段已經(jīng)確認(rèn)要在utils/下新增一個(gè)retry.ts實(shí)現(xiàn)帶指數(shù)退避的異步重試并配套測(cè)試不改動(dòng)其他文件。給 Agent 的任務(wù)描述應(yīng)該長這樣任務(wù)邊界只允許在 src/utils/ 目錄下新增文件不得修改其他目錄。 目標(biāo)實(shí)現(xiàn) retry(fn, options) 異步重試工具。 要求 - 參數(shù)fn 為返回 Promise 的函數(shù)options 含 retries、baseDelay、maxDelay、shouldRetry - 指數(shù)退避第 n 次重試等待 min(baseDelay * 2^n, maxDelay) - shouldRetry(err, attempt) 返回 false 時(shí)立即拋出 - 配套單元測(cè)試覆蓋成功、重試后成功、耗盡重試、shouldRetry 攔截四種情況 完成標(biāo)準(zhǔn)npm test 全綠且 git diff 只顯示 src/utils/ 下的新增文件。Agent 產(chǎn)出的實(shí)現(xiàn)大致如下// src/utils/retry.tsexportinterfaceRetryOptions{retries?:number;baseDelay?:number;maxDelay?:number;shouldRetry?:(err:unknown,attempt:number)boolean;}constsleep(ms:number)newPromise((r)setTimeout(r,ms));exportasyncfunctionretryT(fn:()PromiseT,options:RetryOptions{}):PromiseT{const{retries3,baseDelay100,maxDelay5000,shouldRetry()true,}options;letlastErr:unknown;for(letattempt0;attemptretries;attempt){try{returnawaitfn();}catch(err){lastErrerr;// 最后一次嘗試失敗或調(diào)用方明確不重試直接拋出if(attemptretries||!shouldRetry(err,attempt))throwerr;constdelayMath.min(baseDelay*2**attempt,maxDelay);awaitsleep(delay);}}// 理論上不可達(dá)僅為類型收窄throwlastErr;}配套測(cè)試// src/utils/retry.test.tsimport{describe,it,expect,vi}fromvitest;import{retry}from./retry;describe(retry,(){it(首次成功直接返回,async(){constfnvi.fn().mockResolvedValue(ok);awaitexpect(retry(fn,{baseDelay:1})).resolves.toBe(ok);expect(fn).toHaveBeenCalledTimes(1);});it(失敗后重試成功,async(){constfnvi.fn().mockRejectedValueOnce(newError(fail)).mockResolvedValue(ok);awaitexpect(retry(fn,{baseDelay:1})).resolves.toBe(ok);expect(fn).toHaveBeenCalledTimes(2);});it(耗盡重試后拋出最后的錯(cuò)誤,async(){constfnvi.fn().mockRejectedValue(newError(always));awaitexpect(retry(fn,{retries:2,baseDelay:1})).rejects.toThrow(always);expect(fn).toHaveBeenCalledTimes(3);// 1 次初始 2 次重試});it(shouldRetry 返回 false 時(shí)立即拋出,async(){constfnvi.fn().mockRejectedValue(newError(fatal));awaitexpect(retry(fn,{baseDelay:1,shouldRetry:()false})).rejects.toThrow(fatal);expect(fn).toHaveBeenCalledTimes(1);});});3.3 如何信任而不失控信任 Agent 的正確姿勢(shì)是用可驗(yàn)證的完成標(biāo)準(zhǔn)兜底而不是用人盯人的方式。具體做法給任務(wù)寫死邊界如只允許改 src/utils/Agent 越界時(shí)你能從 diff 里一眼看出。給完成標(biāo)準(zhǔn)寫死驗(yàn)證方式如npm test 全綠讓 Agent 自己跑、自己看結(jié)果、自己修。事后 review diff 而非 review 過程。過程交給 Agent結(jié)果由你驗(yàn)收。小步提交。每個(gè) Agent 任務(wù)對(duì)應(yīng)一個(gè) commit出問題能一鍵回滾。3.4 Agent 階段的典型坑邊界不清導(dǎo)致誤改沒寫只改某目錄Agent 順手重構(gòu)了無關(guān)文件?！?任務(wù)描述里顯式寫邊界。完成標(biāo)準(zhǔn)模糊只寫實(shí)現(xiàn)功能Agent 可能不寫測(cè)試就宣布完成。→ 完成標(biāo)準(zhǔn)必須可執(zhí)行、可驗(yàn)證。一次給太大任務(wù)把 Plan 階段整份清單丟給 Agent?！?拆成單個(gè)步驟逐個(gè)交給 Agent。四、三階段如何平滑銜接三個(gè)階段不是割裂的而是一條能力遞進(jìn)鏈。下面這張對(duì)照表幫你判斷自己處在哪、下一步該練什么階段你的角色AI 的角色核心產(chǎn)出畢業(yè)信號(hào)Ask提問者答疑同事可驗(yàn)證的代碼片段/解釋能預(yù)判并挑出答案的問題Plan決策者項(xiàng)目經(jīng)理可勾選的任務(wù)清單計(jì)劃清晰到只剩敲代碼Agent驗(yàn)收者執(zhí)行工程師通過驗(yàn)證的改動(dòng)能用邊界標(biāo)準(zhǔn)兜住自主執(zhí)行銜接的關(guān)鍵動(dòng)作是每個(gè)階段都留下可復(fù)用的資產(chǎn)Ask 階段留下的是一批好問題模板Plan 階段留下的是一份份任務(wù)清單Agent 階段留下的是一串小步 commit。這些資產(chǎn)會(huì)讓你在下一階段起步時(shí)不是從零開始。五、常見誤區(qū)與糾正誤區(qū)一跳過 Ask 直接上 Agent。糾正你無法驗(yàn)收你看不懂的東西。先花一周在 Ask 階段把工具脾氣摸熟。誤區(qū)二Plan 階段寫偽計(jì)劃。糾正計(jì)劃里每一步都要有驗(yàn)證方式。優(yōu)化性能不是步驟把列表接口的 N1 查詢改為批量查詢并用 EXPLAIN 確認(rèn)走了索引才是。誤區(qū)三Agent 階段全程盯著。糾正盯著過程說明你還不信任邊界。把精力放在寫清邊界和完成標(biāo)準(zhǔn)上過程放手。誤區(qū)四三個(gè)階段只用一種。糾正真實(shí)工作中三者是混用的。遇到陌生報(bào)錯(cuò)回到 Ask接到大需求先 Plan邊界清晰后交 Agent。總結(jié)新手使用 AI 編程工具最穩(wěn)妥的路徑是Ask → Plan → Agent的遞進(jìn)Ask 起步目的是建立對(duì)模型能力邊界、提問質(zhì)量、答案驗(yàn)證的三重認(rèn)知產(chǎn)出可驗(yàn)證的代碼片段Plan 居中目的是把復(fù)雜任務(wù)的模糊需求轉(zhuǎn)成可勾選、可驗(yàn)證、有依賴順序的任務(wù)清單在動(dòng)手前對(duì)齊方向Agent 收尾目的是在清晰邊界與可執(zhí)行完成標(biāo)準(zhǔn)的兜底下信任 AI 自主執(zhí)行并只驗(yàn)收結(jié)果。