一、先把需求說清楚，再讓 Codex 動手

很多團隊把 Codex 當成代碼生成器使用，結果發現輸出經常需要反復改。問題未必出在模型本身，而是需求輸入太松散：一句“優化登錄流程”、一張截圖、幾個口頭補充，就希望它直接給出完整修改方案。工程任務不是猜謎，需求越模糊，模型越容易補全不存在的細節。

更實用的做法，是把 API 中轉站接入和工單拆解流程放在一起設計。靈能API提供統一調用入口，CC Switch保存不同任務配置，工單模板則負責把需求**、目標、范圍、約束和驗收標準整理成 Codex 能理解的任務指令。

二、需求工單要拆成六個字段

給 Codex 的工單不要寫成大段散文。更適合 AI 協作的方式，是把需求拆成固定字段，讓它明確哪些是事實、哪些是目標、哪些是限制、哪些需要人工確認。

這六個字段能顯著減少來回溝通。Codex 不需要從含糊描述里猜意圖，開發者也能更快判斷它給出的方案是否偏離需求。

• **：為什么要做這個需求，當前問題是什么。
• 目標：本次完成后希望達到什么效果。
• 范圍：涉及哪些頁面、接口、模塊、配置或數據。
• 約束：哪些邏輯不能改，哪些兼容性必須保留。
• 驗收：如何判斷任務完成，測試和人工檢查分別看什么。
• 風險：可能影響哪些用戶路徑、任務鏈路或上線流程。

三、先確認靈能API的調用入口

在正式配置前，先進入靈能API https://www.lnsns.com/，確認 API *ase、可用模型、賬號狀態和項目使用策略。需求拆解通常會產生比較長的上下文，因此接入入口和模型范圍要穩定，不能一邊寫任務指令一邊猜模型名稱。

團隊文檔中可以把靈能API設置成可點擊入口，方便成員回到統一頁面確認信息。需要注意的是，工單模板里不要保存完整 Key；它只需要說明使用哪張 CC Switch 配置卡，以及這個任務是否需要更強上下文能力。

四、按工單階段設置 CC Switch 配置卡

需求從提出到上線通常會經歷多個階段：澄清、拆解、開發、審閱、測試、發布。每個階段對 Codex 的要求不同，所以不建議只用一張默認配置跑到底。

這種配置拆分看起來多一步，但會讓輸出更穩定。澄清階段不需要急著寫代碼，審閱階段也不應該繼續擴寫需求；配置卡按階段劃分后，任務邊界自然更清楚。

• ticket-clarify：用于閱讀需求，找出缺失信息和不明確表達。
• task-splitter：用于把需求拆成開發任務、影響范圍和待確認問題。
• code-worker：用于局部實現、函數修改和測試補齊。
• review-checker：用于檢查 diff、風險點和驗收條件。

五、把模糊需求改成可執行指令

需求工單里最常見的問題是描述太籠統。比如“優化會員頁”“修復支付失敗”“增加導出功能”，這些句子都不足以讓 Codex 直接行動。你需要先讓它把需求改寫成可執行指令，再進入代碼階段。

需求澄清提示詞：
請閱讀下面的需求描述，把它拆成可執行任務。
輸出包含：業務**、用戶路徑、影響模塊、需要修改的文件類型、缺失信息、驗收標準。
如果需求不足以進入開發，請只列出必須補充的問題，不要直接寫實現方案。

這個步驟適合放在開發前。它可以幫助產品、開發和測試提前對齊，而不是等代碼寫完后才發現需求范圍理解不一致。

在需求評審會議前，可以先用這段提示詞跑一遍工單。會議中只討論 Codex 標出的缺失問題和風險點，而不是從頭閱讀整份需求。這樣能把評審時間用在真正模糊的地方，比如權限邊界、舊數據兼容、異常提示和是否需要灰度發布。

六、任務指令要寫清楚“不要做什么”

很多提示詞只寫“請實現某功能”，卻沒有告訴 Codex 哪些東西不能動。真實項目里，不能動的邊界往往比要做的功能更關鍵。

把“不要做什么”寫清楚，可以顯著降低回滾和返工風險。尤其是接入靈能API與 CC Switch 后，模型能力更強，越應該用邊界限制它不要做過度修改。

• 不要改動公共鑒權邏輯，除非工單明確要求。
• 不要新增未確認的第三方依賴。
• 不要修改舊接口響應字段，除非有兼容方案。
• 不要把測試數據、賬號、密鑰寫進代碼或文檔。

七、驗收標準不要只寫“功能正常”

“功能正常”不是驗收標準，它只是愿望。真正可執行的驗收標準，要能被測試、開發或業務同學逐條檢查。Codex 處理工單時，也需要這些標準來判斷輸出是否完整。

驗收標準示例：
1. 未登錄用戶進入頁面時，展示登錄引導，不報 500。
2. 已登錄普通用戶只能看到自己的數據。
3. ***可以按時間范圍篩選并導出結果。
4. 導出失敗時顯示明確錯誤，不丟失篩選條件。
5. 新增邏輯需要補充單元測試和至少一個異常場景測試。

如果工單沒有驗收標準，建議先讓 Codex 幫忙補一版，然后由人工確認。模型可以輔助整理，但最終驗收標準必須由項目負責人確認。

驗收標準還應該區分“機器能驗證”和“人工要確認”。機器能驗證的部分包括單元測試、接口返回、狀態碼、命令執行結果；人工要確認的部分包括交互體驗、提示文案、業務口徑和視覺細節。兩類驗收混在一起，會讓 Codex 誤以為所有標準都能靠代碼自動完成。

八、輸入資料要按優先級排列

給 Codex 提供資料時，不要把所有內容平鋪。最好按優先級排列，讓它先讀最重要的信息：需求目標、當前問題、相關文件、接口約定、測試命令、補充截圖。

這種排序能讓 Codex 把注意力放在當前任務上。很多失敗輸出不是信息不足，而是重要信息被淹沒在一堆**材料里。

• 第一優先級：需求目標、用戶路徑、驗收標準。
• 第二優先級：相關文件、接口文檔、目錄說明。
• 第三優先級：歷史討論、截圖、類似需求、邊界說明。
• 最后補充：可選優化方向、后續迭代想法。

九、讓 Codex 先輸出計劃，再動代碼

在復雜工單里，不建議一上來就讓 Codex 改代碼。更穩的是先讓它輸出實施計劃：涉及哪些文件、準備怎么改、可能有哪些風險、需要哪些驗證。人工確認計劃后，再進入代碼階段。

實施計劃提示詞：
請基于當前需求和項目上下文，先輸出實施計劃，不要直接修改代碼。
計劃必須包含：涉及文件、修改點、兼容風險、測試方式、需要人工確認的問題。
如果需求邊界不清楚，請停止并列出問題。

這個步驟能保護項目邊界。特別是多人協作時，先看計劃再動手，可以避免 Codex 把一個小需求擴展成大范圍重構。

? 十、開發階段要控制單次任務大小

一個工單可能包含多個子任務，但不代表要一次交給 Codex 全部完成。更可控的方式，是按最小**證單元拆分：先改接口，再改頁面，再補測試，再寫說明。每一步都有輸入和輸出。

這樣做看似慢一點，實際更省時間。因為每一輪都能被人工快速確認，出現偏差也只影響一個小范圍。靈能API和 CC Switch 保證接入穩定，任務拆分則保證執行穩定。

如果一個子任務超過半小時仍然需要反復解釋，建議暫停繼續生成，回到工單層面重新拆分。很多時候不是 Codex 不會做，而是任務顆粒太大，里面混合了接口、頁面、權限、測試和文檔。把它拆成更小的**證單元，輸出會更穩定。

• 第一輪：只分析影響范圍，不寫代碼。
• 第二輪：只改一個模塊或一個文件組。
• 第三輪：根據變更補測試和邊界用例。
• **輪：生成驗收說明和發布提醒。

十一、工單流轉中要保留決策記錄

Codex 參與需求拆解后，很多判斷會在對話中完成：為什么選擇這個實現方式、為什么不改某個模塊、為什么新增測試。建議把關鍵決策寫回工單，而不是只留在本地對話里。

工單決策記錄字段：
決策點：
選擇方案：
不選擇的方案：
原因：
影響范圍：
是否需要后續復盤：
Codex 輸出是否經過人工確認：是 / 否

保留決策記錄可以減少后續爭議。幾周后如果有人問為什么這樣實現，團隊不需要重新翻對話，只要看工單里的關鍵記錄即可。

上線完成后，也建議把 Codex 參與過的關鍵輸出回填到工單里，例如最終實現范圍、實際測試結果、未處理的后續事項。這樣下一次類似需求出現時，團隊可以直接復用這份工單經驗，而不是重新組織一輪**說明。

十二、需求變更時不要讓舊指令繼續生效

需求中途變化很常見，但很多人會忽略同步更新 Codex 指令。舊指令繼續生效，會導致模型按過期目標輸出代碼，尤其是驗收標準、接口字段、頁面交互變化時更危險。

每次需求變化，都建議在工單里寫一條“指令已更新”。這能提醒后續參與者不要再引用舊上下文，也能讓 Codex 的輸入保持干凈。

需求變化后，最好讓 Codex 重新生成一份“變更影響摘要”。摘要只回答三件事：原計劃哪些內容仍然有效，哪些內容需要廢棄，哪些文件或測試需要重新檢查。這個動作能避免舊方案殘留在新實現里。

• 需求目標變化：重新生成任務拆解，不沿用舊計劃。
• 接口字段變化：更新接口約定，再讓 Codex 繼續修改。
• 驗收標準變化：先同步測試清單，再補代碼。
• 優先級變化：重新確認本輪只做哪些內容。

十三、完整落地順序

• 第一步：進入靈能API https://www.lnsns.com/，確認 API *ase、模型范圍和賬號狀態。
• 第二步：在 CC Switch 中按澄清、拆解、開發、審閱建立配置卡。
• 第三步：把需求工單拆成**、目標、范圍、約束、驗收和風險六個字段。
• **步：讓 Codex 先補充缺失問題，不要直接進入實現。
• 第五步：人工確認實施計劃后，再按最小**證單元執行開發。
• 第六步：把關鍵決策、驗收結果和變更記錄寫回工單。
• 第七步：需求變化時同步更新指令，避免舊上下文繼續影響輸出。

? 十四、結語：需求拆得越清楚，Codex 越像團隊成員

Codex API 中轉站接入的價值，不只是把模型調用跑通。靈能API提供統一入口，CC Switch管理不同任務配置，工單模板負責把需求變成可執行指令，這三者組合起來，才能真正降低溝通和返工成本。

當需求**、影響范圍、邊界約束和驗收標準都清楚時，Codex 的輸出會更貼近工程現場。它不再只是臨時回答問題的工具，而可以參與需求澄清、任務拆解、實現計劃、代碼審閱和驗收整理，讓團隊協作更順。