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