為什么接入后還要做模板庫

中轉站解決的是線路和模型接入問題，模板庫解決的是任務表達問題。沒有模板時，你每次都要重新告訴 Codex 項目**、允許讀取哪些文件、禁止改哪些目錄、完成后怎么驗收。只要少寫一兩項，結果就可能偏離預期。

模板庫不是為了把提示詞寫得花哨，而是把高頻任務里的穩定部分沉淀下來，把會變化的部分留成占位符。這樣每次只需要替換項目名、文件范圍、目標和錯誤日志，就能快速開始。

• 減少重復描述，提高任務啟動速度。
• 統一邊界說明，降低誤改風險。
• 固定驗收口徑，讓結果更容易檢查。
• 方便團隊復用，不靠個人記憶。

第一步：先確認靈能API線路和模型定位

模板庫搭建前，先確認靈能API入口、模型列表和賬戶狀態。模板不是獨立存在的，它要和你常用的模型能力匹配：輕量解釋模板適合快模型，復雜**模板適合上下文更強的模型，長文檔整理模板則要關注輸入輸出消耗。入口：https://www.lnsns.com/

如果模板沒有區分任務難度，后面很容易所有事情都用同一個模型處理。靈能API的模型入口負責提供選擇，模板庫負責告訴你什么時候該用哪一類任務方式。

• 輕量模板：錯誤解釋、單文件說明、命令解釋。
• 中等模板：小功能開發、測試補充、文檔整理。
• 復雜模板：跨模塊**、重構方案、長日志分析。

第二步：給模板庫準備專用配置卡

在 CC Switch 里可以準備一張偏穩定的模板測試卡，用來驗證新模板是否能得到預期輸出。它不一定是日常開發主卡，但應該使用真實可用的靈能API線路，這樣測試結果才接近日常工作。

模板測試卡的好處是清晰：當某個模板輸出不穩定時，你知道問題來自模板本身、任務上下文，還是線路配置，不會把日常項目卡改來改去。

• 卡片名稱：建議寫明模板測試用途。
• 模型選擇：優先穩定、響應快、成本可控。
• 備注：記錄模板庫版本和適用場景。

第三步：模板一定要分出固定項和變量項

一個好的 Codex 模板，固定項應該包括角色、任務目標、允許范圍、禁止動作、輸出格式和驗收方式；變量項則是項目名、文件路徑、錯誤日志、需求描述、期望結果。固定項越穩定，變量項越容易替換。

【固定項】
你是項目代碼助手，先分析再執行。
必須說明計劃，不要直接修改文件。
禁止讀取密鑰、Cookie、生產配置。
完成后輸出修改點和驗證方式。

【變量項】
項目：{{project_name}}
目標：{{task_goal}}
允許范圍：{{allowed_paths}}
錯誤日志：{{error_log}}

不要把所有內容都寫成一長段自然語言。用固定標題和占位符能讓模板更容易維護，也方便團隊成員復制使用。

**步：需求拆解模板

需求拆解模板適合任務剛開始時使用。它不要求 Codex 馬上改代碼，而是先把需求拆成可執行步驟、風險點和驗收項。這個模板尤其適合需求描述模糊、涉及多個模塊、還沒有明確實現方案的場景。

請先不要修改文件。
根據以下需求輸出：
1. 你理解的目標
2. 需要確認的問題
3. 可能涉及的文件范圍
4. 推薦執行步驟
5. 驗收方式
需求：{{requirement_text}}

如果 Codex 在拆解階段就把范圍擴得很大，說明需求還需要再收窄。先把任務邊界調清楚，再進入真實修改。

第五步：代碼修改模板

代碼修改模板要比需求拆解模板更嚴格，因為它會進入文件編輯階段。建議明確寫出允許修改的路徑、禁止觸碰的模塊、是否允許新增依賴、是否需要補測試。

請按以下邊界執行代碼修改：
目標：{{task_goal}}
允許修改：{{edita*le_paths}}
禁止修改：{{*locked_paths}}
是否允許新增依賴：{{allow_dependency}}
測試要求：{{test_requirement}}

執行前先輸出計劃，確認后再修改。

這類模板適合配合靈能API穩定線路長期使用。每次項目任務只替換變量項，不需要重新組織整段提示詞。

• 允許范圍越具體，越不容易誤改。
• 禁止范圍要寫關鍵目錄和敏感文件。
• 新增依賴要明確是否允許。
• 測試要求最好提前寫進模板。

第六步：排錯模板

排錯模板的關鍵是把現象、錯誤碼、環境、最近變更和已嘗試動作分開。不要只寫“報錯了幫我看”，這會讓 Codex 反復猜測。

請先分析原因，不要直接改代碼。
現象：{{symptom}}
錯誤碼或日志：{{error_log}}
發生環境：{{environment}}
最近變更：{{recent_changes}}
已嘗試操作：{{tried_actions}}

請輸出：可能原因、驗證順序、最小復現步驟。

遇到 401、403、404、429、timeout 這類中轉 API 問題時，也可以套用同一模板。注意日志里不要放完整 Key，靈能API賬戶信息只記錄必要的脫敏摘要。

第七步：代碼**模板

代碼**模板適合在修改完成后使用。它的目標不是讓 Codex 重寫代碼，而是檢查風險、邊界、測試缺口和潛在回歸。模板里要明確**重點，否則它容易輸出泛泛而談的建議。

請以代碼**方式檢查本次修改。
重點關注：
1. 是否引入行為回歸
2. 是否遺漏錯誤處理
3. 是否有安全或權限風險
4. 是否需要補測試
5. 是否有無關改動

請按嚴重程度列出問題，不要寫空泛評價。

這類模板對團隊很有價值。即使每個人寫代碼風格不同，**口徑也可以保持一致。

• **模板要讓問題優先于總結。
• 要求指出文件和原因，而不是只給建議。
• 沒有問題時，也要說明剩余風險。

第八步：交付說明模板

完成一次 Codex 任務后，最好讓它輸出交付說明。交付說明可以用于提交記錄、日報、知識庫或給同事說明上下文。模板要短，但信息要完整。

請輸出本次任務交付說明：
- **
- 修改點
- 驗證方式
- 測試結果
- 影響范圍
- 剩余風險
- 后續建議

如果這份說明后續要發給非技術同事，可以再讓 Codex 輸出一個簡化版。一個面向開發，一個面向業務，模板可以共用底層信息，但表達方式不同。

第九步：模板庫怎么保存和命名

模板庫不需要一開始就做成復雜系統。個人使用時，可以放在 Markdown 文件里；團隊使用時，可以放到知識庫或項目倉庫的 do** 目錄。關鍵是命名清楚、版本可追蹤、不要混入敏感信息。

模板里可以寫靈能API和 CC Switch 的使用說明，但不要**實 API Key。需要跳轉服務入口時，使用可點擊的靈能API官網鏈接即可。

• prompt-requirement-*reakdown.md：需求拆解模板。
• prompt-code-change.md：代碼修改模板。
• prompt-de*ug.md：排錯模板。
• prompt-review.md：代碼**模板。
• prompt-delivery-note.md：交付說明模板。

? 最后給一套落地清單

當模板庫建立起來后，Codex 中轉站的使用會更像一套穩定流程，而不是每次重新臨場發揮。靈能API提供模型入口，CC Switch負責本地切換，模板庫則讓你的需求表達、排錯判斷和交付說明持續復用。

• 確認靈能API線路、模型和賬戶狀態。
• 在 CC Switch 中準備模板測試卡。
• 把模板拆成固定項和變量項。
• 優先沉淀需求拆解、代碼修改、排錯、**、交付說明五類模板。
• 模板中寫清允許范圍、禁止動作和驗收方式。
• 日志、Key、Cookie 和生產配置不進入模板庫。
• 每次任務結束后，根據結果更新模板。