【小白指南針】AI Coding自動(dòng)化編程從01的蛻變二讓 Coding Agent 從偶爾好用變成穩(wěn)定可靠本章是新手容易遇到的坑不解決很容易就會(huì)跟AI“吵起來”你的 agent 的好壞70% 取決于你給它的環(huán)境30% 取決于模型本身。把環(huán)境搭好而不是不斷換模型期待奇跡發(fā)生。文章目錄【小白指南針】AI Coding自動(dòng)化編程從01的蛻變二讓 Coding Agent 從偶爾好用變成穩(wěn)定可靠前言1. 為什么需要優(yōu)化 Agent1.1 一個(gè)實(shí)驗(yàn)1.2 Agent 常見的失敗模式1.3 一百萬行代碼的實(shí)驗(yàn)1.4 核心結(jié)論2. Harness Engineering 核心概念2.1 什么是 Harness2.2 Harness 五子系統(tǒng)2.3 AGENTS.md 是路由器不是百科全書2.4 初始化必須獨(dú)立2.5 倉庫是唯一事實(shí)來源2.6 初始化驗(yàn)收清單3. 我們的實(shí)施方案3.1 架構(gòu)總覽3.2 全局層一次配置所有項(xiàng)目生效3.3 項(xiàng)目層每次 /init 生成3.4 完整的開工流程3.5 為什么這個(gè)順序不能亂3.6 高級初始化/init --advanced4. 團(tuán)隊(duì)接入指南4.1 如果你是 MiMoCode 用戶4.2 如果你使用其他 Coding Agent4.3 與其他工具集成5. 國產(chǎn) Coding Agent 對比5.1 概覽5.2 MiMoCode小米5.3 Trae字節(jié)跳動(dòng)5.4 如何選擇5.5 關(guān)于 Harness 的特別說明6. 總結(jié)與后續(xù)行動(dòng)6.1 核心要點(diǎn)回顧6.2 團(tuán)隊(duì)行動(dòng)清單下期介紹前言在上一篇中講了如何在自己電腦上搭建Agent的工作環(huán)境本期將下我們及我團(tuán)隊(duì)的小伙伴遇到的坑近期Claude code 后門事件導(dǎo)致我們不得不被集團(tuán)要求棄用Claude code因?yàn)槭菄笏晕蚁胱屛覉F(tuán)隊(duì)成員能一步到位用國產(chǎn)或開源方案的Coding Agent。在多方對比及其他方面考量下選擇了小米的MIMO code。所以我正好借著這個(gè)機(jī)會(huì)幫我團(tuán)隊(duì)的小伙伴解決下這些問題。1:AI說做完了但是根本不能用或者理解錯(cuò)誤2:讓它改一個(gè)功能它順手把我其他不合理但我不需要?jiǎng)拥墓δ芨牧诉€可能導(dǎo)致原本好的功能有問題了眾所周知代碼能跑就不要?jiǎng)?:第二天開機(jī)后他不知道昨天干了啥好多問題重新說才行嚴(yán)重浪費(fèi)時(shí)間。。。。。。提示以下是本篇文章正文內(nèi)容下面案例可供參考適用對象所有使用 AI Coding Agent 的研發(fā)團(tuán)隊(duì)成員前置要求至少使用過任意一款 AI Coding AgentMiMoCode、Claude Code、Cursor 等操作系統(tǒng)Mac OS 15.7.8 、M4Pro芯片、128GAgent工具M(jìn)IMO code模型GLM5.2、DeepSeek V4 flash/pro、Kimi K31. 為什么需要優(yōu)化 Agent1.1 一個(gè)實(shí)驗(yàn)Anthropic 做過一個(gè)對照實(shí)驗(yàn)。同一個(gè) prompt——“做一個(gè) 2D 復(fù)古游戲編輯器”——同一個(gè)模型 Opus 4.5跑了兩次裸跑帶 Harness耗時(shí)20 分鐘6 小時(shí)花費(fèi)$9$200結(jié)果核心功能跑不起來游戲可以正常游玩模型沒變變的是馬具Harness。1.2 Agent 常見的失敗模式失敗模式實(shí)際表現(xiàn)根因新會(huì)話摸黑新會(huì)話花大量時(shí)間重新摸索狀態(tài)和啟動(dòng)方式缺少狀態(tài)持久化范圍蔓延一次啟動(dòng)多個(gè)功能最后沒有一個(gè)完整收尾缺少范圍約束提前宣布完成代碼改了就說完成了但沒有可運(yùn)行證據(jù)缺少驗(yàn)證門禁啟動(dòng)脆弱每輪會(huì)話都要重新學(xué)怎么啟動(dòng)項(xiàng)目缺少標(biāo)準(zhǔn)啟動(dòng)路徑交接薄弱下一輪看不出哪里可用、哪里壞了、接下來做什么缺少交接機(jī)制評審主觀質(zhì)量判斷依賴個(gè)人記憶和感覺缺少量化評分1.3 一百萬行代碼的實(shí)驗(yàn)2025 年OpenAI 的三個(gè)工程師做了一個(gè)實(shí)驗(yàn)他們不寫代碼只讓 Codex 寫。從一個(gè)空的 git 倉庫起步五個(gè)月下來倉庫里有了約 100 萬行代碼。三個(gè)工程師一共開了 1,500 個(gè) PR平均每人每天 3.5 個(gè)。他們的核心發(fā)現(xiàn)每當(dāng)某件事做砸了問題幾乎從來不是不夠努力而是 agent 還缺什么——缺的能力能不能用一種既可理解又可執(zhí)行的方式補(bǔ)上去。1.4 核心結(jié)論模型能力和執(zhí)行可靠性是兩回事。遇到失敗先看 harness再看模型。換模型是成本最高的選擇很多情況下根本不是模型的問題。2. Harness Engineering 核心概念2.1 什么是 HarnessHarness 模型權(quán)重之外的一切工程基礎(chǔ)設(shè)施。包括指令文件、可用工具、運(yùn)行環(huán)境、狀態(tài)管理、驗(yàn)證反饋。不是模型權(quán)重的部分全是 harness。項(xiàng)目規(guī)則AGENTS.mdAI Agent進(jìn)度與狀態(tài)progress.md / git工具shell / 文件 / 測試運(yùn)行環(huán)境依賴 / 服務(wù) / 版本檢查結(jié)果test / lint / build2.2 Harness 五子系統(tǒng)子系統(tǒng)職責(zé)典型實(shí)現(xiàn)指令告訴 agent 項(xiàng)目規(guī)則和約束AGENTS.md、instructions.md工具確保 agent 有足夠的操作能力shell 訪問、文件讀寫、CLI環(huán)境讓環(huán)境可重現(xiàn)、自描述package.json、pyproject.toml、Docker狀態(tài)跨會(huì)話保持工作連續(xù)性progress.md、feature_list.json、git反饋驗(yàn)證工作是否正確測試命令、lint、類型檢查五個(gè)子系統(tǒng)缺一個(gè)harness 就不完整。2.3 AGENTS.md 是路由器不是百科全書核心原則AGENTS.md 控制在 50-200 行只做三件事項(xiàng)目概覽和快速開始不可違反的硬約束不超過 15 條指向?qū)ｎ}文檔的路由表# AGENTS.md — 路由器不是百科全書 ## 文件路由什么是路由表 | 文件 | 用途 | 何時(shí)讀取 | |------|------|---------| | AGENTS.md | 工作規(guī)則與路由 | 每輪開工時(shí) | | init.sh | 啟動(dòng)與驗(yàn)證入口 | 每輪開工時(shí)運(yùn)行 | | templates/feature_list.json | 功能狀態(tài) | 選擇功能時(shí) | | templates/mimo-progress.md | 進(jìn)度記錄 | 開工、收尾時(shí) | | templates/session-handoff.md | 會(huì)話交接 | 結(jié)束時(shí)選寫 | | templates/evaluator-rubric.md | 評審評分 | 功能完成時(shí) |為什么要這樣做一個(gè) 600 行的指令文件關(guān)鍵約束埋在中間會(huì)被忽略Lost in the Middle效應(yīng)。拆分后信噪比提升agent 把更多上下文花在實(shí)際任務(wù)上。2.4 初始化必須獨(dú)立初始化階段的目標(biāo)和功能實(shí)現(xiàn)完全不同初始化階段實(shí)現(xiàn)階段目標(biāo)搭好基礎(chǔ)設(shè)施交付功能產(chǎn)出啟動(dòng)腳本、進(jìn)度文件、任務(wù)分解業(yè)務(wù)代碼驗(yàn)收標(biāo)準(zhǔn)能啟動(dòng)、能測試、能看進(jìn)度、能接手測試通過混在一起的代價(jià)Agent 傾向于寫代碼直接可見犧牲基礎(chǔ)設(shè)施在測試框架配好之前寫的功能可能設(shè)計(jì)上就有問題上下文預(yù)算被初始化任務(wù)吃掉功能部分反而做不好正確做法第一個(gè)會(huì)話只做初始化不寫業(yè)務(wù)代碼。初始化投入的時(shí)間會(huì)在后續(xù) 3-4 個(gè)會(huì)話中完全收回。2.5 倉庫是唯一事實(shí)來源Agent 看不到的東西對它來說就不存在。所有必要的上下文都必須在倉庫里項(xiàng)目規(guī)則 →AGENTS.md功能狀態(tài) →feature_list.json進(jìn)度記錄 →mimo-progress.md啟動(dòng)腳本 →init.sh架構(gòu)決策 → 架構(gòu)文檔不要依賴聊天記錄或人的記憶。如果一個(gè)新 agent 會(huì)話只靠倉庫內(nèi)容無法回答這個(gè)項(xiàng)目做什么、怎么啟動(dòng)、怎么驗(yàn)證、還有什么沒做完、下一步做什么那 harness 就是不完整的。2.6 初始化驗(yàn)收清單條件說明? 能啟動(dòng)init.sh從零運(yùn)行成功? 能測試基礎(chǔ)測試通過? 能看進(jìn)度mimo-progress.md存在且最新? 能接手下一步feature_list.json列出下一個(gè)最優(yōu)先功能3. 我們的實(shí)施方案3.1 架構(gòu)總覽項(xiàng)目層 (項(xiàng)目根)全局層 (~/.config/mimocode/)自動(dòng)注入生成生成生成生成開工時(shí)讀取路由到instructions.md永久注入系統(tǒng)提示commands/init.md內(nèi)置模板 完整流程initializer-agent-playbook.md初始化操作手冊AGENTS.md路由器指向各文件init.sh動(dòng)態(tài)生成的啟動(dòng)腳本templates/功能狀態(tài)、進(jìn)度、交接、檢查、評審、質(zhì)量.gitignore忽略.mimocode/和會(huì)話文件3.2 全局層一次配置所有項(xiàng)目生效文件位置作用instructions.md~/.config/mimocode/每輪會(huì)話自動(dòng)注入 3 條規(guī)則檢查 AGENTS.md、運(yùn)行 init.sh、固定開工流程commands/init.md~/.config/mimocode/覆蓋內(nèi)置/init命令內(nèi)嵌全套模板/init --advanced生成高級治理結(jié)構(gòu)initializer-agent-playbook.md~/.config/mimocode/初始化操作手冊列出必需產(chǎn)出和成功標(biāo)準(zhǔn)3.3 項(xiàng)目層每次/init生成文件生成方式是否提交 gitAGENTS.md內(nèi)嵌模板? 提交init.sh動(dòng)態(tài)生成檢測 package.json / pyproject.toml / Cargo.toml / go.mod 等? 提交templates/feature_list.json內(nèi)嵌模板? 提交templates/session-handoff.md內(nèi)嵌模板? 提交templates/clean-state-checklist.md內(nèi)嵌模板? 提交templates/evaluator-rubric.md內(nèi)嵌模板? 提交templates/quality-document.md內(nèi)嵌模板? 提交templates/codebase-analysis.md代碼庫掃描原始 init 邏輯? gitignoretemplates/mimo-progress.md內(nèi)嵌模板? gitignore項(xiàng)目實(shí)際執(zhí)行截圖3.4 完整的開工流程每輪新會(huì)話開始 ┌─────────────────────────────────────┐ │ 1. pwd 確認(rèn)在正確的項(xiàng)目根 │ │ 2. 讀取 AGENTS.md → 獲取文件路由 │ │ 3. 讀取 templates/mimo-progress.md │ │ 4. 讀取 templates/feature_list.json │ │ 5. git log --oneline -5 │ │ 6. 運(yùn)行 ./init.sh │ │ 7. 跑基礎(chǔ)驗(yàn)證 │ │ │ │ 如果基礎(chǔ)驗(yàn)證失敗先修基礎(chǔ)狀態(tài)。 │ │ 只選一個(gè)未完成功能圍繞它工作到完成。 │ └─────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────┐ │ 結(jié)束前 │ │ 1. 更新 mimo-progress.md │ │ 2. 更新 feature_list.json │ │ 3. 記錄 blocker │ │ 4. 提交代碼 │ │ 5. 確保下一輪可直接運(yùn)行 ./init.sh │ └─────────────────────────────────────┘3.5 為什么這個(gè)順序不能亂步驟為什么必須先做pwd防止在錯(cuò)誤目錄里干活讀進(jìn)度 功能清單先恢復(fù)持久狀態(tài)避免在錯(cuò)誤假設(shè)上開工git log了解剛剛發(fā)生了什么運(yùn)行init.sh讓啟動(dòng)過程標(biāo)準(zhǔn)化不靠記憶基礎(chǔ)驗(yàn)證先跑避免在壞狀態(tài)上繼續(xù)疊改動(dòng)3.6 高級初始化/init --advanced當(dāng)項(xiàng)目進(jìn)入多模塊/多階段/多角色協(xié)作階段運(yùn)行/init --advanced額外生成ARCHITECTURE.md docs/ ├── design-docs/index.md ├── design-docs/core-beliefs.md ├── exec-plans/active/ ├── exec-plans/completed/ ├── exec-plans/tech-debt-tracker.md ├── product-specs/index.md ├── references/*.txt (llms.txt 格式) ├── QUALITY_SCORE.md ├── RELIABILITY.md ├── SECURITY.md └── FRONTEND.md sops/ (標(biāo)準(zhǔn)操作流程)所有模板內(nèi)嵌在命令中無需額外查閱資料。4. 團(tuán)隊(duì)接入指南4.1 如果你是 MiMoCode 用戶已經(jīng)自動(dòng)生效。全局配置已在所有環(huán)境中部署在任何項(xiàng)目下輸入/init→ 自動(dòng)走定制邏輯新會(huì)話開始 → 全局instructions.md自動(dòng)注入 AGENTS.md 檢查規(guī)則項(xiàng)目級.mimocode/mimocode.json配置instructions: [../AGENTS.md]→ AGENTS.md 內(nèi)容注入系統(tǒng)提示4.2 如果你使用其他 Coding Agent雖然/init命令是 MiMoCode 特有的但生成的文件是純文本所有人都能讀。Claude Code 用戶查看項(xiàng)目根AGENTS.md→ 內(nèi)容與CLAUDE.md結(jié)構(gòu)一致可直接參考運(yùn)行init.sh→ 標(biāo)準(zhǔn) bash 腳本所有 shell 環(huán)境通用讀取templates/下的文件 → 純 markdown / JSONCursor 用戶同樣可讀AGENTS.md和templates/下的文件可以將 AGENTS.md 內(nèi)容復(fù)制到.cursorrules中Codex CLI 用戶文件結(jié)構(gòu)完全兼容Codex 原生支持AGENTS.md4.3 與其他工具集成工具與模板體系的兼容方式CI/CDinit.sh中的驗(yàn)證命令可直接用于 CI 流水線項(xiàng)目管理feature_list.json可與 Jira / Linear / Notion 同步代碼評審evaluator-rubric.md可作為 PR 模板的評審標(biāo)準(zhǔn)文檔AGENTS.md可作為團(tuán)隊(duì) Wiki 的入口文檔5. 國產(chǎn) Coding Agent 對比5.1 概覽特性MiMoCodeTrae (字節(jié))Claude CodeCursorCodex CLI開發(fā)商小米字節(jié)跳動(dòng)AnthropicAnysphereOpenAI基座模型DeepSeek / 自研自研 / GPTClaude多模型GPT / o 系列運(yùn)行方式TUI CLIIDE 插件CLI TUIIDE (VS Code 分支)CLIHarness 支持??????????????????自定義指令A(yù)GENTS.md / instructions.md有限規(guī)則CLAUDE.md.cursorrulesAGENTS.md持久化記憶原生checkpoint memory無會(huì)話級有限有限子智能體原生支持explore/general有限有有限有自定義命令?markdown 文件熱加載????Hook/插件?hook TUI 插件???擴(kuò)展?工作流編排?workflow.js????工程模式定時(shí)任務(wù)?cron/loop????跨會(huì)話連續(xù)???????????????開源?基于 OpenCode 的閉源分支????5.2 MiMoCode小米優(yōu)勢國產(chǎn)自主可控模型和服務(wù)均在國內(nèi)Harness 能力最完整instructions 注入、commands 熱加載、hook 機(jī)制、workflow 編排、cron/loop 定時(shí)任務(wù)——五子系統(tǒng)的反饋和狀態(tài)方面遠(yuǎn)超同類持久化記憶checkpoint memory 系統(tǒng)跨會(huì)話自動(dòng)重建上下文子智能體編排explore/general 子智能體 actor 工具可做并行搜索和多步驟編排自定義擴(kuò)展性強(qiáng)tools/hooks/skills/workflows/TUI 插件每一層都可改寫對 DeepSeek 優(yōu)化作為小米產(chǎn)品對國產(chǎn)模型的適配和優(yōu)化最深入劣勢生態(tài)較小相比于 Cursor 和 Claude Code社區(qū)規(guī)模和第三方資源較少閉源核心代碼不公開依賴小米的更新節(jié)奏品牌認(rèn)知度在開發(fā)者群體中的知名度不如 Claude Code 或 Cursor適合場景需要深度 Harness 定制和自動(dòng)化的團(tuán)隊(duì)注重?cái)?shù)據(jù)安全、在國內(nèi)部署的團(tuán)隊(duì)使用 DeepSeek 等國產(chǎn)模型的團(tuán)隊(duì)需要跨會(huì)話長時(shí)間運(yùn)行的復(fù)雜開發(fā)流程5.3 Trae字節(jié)跳動(dòng)優(yōu)勢字節(jié)跳動(dòng)出品背靠國內(nèi)最大的 AI 團(tuán)隊(duì)之一IDE 插件形式直接在 VS Code 中工作學(xué)習(xí)成本低多模型支持可使用字節(jié)自研模型和 GPT劣勢Harness 能力弱缺乏指令文件支持、無持久化記憶、無子智能體機(jī)制橫主要面向即時(shí)編碼輔助不適合長時(shí)間運(yùn)行的多會(huì)話任務(wù)定制能力有限不支持自定義命令、hook 或工作流編排適合場景簡單的代碼輔助和補(bǔ)全單次會(huì)話的編碼任務(wù)不涉及復(fù)雜跨會(huì)話協(xié)作的團(tuán)隊(duì)5.4 如何選擇如果你的團(tuán)隊(duì)…推薦選擇需要長時(shí)間運(yùn)行的多會(huì)話開發(fā)MiMoCode / Claude Code需要深度定制 agent 行為MiMoCodecommands hooks workflows注重?cái)?shù)據(jù)安全和國內(nèi)部署MiMoCode / Trae需要并行子智能體編排MiMoCodeactor 系統(tǒng)只需要即時(shí)編碼輔助Trae / Cursor需要開源可控Codex CLI5.5 關(guān)于 Harness 的特別說明無論選哪款 agentHarness 工程的核心方法都適用。即使你用的是 Cursor在項(xiàng)目根放一個(gè)AGENTS.md并固定開工流程效果也會(huì)有明顯提升即使你用的 Trae維護(hù)feature_list.json和mimo-progress.md也能改善跨會(huì)話連續(xù)性模板文件全是純文本工具無關(guān)誰都能用Harness 的價(jià)值在于方法論不在于工具。好的 harness 能讓一個(gè)中等模型完成高質(zhì)量工作差的 harness 能讓最強(qiáng)模型不斷犯錯(cuò)。6. 總結(jié)與后續(xù)行動(dòng)6.1 核心要點(diǎn)回顧模型能力和執(zhí)行可靠性是兩回事— 失敗時(shí)先查 harness而不是急著換模型Harness 指令 工具 環(huán)境 狀態(tài) 反饋— 五個(gè)子系統(tǒng)缺一不可AGENTS.md 是路由器不是百科全書— 保持短入口詳情指向單獨(dú)文件初始化必須獨(dú)立— 不要跟功能實(shí)現(xiàn)混在一起倉庫是唯一事實(shí)來源— 所有必要的上下文都放在倉庫里不依賴聊天記錄反饋?zhàn)酉到y(tǒng)投入產(chǎn)出比最高— 先把驗(yàn)證命令寫清楚6.2 團(tuán)隊(duì)行動(dòng)清單本周在主力項(xiàng)目根運(yùn)行/init或手動(dòng)創(chuàng)建等效文件建立 AGENTS.md init.sh本周在AGENTS.md中寫入驗(yàn)證命令test / lint / typecheck兩周內(nèi)將現(xiàn)有功能拆解到feature_list.json中標(biāo)記狀態(tài)兩周內(nèi)建立跨會(huì)話進(jìn)度記錄習(xí)慣結(jié)束會(huì)話前更新mimo-progress.md一個(gè)月完成第一輪 Harness 審計(jì)按五子系統(tǒng)打分找出最弱的一環(huán)改進(jìn)持續(xù)每次 agent 失敗時(shí)歸因到五子系統(tǒng)的某一層修補(bǔ)記錄下期介紹AI-Coding-Agent-Token成本優(yōu)化與CodeGraph落地培訓(xùn)最后一句你的 agent 的好壞70% 取決于你給它的環(huán)境30% 取決于模型本身。把環(huán)境搭好而不是不斷換模型期待奇跡發(fā)生。— 基于 Learn Harness Engineering 課程walkinglabs與團(tuán)隊(duì)實(shí)戰(zhàn)經(jīng)驗(yàn)整理