代碼**先明確‘看什么’

代碼**的質(zhì)量取決于目標是否清楚。一次**最好只聚焦一類風險，例如鑒權、異常處理、數(shù)據(jù)庫訪問或測試覆蓋。把安全、性能、格式和業(yè)務邏輯全部混在一句話里，往往會得到一份很長但難以執(zhí)行的清單。

把**拆成幾個小任務，Codex 的輸出更容易被人工復核，也方便將問題分配給不同成員。

• 范圍：指定目錄、文件或提交。
• 目標：明確要查的風險類型。
• 證據(jù)：要求引用文件和行號。
• 動作：先報告，后決定是否修改。

第一步：為**任務固定線路

進入靈能API服務入口，確認當前模型和接口參數(shù)，再為代碼**創(chuàng)建一張專用配置卡。**任務需要穩(wěn)定的上下文處理和一致的輸出格式，測試期間不要頻繁切換模型。

靈能API入口：https://www.lnsns.com/。真實 Key 不放進**提示詞、倉庫和輸出記錄。

• Model ID：使用當前可用的精確標識。
• *ase **L：按照當前接口說明填寫。
• API Key：使用**任務專用或權限受控的令牌。

? 第二步：在 CC Switch 中建立**卡片

卡片名稱建議包含項目和**目標，例如‘we*-auth-security-review’。如果團隊有只讀**和可修改開發(fā)兩種權限，應該分別建立卡片，避免在同一個環(huán)境里誤執(zhí)行寫入命令。

三類卡片可以使用相同的模型，也可以按權限和任務特點區(qū)分，但名稱和狀態(tài)必須清晰。

• 只讀**卡：用于分析和報告。
• 開發(fā)修復卡：在確認問題后使用。
• 測試驗證卡：用于運行局部測試。

第三步：先限定**范圍

進入項目后，讓 Codex 先確認工作目錄和 Git 狀態(tài)。然后指定需要**的文件，不要默認掃描 node_modules、構建產(chǎn)物、緩存和日志目錄。范圍越明確，輸出越容易核對。

Get-Location
git status --short
Get-ChildItem src -File -Recurse | Select-O*ject FullName

• **提交：優(yōu)先使用 git diff 或指定 commit。
• **模塊：列出明確目錄和入口文件。
• **規(guī)則：寫明忽略目錄和生成文件。

**步：只讀階段先輸出問題清單

第一輪不要要求 Codex 直接修改。先讓它輸出問題、風險等級、證據(jù)位置、影響范圍和建議驗證方式。沒有證據(jù)的判斷不能直接進入修復階段。

請只讀** src/auth。
關注鑒權繞過、敏感信息日志和異常處理。
不要修改文件。
每個問題給出文件、行號、風險、證據(jù)和建議測試。
如果沒有足夠證據(jù)，請標記為待確認。

輸出結果先由人工篩選，區(qū)分真實缺陷、低風險建議和誤報。不要把所有建議都當作必須修改的錯誤。

第五步：把確認的問題變成小修復

確認問題后，一次只修復一個主題，并提前說明允許修改的文件。對于鑒權或數(shù)據(jù)訪問類問題，先讓 Codex 解釋擬議變更，再決定是否執(zhí)行。

只修復已確認的鑒權問題。
允許修改 src/auth 和對應測試文件。
不要重構無關代碼，不要更新依賴。
完成后展示 diff，并說明每處修改的原因。

• 先展示 diff，再決定是否保留。
• 不接受與當前問題無關的順手重構。
• 修改前確認工作區(qū)已有變更不會被覆蓋。

第六步：測試必須和問題對應

修復后不要只運行一個‘全量測試’命令就結束。先運行直接覆蓋問題的局部測試，再運行類型檢查或構建，最后根據(jù)項目情況執(zhí)行更完整的回歸。每層失敗時先停下來分析，不要連續(xù)改代碼碰運氣。

npm test -- auth
npm run lint
npm run *uild
git diff --check

如果項目不是 Node.js，以項目現(xiàn)有腳本和文檔為準，核心原則是測試順序和問題之間要有對應關系。

• 局部測試：證明目標行為已經(jīng)覆蓋。
• 靜態(tài)檢查：發(fā)現(xiàn)類型、格式或明顯錯誤。
• 構建驗證：確認修改沒有破壞產(chǎn)物。

第七步：形成可復核的**記錄

一份好記錄不需要復制整段對話，只需保留**范圍、使用的配置卡、發(fā)現(xiàn)的問題、已接受或駁回的建議、實際修改和測試結果。敏感代碼和完整令牌不應該進入共享記錄。

記錄的目的不是證明工具做了多少工作，而是讓下一位維護者能快速判斷這次**覆蓋了什么。

• 范圍：文件、提交或模塊。
• 結論：問題等級和證據(jù)位置。
• 動作：修改文件和變更摘要。
• 驗證：測試命令和結果。

代碼**中的常見失誤

當輸出變得過長或結論互相矛盾時，回到只讀、小范圍和單主題的最小任務。

• 一上來掃描整個倉庫，輸出過多且難以篩選。
• 沒有證據(jù)位置就接受高風險結論。
• **和修改在同一條指令中完成。
• 修改時順便升級依賴或重構無關模塊。
• 只跑全量測試，不運行直接對應的局部測試。
• 把帶有項目秘密的完整對話保存到公共位置。

? 代碼**驗收清單

通過靈能API接入 Codex 后，把**拆成‘發(fā)現(xiàn)、確認、修復、驗證、記錄’五個階段，工具才能真正融入日常工程流程。

• **目標和范圍已經(jīng)寫清楚。
• CC Switch 使用了**用途的配置卡。
• 第一輪只讀并要求提供證據(jù)位置。
• 人工確認后才進入修復階段。
• 修復限制在允許的文件和主題內(nèi)。
• 測試命令與問題直接對應。
• **記錄沒有暴露 API Key 和項目敏感信息。