一、為什么從測試自動化開始：價值穩定，風險可控

很多團隊第一次使用 Codex 時，容易直接讓它改業務代碼。這樣做并非不能嘗試，但對團隊流程要求更高：要有清晰權限、代碼評審、測試覆蓋和回滾機制。相比之下，讓 Codex 先參與測試自動化，更容易穩定落地，因為它輸出的是測試草稿、用例清單和失敗分析，天然需要人工確認。

測試工作有一個特點：重復性高、邊界多、上下文分散。開發者寫完主流程后，常常漏掉空值、重復請求、權限不足、異常返回、舊數據兼容等情況。Codex 可以讀取接口定義、業務函數和現有測試，先把可能遺漏的路徑列出來，再給出測試樣例。

通過靈能API統一接入后，團隊可以把這類任務做成固定流程。每次接口或核心函數變化后，先生成測試建議，再由開發者選擇是否采納，最后把已采納內容納入測試集。這樣既提高覆蓋率，也不會讓模型直接越過工程判斷。

• 測試建議可以自動生成，但測試是否入庫必須人工確認。
• 用例生成優先覆蓋邊界和異常，不只是重復主流程。
• 失敗復盤要沉淀成清單，避免同類問題反復出現。

二、先統一入口：讓測試任務使用同一套接入配置

測試自動化通常會被多人、多個分支、多個環境觸發。如果每個成員都使用不同入口和不同模型，生成的測試風格、覆蓋重點和失敗表現都會不同。接入流程的第一步，是確認團隊使用同一套基礎配置。

建議從 https://www.lnsns.com/ 進入靈能API控制臺，確認當前可用模型、接入說明和賬號狀態。團隊文檔只記錄入口、變量名和負責人，不記錄完整密鑰。這樣新成員可以按流程配置，但不會把敏感憑證復制到測試腳本或截圖里。

統一入口之后，再規劃測試任務的觸發方式。不是所有代碼變化都需要生成測試，優先關注接口變更、權限變更、數據處理邏輯、邊界條件和歷史故障相關模塊。觸發范圍越明確，輸出越有價值。

• 統一入口保證基礎鏈路一致。
• 統一變量保證腳本和本地配置一致。
• 統一觸發規則保證用量和輸出質量可控。

三、明確測試范圍：不要讓 Codex 猜整個項目

讓 Codex 生成測試時，最容易犯的錯誤是范圍太大。比如直接說“幫我給這個項目補測試”，模型會很難判斷優先級，也容易輸出泛泛的建議。更好的方式，是指定一個函數、一個接口、一個模塊，或者一次 PR 的變更集合。

測試范圍最好包含三類材料：被測代碼、已有測試、業務約束。被測代碼告訴 Codex 邏輯是什么；已有測試告訴它當前覆蓋到哪里；業務約束告訴它哪些邊界不能隨便推測。缺少其中任何一類，輸出都可能變成表面正確、實際難用。

測試任務輸入范圍

讀?。簊rc/modules/payment/create-order.ts
讀?。簊rc/modules/payment/refund.ts
讀取：tests/payment/*.spec.ts
讀取：do**/api/payment.md

目標：生成缺失測試建議和可落地用例草稿
限制：不修改文件，不推測文檔中不存在的計費規則

如果模塊較大，可以先讓 Codex 輸出測試點清單，而不是直接寫測試代碼。清單確認后，再逐條生成用例。這個兩步法能減少無效代碼，也能讓業務負責人先確認邊界是否準確。

• 先指定范圍，再要求生成。
• 先列測試點，再寫測試代碼。
• 不確定的業務規則必須進入待確認。

?? 四、用 CC Switch 固定測試配置：把調試和正式任務分開

測試生成任務和日常問答不應該共用同一張配置卡。日常問答可以更自由，測試任務則需要穩定的輸出結構和清晰的權限邊界。建議在 CC Switch 中單獨建立測試自動化配置卡，備注用途、模型、是否允許寫入以及輸出目錄。

配置卡可以命名為 Lingneng-Codex-****-Draft 或 Lingneng-Codex-Regression-Review。默認建議只讀代碼并輸出草稿，寫入范圍限制在 tests/drafts 或臨時目錄。等開發者確認后，再手動合并到正式測試文件中。

配置卡備注模板

用途：生成測試建議和用例草稿
權限：只讀業務代碼和已有測試
輸出：測試點清單、用例草稿、失敗復盤
寫入：僅允許 drafts/ 或臨時目錄
復核：開發者確認后再進入正式測試集
最后驗證：2026-09-04

• 測試配置卡不要混用代碼重構配置。
• 默認只輸出草稿，不自動覆蓋正式測試。
• 配置變更后先跑小樣本，再跑完整模塊。

五、第一類任務：生成單元測試清單

單元測試清單是最適合起步的任務。它不要求 Codex 立刻寫出可運行代碼，而是先分析函數輸入、輸出、異常分支和依賴關系，列出應該覆蓋的測試點。開發者確認清單后，再生成具體測試代碼，成功率會高很多。

測試清單建議分成正常路徑、邊界路徑、異常路徑、兼容路徑四類。正常路徑用于確認主流程；邊界路徑用于覆蓋空值、最大值、最小值、重復輸入；異常路徑用于覆蓋權限不足、依賴失敗、非法狀態；兼容路徑用于確認舊字段、舊調用方和歷史數據仍然可用。

請讀取指定函數和已有測試，輸出單元測試清單。

輸出結構：
1. 正常路徑
2. 邊界路徑
3. 異常路徑
4. 兼容路徑
5. 需要 mock 的依賴
6. 當前測試缺口
7. 待人工確認的業務規則

限制：不要直接修改測試文件。

• 單元測試先列清單，減少直接生成無效代碼。
• 異常路徑要單獨列，不要夾在正常路徑里。
• 需要 mock 的依賴要提前說明。

六、第二類任務：生成可運行測試草稿

當測試點清單確認后，再讓 Codex 生成可運行測試草稿。這里要明確測試框架、斷言風格、mock 方式和文件位置。不要只說“幫我寫測試”，否則輸出可能和項目現有風格不一致，需要大量返工。

提示詞里應要求 Codex 先讀取已有測試文件，模仿項目的 import、descri*e、it、*eforeEach、mock 寫法。這樣生成的測試更容易貼近倉庫風格，也更方便開發者復制到正式文件中。

請參考 tests/payment/create-order.spec.ts 的寫法，
為 createOrder 增加測試草稿。

要求：
- 使用項目現有測試框架和斷言風格
- mock 方式與已有測試一致
- 每個用例名稱說明業務場景
- 不引入新測試庫
- 輸出代碼塊，不直接寫文件
- 最后列出仍需人工確認的斷言

生成草稿后，不要直接合并。先把測試放進臨時分支或草稿目錄運行，確認 import、mock、異步處理和斷言都符合項目實際。模型可能理解邏輯，但不一定完全掌握本地測試環境的細節。

• 先模仿現有測試風格，再生成新用例。
• 不要引入未經討論的新測試庫。
• 生成代碼后必須本地運行。

七、第三類任務：整理回歸測試用例

回歸測試的重點不是覆蓋所有功能，而是覆蓋最可能被本次改動影響的舊行為。Codex 可以讀取變更文件、接口文檔和歷史測試，幫助團隊整理一份回歸清單。這個清單尤其適合發布前使用。

回歸用例要寫清楚前置條件、操作步驟、預期結果和風險等級。不要只寫“測試登錄”“測試下單”這種粗粒度條目，否則執行時仍然需要測試人員重新拆解。

回歸用例輸出模板

用例名稱：舊用戶資料接口兼容性檢查
風險等級：中
前置條件：存在歷史用戶數據，包含舊字段 nickname
操作步驟：調用資料接口，檢查返回結構
預期結果：舊字段仍可讀取，新字段按默認規則返回
關聯變更：src/modules/mem*er/profile.ts
待確認：舊字段計劃廢棄日期

通過靈能API統一入口運行這類任務，可以讓不同項目保持接近的輸出結構?；貧w清單一旦穩定，就可以放進發布流程，每次發布前讓 Codex 先根據變更生成草稿，再由測試負責人確認執行范圍。

• 回歸測試關注舊行為是否被影響。
• 每條用例都要有前置條件和預期結果。
• 發布前回歸清單必須由測試負責人確認。

八、**類任務：分析測試失敗日志

測試失敗后，很多團隊會把整段日志丟給模型，希望它直接判斷原因。更穩的方式，是先截取關鍵片段：失敗用例名稱、錯誤堆棧、相關斷言、最近變更文件。輸入越干凈，Codex 給出的結論越容易復核。

失敗分析的輸出也要固定。建議包含失敗現象、可能原因、優先檢查項、建議補充信息、是否疑似環境問題。這樣開發者可以先按優先級排查，而不是在一段長解釋里找重點。

失敗日志分析提示詞

請讀取以下測試失敗片段和最近變更摘要。
輸出：
1. 失敗現象
2. 最可能原因
3. 第二可能原因
4. 建議先檢查的文件
5. 需要補充的上下文
6. 是否可能是環境變量或依賴問題

限制：不要把猜測寫成確定結論。

• 失敗日志要截取關鍵片段，不要整包塞入。
• 原因判斷要按概率排序。
• 環境問題和代碼問題要分開標記。

九、把失敗復盤沉淀成測試知識庫

測試失敗處理完之后，最容易被忽略的是復盤沉淀。很多問題當時解決了，過幾周另一個成員又遇到同樣現象，只能重新查。Codex 可以幫助把失敗日志、處理過程和最終原因整理成簡短知識庫條目。

復盤條目不要寫成流水賬，而要面向下一次排查。建議包含錯誤現象、觸發條件、根因、排查步驟、修復方式、預防動作。這樣團隊后續能直接復用，而不是只看到一段歷史描述。

測試失敗復盤模板

標題：支付回調測試偶發 timeout
現象：CI 中支付回調測試間歇失敗
觸發條件：外部依賴 mock 未穩定返回
根因：測試未等待異步隊列處理完成
排查步驟：查看失敗用例、確認 mock、檢查異步等待
修復方式：增加隊列完成等待和超時斷言
預防動作：新增異步測試編寫規范

• 復盤條目要面向未來排查。
• 根因和猜測要區分。
• 每次典型失敗都要沉淀一條可搜索記錄。

十、控制用量：測試生成也要分任務重量

測試自動化看似比代碼生成輕，但如果每次提交都讓 Codex 讀取大量文件并生成完整測試報告，成本也會快速上升。建議按任務重量分流：短日志解釋走輕量路線，單文件測試清單走標準路線，跨模塊回歸清單手動觸發。

在靈能API控制臺查看模型和資源狀態時，可以把團隊策略寫下來。比如：每次 PR 只生成測試缺口摘要；接口變化時生成詳細用例草稿；發布前才生成完整回歸清單；測試失敗后只分析關鍵日志片段。

測試任務觸發策略

每次 PR：生成測試缺口摘要
接口變化：生成單模塊測試清單
測試失?。悍治鲫P鍵失敗日志
發布前：生成回歸測試草稿
跨模塊影響：人工觸發深度分析

• 高頻任務輸出要短。
• 長上下文任務要低頻或手動觸發。
• 連續失敗時先停止重試，再排查原因。

十一、提示詞模板：讓輸出能直接進入測試流程

測試提示詞要避免空泛，最好固定為“目標、輸入、范圍、項目風格、輸出結構、限制、待確認”七個部分。這樣不同成員觸發任務時，輸出不會忽長忽短，也更容易進入團隊測試流程。

你是團隊測試用例助手。

目標：為指定模塊生成測試點和用例草稿。
輸入：讀取指定業務文件、sche** 文件和已有測試文件。
范圍：只分析本次指定模塊，不擴展到其他目錄。
項目風格：參考已有測試文件的命名、斷言和 mock 寫法。
輸出結構：測試點清單、用例草稿、測試缺口、待確認事項。
限制：不修改文件，不引入新測試庫，不推測未出現的業務規則。
待確認：單獨列出需要開發、測試或產品確認的問題。

這個模板的好處是把模型能力限制在可復核范圍內。Codex 可以做大量整理和草稿生成，但它必須說明哪些內容是確定的，哪些內容需要人確認。測試代碼尤其需要這種邊界，因為一個看似合理的斷言，如果業務規則不對，反而會把錯誤固化下來。

• 提示詞要先寫限制，再要求輸出。
• 輸出結構固定，后續才能自動檢查。
• 待確認事項必須獨立列出。

十二、入庫前檢查：測試草稿不能直接變成正式測試

Codex 生成的測試草稿進入倉庫前，必須經過檢查。第一看能不能運行，第二看斷言是否真的驗證業務，第三看 mock 是否遮蔽了真實問題，**看用例名稱是否能被后續維護者理解。

尤其要警惕兩類測試：一種是只驗證函數被調用，卻不驗證結果；另一種是 mock 過多，導致測試永遠通過但沒有覆蓋真實邏輯。模型生成代碼時容易追求形式完整，人工復核時要回到測試價值本身。

測試入庫檢查清單

[ ] 測試能在本地和 CI 中運行
[ ] 斷言覆蓋關鍵返回值或狀態變化
[ ] mock 沒有遮蔽核心邏輯
[ ] 異常路徑有明確斷言
[ ] 用例名稱能說明業務場景
[ ] 不引入無關測試庫
[ ] 待確認規則已由負責人確認

• 能運行不等于有價值。
• 斷言必須驗證業務結果。
• 入庫前要經過開發者和評審人確認。

? 十三、收尾：把測試生成做成團隊質量入口

Codex 接入 API中轉站 后，測試自動化是非常適合長期落地的方向。它不會直接替團隊決定業務邏輯，卻能持續提醒邊界、異常、兼容性和回歸風險。只要流程設計得當，它會成為代碼合并前的一層質量入口。

落地順序可以很清楚：先通過靈能API統一接入入口，再用 CC Switch 固化測試配置卡，隨后從單元測試清單開始，逐步擴展到測試草稿、回歸用例和失敗復盤。每一步都保留人工確認，讓生成內容真正進入工程閉環。

最終目標不是讓測試數量看起來更多，而是讓每一條測試都能解釋它保護了什么風險。做到這一點，Codex 就不只是幫你寫幾段測試代碼，而是在幫助團隊把質量意識變成可執行的日常動作。

• 先生成測試點，再生成測試代碼。
• 先確認業務規則，再把測試入庫。
• 先沉淀失敗復盤，再擴展自動化范圍。