Tip · 最後核對
流程最後核對日期為 2026-09-02。CLI、權限與審批行為請以 Codex CLI 文件、權限 及智能體審批與安全 為準。
Codex 任務執行與驗證閉環
穩定的任務可拆成六個階段:說清目標、建立儲存庫地圖、小步修改、檢查 diff、執行驗證並記錄結果。
說明目標 -> 建立工作地圖 -> 小步修改 -> 檢查 diff -> 執行檢查 -> 記錄結果
1. 說清任務
寫明預期結果、背景、允許範圍、限制、驗證命令與交付格式。只說「修好它」會留下太多未決定事項。
2. 先要求唯讀建圖
多檔案變更先讓 Codex 說明專案用途、關鍵目錄、受影響介面、風險與最小執行順序,再開始編輯,讓邊界可供審查。
3. 小步執行
能分開時,分別處理檔案移動、導航、實作與驗證。小 diff 比較容易檢查,也比較容易回滾。
4. 檢查 diff
確認沒有改到無關檔案、連結仍可解析、標題層級正確,且補丁符合原本範圍。
5. 執行驗證
先跑最接近變更的測試;若涉及共用介面,再跑型別檢查或建置。記錄確切命令和結果,不要只因頁面能開啟就推斷成功。
6. 誠實處理失敗
保留錯誤輸出,判斷是本次改動還是環境造成,只修正相關原因。修復後重跑相同檢查,列出仍未驗證的部分。
完成清單
- 需求中的檔案與行為已變更。
- diff 沒有無關工作。
- 測試、型別檢查或瀏覽器檢查有證據。
- 回滾方式與剩餘風險清楚。
下一步
接著閱讀 Codex CLI 安裝指南。
程式碼範例
说明目标 -> 让它建图 -> 小步执行 -> 检查 diff -> 运行验证 -> 记录结果
请只读分析当前项目的文档结构,不要修改文件。
请指出首页、学习路线和侧边栏之间不一致的地方。
输出:问题列表、涉及文件、建议调整顺序。
请更新 docs/start/06-first-task.md 中的下一步链接。
只修改这个文件。
完成后说明改了哪里,不需要运行构建。
请按文件说明这次 diff 的目的。
指出哪些是移动文件,哪些是链接更新,哪些是正文修改。
构建失败了。请判断这是本次改动导致,还是环境依赖问题。
不要修改文件,先给出证据和下一步建议。
參考表格
| 任务类型 | 常见验证 |
|---|---|
| 文档链接 | 搜索旧路径、检查相对链接 |
| 前端页面 | 运行构建、打开页面截图 |
| 代码修改 | 跑单元测试、类型检查、lint |
| 配置修改 | 查询当前状态、启动一次最小任务 |
| 发布任务 | 检查访问地址、日志、状态码 |
