一、長任務(wù)不要一口吃完

很多 Codex 任務(wù)失敗，不是因為 API 中轉(zhuǎn)站不穩(wěn)定，也不是模型能力不夠，而是任務(wù)一次性塞得太滿。比如“幫我重構(gòu)這個項目并寫完測試”，這句話背后包含理解架構(gòu)、定位入口、識別風險、修改代碼、補測試、運行驗證、寫說明等多個動作。

把這些動作一次性發(fā)給 Codex，模型會同時面對大量上下文和多個目標，很容易遺漏前提、誤改范圍，或者在輸出里混合分析和執(zhí)行。更穩(wěn)的方式，是把長任務(wù)拆成幾個短回合：先讓它看清楚，再讓它提出計劃，再讓它局部執(zhí)行，最后驗收結(jié)果。

靈能API 作為統(tǒng)一 API 中轉(zhuǎn)站入口，CC Switch 作為本地配置切換工具，可以支持不同階段使用不同模型和參數(shù)。任務(wù)拆開以后，模型選擇和預算控制也會更自然。

尤其是第一次在新項目里使用 Codex 時，不要急著讓它承擔最終結(jié)果。先把它當成一個會讀項目、會整理信息、會幫你拆問題的協(xié)作者。等它對項目邊界有了正確理解，再進入修改階段，整體質(zhì)量會穩(wěn)很多。

二、把任務(wù)拆成“看、想、改、驗、寫”五段

長任務(wù)最實用的拆法，是按動作順序分成五段：看、想、改、驗、寫。看，是讀取目錄和關(guān)鍵文件；想，是提出方案和風險；改，是只處理明確范圍內(nèi)的文件；驗，是運行或說明驗證方式；寫，是生成交付說明或復盤記錄。

這五段的好處是每一步都有清楚產(chǎn)物。看完以后你知道模型理解了什么；想完以后你能審計劃；改完以后能看差異；驗完以后知道結(jié)果；寫完以后能沉淀文檔。過程雖然多幾步，但出錯時很好回退。

• 看：只讀項目結(jié)構(gòu)、入口文件、配置文件，不做修改。
• 想：輸出方案、影響范圍、風險點和需要確認的問題。
• 改：每次只改一個模塊或一組相關(guān)文件。
• 驗：運行測試或列出人工驗收步驟。
• 寫：整理變更說明、注意事項和后續(xù)建議。

三、先從靈能API確認可用模型和入口

正式拆任務(wù)前，先進入 [靈能API](https://www.lnsns.com/) 確認可用模型、接口入口和當前賬號狀態(tài)。長任務(wù)比短問答更依賴上下文和穩(wěn)定性，最好不要在模型權(quán)限、余額或 *ase **L 不確定時直接開跑。

如果你準備處理跨文件任務(wù)，建議提前確定兩類配置：一類用于只讀分析，一類用于深度執(zhí)行。只讀分析可以更輕，深度執(zhí)行再切到更適合復雜推理的配置。這樣不會從第一步就把所有請求都放到高消耗線路上。

團隊文檔里可以把 https://www.lnsns.com/ 作為固定入口，但具體模型和接口字段應(yīng)以**當天展示為準。長任務(wù)的配置越明確，后續(xù)排障越輕松。

四、長任務(wù)先估算消耗，不要邊跑邊猜

長任務(wù)的消耗來自三件事：輸入上下文長度、模型復雜度、反復重試次數(shù)。如果你一次性讓 Codex 讀取大量文件，又要求它輸出完整方案和代碼，很可能一次請求就很重。

建議在任務(wù)開始前做一個輕量估算：這次需要讀多少文件？是否需要跨模塊理解？是否要生成測試？是否要運行命令？如果只是定位小問題，用輕配置即可；如果是架構(gòu)級分析，再切換到高能力配置。

• 短問題：先用輕量配置，快速得到方向。
• 跨文件任務(wù)：先做只讀摘要，再決定是否升級模型。
• 大型重構(gòu)：必須分階段，不建議一次性寫入。

五、在 CC Switch 中準備兩張長任務(wù)配置卡

建議在 CC Switch 里準備兩張配置卡：一張叫 lingneng-codex-read，用于只讀分析和計劃生成；一張叫 lingneng-codex-deep，用于復雜推理、跨文件分析和最終修改。兩張卡都可以走 靈能API 入口，但模型和用途要分開。

這樣做有兩個好處：第一，任務(wù)早期可以更輕更快；第二，當你決定進入復雜階段時，會有一個明確切換動作，提醒自己檢查目標、范圍和預算。不要讓高能力配置長期作為默認項，否則很容易把小問題也當成大任務(wù)處理。

如果團隊里有多人協(xié)作，還可以把兩張卡的用途寫進項目說明：read 卡只能做閱讀、摘要和方案；deep 卡只能在人工確認計劃后使用。這樣新人不會因為看到配置可用，就直接把大型修改交給高等級配置。

推薦配置卡：
lingneng-codex-read：目錄閱讀、錯誤初判、方案草稿
lingneng-codex-deep：跨文件推理、復雜修改、關(guān)鍵驗收
使用原則：先 read，確認必要后再 deep

?? 六、第一段提示詞只讓 Codex 看清楚

第一段不要要求 Codex 修改代碼。只讓它讀取項目結(jié)構(gòu)、判斷技術(shù)棧、找關(guān)鍵文件，并列出它還需要哪些信息。這個階段的產(chǎn)物不是代碼，而是理解邊界。

你可以要求它只輸出三件事：項目結(jié)構(gòu)判斷、可能相關(guān)文件、下一步需要讀取的文件。不要讓它在還沒看清楚時就下結(jié)論。尤其是大型倉庫，第一步越克制，后面越少返工。

這一段還有一個小技巧：讓 Codex 標明“確定”和“推測”。確定部分來自它已經(jīng)看到的文件，推測部分只是基于目錄名稱和常見框架判斷。把這兩類信息分開，能避免模型把猜測當事實繼續(xù)推進。

階段 1 提示詞：
請只讀取當前項目結(jié)構(gòu)，判斷技術(shù)棧和可能的入口文件。
不要修改任何文件，不要執(zhí)行安裝命令。
請輸出：項目類型、關(guān)鍵目錄、下一步建議讀取的文件。

? 七、第二段再讓它提出執(zhí)行計劃

當 Codex 已經(jīng)讀完關(guān)鍵文件后，再讓它提出計劃。計劃里必須包含修改范圍、預期影響、風險點、驗證方式和需要人工確認的問題。不要讓它直接進入修改，先把計劃拿出來審一遍。

如果計劃里出現(xiàn)“可能需要修改很多文件”“可能影響多個模塊”“需要確認業(yè)務(wù)規(guī)則”這類表述，就不要立刻批準全量修改。把任務(wù)繼續(xù)拆小，先做最小閉環(huán)。

計劃階段最好要求 Codex 給出“不做什么”。例如暫不改數(shù)據(jù)庫結(jié)構(gòu)、暫不調(diào)整公共接口、暫不刪除舊邏輯。很多長任務(wù)失控，就是因為邊界只寫了目標，沒有寫禁止范圍。

階段 2 提示詞：
基于剛才讀取的文件，請?zhí)岢鰣?zhí)行計劃。
計劃必須包含：修改范圍、風險點、驗證方式、需要我確認的問題。
暫時不要修改文件。

八、上下文分批時，每批只解決一個問題

分批不是把內(nèi)容隨便切碎，而是每一批都圍繞一個明確問題。比如第一批只看路由入口，第二批只看鑒權(quán)邏輯，第三批只看請求封裝。每批結(jié)束后，讓 Codex 總結(jié)它已經(jīng)確定的事實和仍不確定的地方。

這種方式很適合 API 中轉(zhuǎn)站接入后的長任務(wù)，因為它能減少單次請求壓力，也能讓你逐步控制方向。即使中途發(fā)現(xiàn)模型理解錯了，也只需要糾正當前批次，不會把整輪長輸出都推倒重來。

分批時還要保留一段“上一批摘要”。不要把上一次全部輸出原樣復制進下一次，而是壓縮成三五條事實。這樣上下文不會越來越臃腫，Codex 也能繼續(xù)沿著正確方向工作。

• 一批只看一個模塊。
• 一批只回答一個核心問題。
• 每批結(jié)束要總結(jié)已確認事實。
• 下一批開始前先確認是否繼續(xù)。

九、每個階段都要有小驗收

長任務(wù)最怕一路做到最后才發(fā)現(xiàn)方向錯了。每個階段都應(yīng)該設(shè)置小驗收：只讀階段驗收理解是否正確，計劃階段驗收范圍是否合理，修改階段驗收差異是否可控，測試階段驗收結(jié)果是否可信。

驗收提示詞也要短。比如“請只總結(jié)這次修改了哪些文件、為什么改、還有什么沒做”。不要讓它又開始擴展新任務(wù)。驗收的目的，是把當前階段收住。

如果當前階段沒有通過驗收，不要繼續(xù)下一階段。先讓 Codex 解釋失敗原因，再決定是補充上下文、縮小范圍，還是回退剛才的修改。長任務(wù)的節(jié)奏要像走樓梯，一階確認穩(wěn)了再上下一階。

階段驗收提示詞：
請只總結(jié)當前階段結(jié)果。
包括：已確認內(nèi)容、已修改內(nèi)容、未處理內(nèi)容、下一步建議。
不要繼續(xù)修改文件。

十、修改階段一次只開放小范圍

當你決定讓 Codex 修改文件時，范圍要盡量小。一次只處理一個函數(shù)、一組相關(guān)文件或一個明確 *ug。不要把“順便優(yōu)化一下結(jié)構(gòu)”“順便補全測試”“順便重寫文檔”都放進同一輪。

如果任務(wù)確實很大，可以拆成多個可提交單元。每個單元都有自己的目標、文件范圍和驗證方式。這樣即使某一步效果不好，也能只回退這一小段，而不是回退整個長任務(wù)。

• 一個 *ug 一輪。
• 一個模塊一輪。
• 一個測試缺口一輪。
• 一個文檔更新一輪。

十一、提示詞模板要區(qū)分階段

不要所有階段都使用同一段提示詞。只讀階段強調(diào)不要改文件；計劃階段強調(diào)風險和確認問題；修改階段強調(diào)文件范圍；驗收階段強調(diào)總結(jié)和測試結(jié)果。提示詞越貼合階段，輸出越穩(wěn)。

團隊可以把這些模板放進接入文檔里。新人接入 靈能API 和 CC Switch 后，不只是知道怎么配置，還知道長任務(wù)怎么問。這樣 Codex 使用習慣會更統(tǒng)一。

模板不需要寫得很華麗，關(guān)鍵是穩(wěn)定。每個模板都應(yīng)該包含目標、允許動作、禁止動作和輸出格式。只要這四項清楚，模型的自由發(fā)揮就會收斂在可控范圍內(nèi)。

模板分類：
read：只讀理解項目
plan：提出方案但不修改
patch：限定文件范圍執(zhí)行
verify：總結(jié)結(jié)果和測試
handoff：生成交接說明

十二、任務(wù)跑偏時不要繼續(xù)加要求

如果 Codex 已經(jīng)開始跑偏，最差的處理方式是繼續(xù)追加一堆要求。這樣上下文會更亂，模型會帶著錯誤假設(shè)繼續(xù)走。正確做法是停下來，讓它先復述當前目標、已知事實和不該做的事。

必要時重新開一個更短的任務(wù)，只帶關(guān)鍵上下文。API 中轉(zhuǎn)站讓調(diào)用更方便，但不代表每個會話都要無限延長。長會話失控時，重開短會話往往更省時間，也更省預算。

• 跑偏后先停止執(zhí)行。
• 讓 Codex 復述目標和邊界。
• 只保留關(guān)鍵事實，重新組織上下文。

十三、推薦的完整分批流程

第一步，進入 [靈能API](https://www.lnsns.com/) 確認模型、入口和可用狀態(tài)。第二步，在 CC Switch 中啟用 read 配置卡。第三步，讓 Codex 只讀項目結(jié)構(gòu)。**步，讓它提出計劃。第五步，人工確認后切到 deep 配置卡處理小范圍修改。第六步，做階段驗收。第七步，再決定是否進入下一批。

這套流程看起來比“一句話全交給模型”麻煩，但它更像真實工程協(xié)作。你讓 Codex 每一步都給出可檢查產(chǎn)物，就能把不確定性壓在小范圍里。

個人使用時，可以把流程簡化為三步：只讀、計劃、執(zhí)行。團隊使用時，則建議保留完整五段，因為多人協(xié)作更需要清楚的邊界和交接記錄。

如果這篇流程要放進團隊規(guī)范，可以再補一個要求：每次 deep 配置卡使用完，都要回到 read 或日常配置卡。這個小動作能避免下一次短任務(wù)誤用高消耗線路，也讓模型切換更有儀式感。

? 十四、結(jié)語：把長任務(wù)拆小，Codex 才更像靠譜搭檔

Codex 接入 API 中轉(zhuǎn)站后，能力邊界會變寬，但任務(wù)管理也更重要。靈能API 負責穩(wěn)定入口，CC Switch 負責配置切換，而長任務(wù)拆分負責讓每一次調(diào)用有明確目標。

真正高效的用法，不是把所有要求一次性丟出去，而是讓模型在一個個清楚階段里持續(xù)推進。拆小以后，輸出更容易驗收，成本更容易控制，錯誤也更容易回退。