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

執行第一次 Codex CLI 任務

從可回復的小任務開始,檢查儲存庫、審閱 diff,並在提交前驗證結果。

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

Tip · 最後核對

流程最後核對日期為 2026-09-03。最新行為請參考 Codex CLI 文件、AGENTS.md 設定 與智能體審批與安全。

執行第一次 Codex CLI 任務

第一次可選擇修正錯字、補一個小型單元測試、更新 README 命令,或修復已有失敗測試的錯誤。先避開大規模重構、生產憑證、帳單、權限變更與刪除資料。

1. 先唯讀建立儲存庫地圖

要求 Codex 說明專案用途、關鍵目錄、安裝命令、測試命令與低風險任務。閱讀回答並修正假設後再繼續。

2. 提出一個小任務

寫明允許修改的檔案、驗證要求與交付摘要。要求 Codex 先讀相關程式碼、只做最小補丁、執行聚焦檢查並報告剩餘風險。

3. 觀察執行

確認 Codex 是否先讀上下文、控制範圍、解釋命令、在需要時要求審批,以及如實報告失敗。

4. 審閱 diff

使用 CLI 或編輯器檢查變更檔案、連結、測試與產生物。沒有讀過的補丁不要直接接受。

git diff

5. 記錄結果

記下目標、變更檔案、驗證命令、結果、剩餘風險與建議 commit message。完成檢查和審閱後才提交。

第一次失敗時

保留錯誤輸出,分辨程式碼、依賴、環境或範圍問題,要求最小相關修復,然後重跑相同驗證。

完成清單

  • 任務小到可以理解。
  • diff 範圍有限且已審閱。
  • 聚焦測試或命令通過。
  • 沒有引入密鑰、破壞性命令或未驗證的結論。

下一步

接著閱讀 在 VS Code 中使用 Codex。

程式碼範例

请只读分析当前仓库,不要修改文件。

请输出:
1. 项目用途
2. 关键目录
3. 安装、测试、构建命令
4. 当前任务适合从哪里开始
5. 你建议我第一次交给你的低风险任务
请修复当前仓库中最小范围的一个测试失败。

要求:
1. 先运行测试,确认失败信息。
2. 阅读相关代码和测试,不做无关重构。
3. 修改最少必要文件。
4. 修复后重新运行相关测试。
5. 最后总结:失败原因、改了哪些文件、验证命令和剩余风险。
请更新 [文档文件] 中关于 [主题] 的说明。

要求:
1. 先读取相关官方资料和现有文档结构。
2. 保持中文教程风格,避免整段翻译官方原文。
3. 涉及操作步骤时添加截图占位。
4. 修改后运行文档站构建。
5. 最后列出来源链接和需要人工补图的位置。
请 review 你刚才的改动,不要继续修改文件。

请重点检查:
1. 是否有无关改动
2. 是否遗漏测试
3. 是否引入安全或兼容风险
4. 是否还有未验证的地方
请用提交前摘要格式输出:
- 改动目标
- 修改文件
- 验证命令
- 验证结果
- 剩余风险
- 建议 commit message
git add .
git commit -m "fix: resolve failing test"

參考截圖

參考截圖

參考截圖

參考截圖

參考表格

观察点说明
是否先读上下文好结果通常来自充分阅读相关文件
是否控制范围第一次任务不追求顺手重构
是否解释命令命令执行前应说明目的
是否运行验证修改完成后要跑相关测试或构建
是否说明风险没能验证的部分要如实记录
失败现象处理方式
改动太大让 Codex 停下,只保留最小修复思路
测试跑不起来先让它解释环境缺口和命令来源
方向不对回到只读分析,让它列出文件依据
输出太泛要求按文件、命令、风险分段输出
误改无关文件用 git diff 确认,再手动决定保留或丢弃

延伸閱讀

知識AI Agent:從基礎概念到實際應用知識AI 自動化工作流程設計與實踐知識GEO:AI 搜尋時代的內容最佳化
產品中心 Demo · V0.3