← 返回學習路線
章節 · 已發布

Codex 任務執行與驗證閉環

用可重現的流程規劃 Codex 任務、檢查 diff、執行驗證並處理失敗,不提前宣稱完成。

來源: start/08-task-execution.md快速上手 (原文)
本章閱讀進度 0%學習路線進度 0% · 0/46 已完成章節繼續學習路線 →

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
配置修改查询当前状态、启动一次最小任务
发布任务检查访问地址、日志、状态码

延伸閱讀

知識AI 自動化工作流程設計與實踐知識AI Agent:從基礎概念到實際應用知識結構化輸出與工具契約:讓 Agent 動作可驗證
產品中心 Demo · V0.3