《Codex快速入門:Harness工程落地》封麵

Codex快速入門:Harness工程落地 內容簡介

本書圍繞Codex深度參與真實軟件工程的完整路徑展開,係統闡述了在AI編程工具快速爆發的背景下,開發者在實際使用中麵臨的諸多痛點及其解決方案。全書按照“認知遷移→Harness工程→場景實戰→團隊落地”的邏輯組織內容。第一階段夯實認知基礎(第1章和第2章),闡明Codex作為交付工具的定位以及AI編程的邊界;第二階段構建個人工作流(第3章~第8章),涵蓋任務執行流程、任務入口選擇、工作流沉澱等核心環節;第三階段聚焦工程場景實戰(第9章~第12章),深入剖析接手陌生代碼庫、修複bug、跨前後端功能開發、PR與CI/CD自動化等;第四階段探索團隊落地(第13章和第14章),探討團隊級研發流程及Codex的邊界、風險與工程方法論。

本書主要麵向軟件開發者、技術負責人、AI編程探索者及非傳統開發崗位從業者等,也適合高校相關專業學生以及希望理解AI編程趨勢的技術從業者閱讀。

Codex快速入門:Harness工程落地 作者簡介

袁從德,十餘年互聯網技術研發與團隊管理經驗。曾任職騰訊、阿裏巴巴,主導騰訊遊戲廣告算法、零售通推薦係統、增長智能建模等核心項目。在廣告出價、排序模型預估、大模型應用等領域取得多項突破,成果發表於CIKM等頂會,擁有發明專利5項。極客時間專欄作者,著有多部技術圖書。

吳軍,中國科學院機器學習專業博士,十餘年AI算法研發與團隊管理經驗。曾任同花順算法總監、螞蟻集團高級算法專家。主導大模型、推薦係統、智能投顧、金融營銷增長等核心項目,在生成式推薦、智能金融助理等方向取得多項業務成果。擁有發明專利23項、軟件著作權5項。

陳文浩,某國有控股金融科技公司首席架構師,上海市“黃浦智慧工匠”,連續創業者。擁有十餘年金融科技領域技術研發與架構設計經驗,主導多個大型金融係統的架構設計與實施。精通分布式係統、微服務、雲原生、AI大模型應用。翻譯出版了《Python函數式編程(第2版)》。

Codex快速入門:Harness工程落地 目錄

第1章Codex是聊天機器人,更是交付工具1
1.1 AI編程工具的三次演進:從代碼補全到智能體1
1.2 為什麼Codex是軟件工程交付工具4
1.3 從“會寫代碼”到“能交付任務”:心智模型的轉變8
1.4 規則優先於“更聰明”:工程視角下的Codex使用哲學13
本章小結16
第2章AI編程的最小原理——知道邊界在哪裏18
2.1大語言模型為什麼能處理代碼18
2.2Codex完成任務時依賴什麼20
2.3第一條邊界:信息永遠不完整23
2.4第二條邊界:Codex會犯三類工程錯誤26
2.5從邊界意識到協作方法28
本章小結29
第3章第一次任務:跑通一條閉環30
3.1 安裝與登錄:先把入口跑通30
3.2 任務入口選擇:本地執行,還是交給雲端做32
3.3 一次完整任務的執行流程32
3.4 模型選擇41
3.5 安全邊界:哪些任務不應交給Codex42
3.6 可複用的工作流44
本章小結45
第4章Codex的任務地圖47
4.1IDE、CLI、App、Web各自做什麼47
4.2Free、Plus、Pro、Business、Enterprise版本各自適合哪類用戶52
4.3手機入口:移動值守與生態橋接層54
4.4哪些任務適合放在本地,哪些任務適合放在雲端56
4.5Review、Automation、Worktree的角色60
4.6任務地圖的邊界:不是所有的任務都適合直接委派63
本章小結64
第5章第一個可複用工作流:在emotional_chat項目中穩定複用66
5.1進入emotional_chat項目前的最小確認66
5.2讓倉庫支撐Agent:readiness、腳本與局部驗證70
5.3走完整條鏈路:一次最小變更的閉環73
5.4個人個人閉環到團隊資產:複用、成本與模型選擇78
本章小結83
第6章AGENTS.md:給Agent的項目說明書84
6.1項目地圖、關鍵入口與禁區84
6.2根目錄與子目錄分層87
6.3團隊規則與個人偏好90
6.4角色分工、交接協議與值班邊界92
6.5三類模板:新項目/遺留項目/團隊項目95
本章小結100
第7章Rules、Hooks與Approvals:先約束,再放權102
7.1為什麼實現智能之前要先控製102
7.2自動格式化、測試、審計、阻斷106
7.3審批點怎麼設計110
7.4高風險倉庫的護欄模板114
本章小結118
第8章Skill、Subagent與MCP:用Harness把能力和上下文裝進係統119
8.1從劇本到Harness:什麼時候值得能力化119
8.2Subagent如何拆分複雜任務122
8.3MCP:先問是否值得接,再問怎麼接125
8.4Skill、Subagent和MCP相互協同,而不是堆疊複雜度127
本章小結130
第9章場景一:接手陌生代碼庫131
9.1Subagent:從串行閱讀到全局俯瞰131
9.2 AGENTS.md:給AI定規矩135
9.3 先理解,再修改140
9.4 產出審查友好的最小變更141
9.5 遺留項目的Harness工程142
本章小結145
第10章場景二:修複bug、補測試、做回歸146
10.1 複現問題:從錯誤日誌到結構化的bug報告146
10.2 約束修改範圍:防止“順手”重構148
10.3 AI生成測試:從表麵達標到真正可靠149
10.4 驗證閉環:複現→修複→回歸155
本章小結158
第11章場景三:跨前後端功能開發159
11.1 需求的結構化拆解:從模糊到精確159
11.2 API契約的演進:從手動同步到自動生成161
11.3 數據庫遷移:風險最高的一步164
11.4 漸進式交付:從寫完就發布到灰度發布167
11.5 一次通過率:信息對齊是核心170
本章小結171
第12章場景四:PR、Review與CI/CD自動化172
12.1 非交互模式:無人值守的前提條件172
12.2 CI自修複:從構建失敗到自動提交PR173
12.3 AI輔助代碼審查176
12.4 超越代碼審查:安全掃描與GitOps的演進178
12.5 自動化的邊界:風險分級與信任建立181
本章小結182
第13章從個人開發助手到團隊級研發流程184
13.1什麼時候值得推行團隊化184
13.2共享規則、權限與能力包187
13.3Worktrees、雲端任務與異步協作190
13.4小團隊試點落地的合理順序194
本章小結196
第14章Codex的邊界、風險與工程方法論197
14.1幻覺、越界與錯誤歸因197
14.2版權、隱私與安全邊界200
14.3讓Agent做高噪聲工作,讓人做關鍵判斷202
14.4從一次成功到長期可複用的工作流204
14.5配套倉庫、模板與在線更新機製206
本章小結208
······

最後修改:2026 年 11 月 19 日