前面幾篇我們已經(jīng)把項(xiàng)目地圖、狀態(tài)機(jī)和SIADOS講清楚了。這一篇要繼續(xù)往下走回答一個非常實(shí)際的問題當(dāng)前這一輪任務(wù)到底應(yīng)該怎么寫AI 才能看得懂、做得對、不會越界本書把這個問題交給current_task.md。它不是聊天記錄也不是隨手寫的一句口頭要求而是一份短期有效、可以驗(yàn)收、可以回寫狀態(tài)的任務(wù)契約。1. 為什么還要有current_task.md很多時(shí)候人類給 AI 的任務(wù)本來是模糊的。比如你可能會說“把這個 Bug 修一下”“順便把相關(guān)測試補(bǔ)上”“改完以后盡量別影響其他部分”“如果有兼容性風(fēng)險(xiǎn)先記下來”這些話人能聽懂一點(diǎn)但對系統(tǒng)來說并不夠清楚。因?yàn)樗鼪]有把下面幾件事明確寫出來這輪的目標(biāo)到底是什么這輪允許改哪里這輪禁止碰哪里什么結(jié)果算通過哪些歧義需要先確認(rèn)所以本書把這類信息收斂到current_task.md里。它的作用就是把當(dāng)前任務(wù)收窄到一個可執(zhí)行范圍內(nèi)。2. 一輪任務(wù)只能有一個主目標(biāo)current_task.md最重要的原則是單一主任務(wù)原則?！巴瓿身?xiàng)目修復(fù)”“繼續(xù)開發(fā)項(xiàng)目”這種說法只能算長期方向。真正的一輪任務(wù)還必須具體到一件可做、可驗(yàn)收的事。比如修一個 Bug補(bǔ)一個測試改一個接口更新一個狀態(tài)文件記錄一個未決問題。如果一輪任務(wù)太散Agent 就會把相關(guān)事情一起做掉?？雌饋硐瘛绊樖謨?yōu)化”實(shí)際上可能會修改范圍擴(kuò)大任務(wù)目標(biāo)混亂驗(yàn)收條件不清后續(xù)無法回滾。其他重要但不屬于當(dāng)前輪的內(nèi)容應(yīng)該寫入open_issues.md或后續(xù)任務(wù)而不是塞進(jìn)當(dāng)前任務(wù)。3.current_task.md應(yīng)該寫什么一份可執(zhí)行的current_task.md不需要很長但要寫清幾個字段# Current Task ## Task Fix the empty-cart checkout path in checkout/service.py. ## Goal Return a safe error when the cart is empty, while preserving normal checkout behavior. ## Allowed - checkout/service.py - tests/test_checkout.py - revision_log.md - open_issues.md ## Forbidden - auth/* - payment_gateway/* - docs/* - unrelated modules ## Acceptance 1. Empty-cart checkout is handled safely. 2. Normal checkout still passes. 3. Only allowed files changed. 4. Unresolved compatibility concerns are recorded.重點(diǎn)不是格式漂亮而是把任務(wù)變成可檢查的邊界。Agent 看到這份文件以后應(yīng)該能判斷當(dāng)前要做什么修改范圍在哪里哪些地方不能動什么結(jié)果算通過哪些問題需要記錄而不是直接處理。4. 從自然語言到任務(wù)契約這一章很重要的一點(diǎn)是把自然語言輸入“編譯”成任務(wù)契約。比如人說“把這個 Bug 修一下順便保證不影響其他模塊?！边@句話本身并不適合直接執(zhí)行。因?yàn)樗藘蓚€問題“修一下”不夠具體“不影響其他模塊”可能會誘導(dǎo)越界修改所以系統(tǒng)不能直接照著做而要把它編譯成一份結(jié)構(gòu)化任務(wù)目標(biāo)修復(fù)空購物車結(jié)算允許checkout/service.py、tests/test_checkout.py禁止auth/、payment_gateway/驗(yàn)收只檢查結(jié)算路徑和回歸測試這樣Agent 不會把“保證不影響其他模塊”理解成“可以把其他模塊一起改”。它只能在當(dāng)前授權(quán)范圍內(nèi)完成任務(wù)。5. 沖突和歧義怎么處理任務(wù)里經(jīng)常會出現(xiàn)沖突。例如當(dāng)前任務(wù)要求只修結(jié)算邏輯但又有人補(bǔ)了一句順便統(tǒng)一一下認(rèn)證模塊。這時(shí)不能直接執(zhí)行。因?yàn)檎J(rèn)證模塊不在當(dāng)前任務(wù)范圍內(nèi)。current_task.md 應(yīng)該規(guī)定優(yōu)先級1). 安全和系統(tǒng)邊界2). 當(dāng)前任務(wù)的禁止項(xiàng)3). 當(dāng)前任務(wù)目標(biāo)和驗(yàn)收條件4). 補(bǔ)充偏好和軟性建議。也就是說軟性建議不能覆蓋明確邊界。如果 Agent 發(fā)現(xiàn)了相關(guān)問題可以寫入 open_issues.md留給后續(xù)任務(wù)處理。6. 驗(yàn)收條件必須可觀察任務(wù)能不能完成取決于驗(yàn)收條件是否清楚。“寫好一點(diǎn)”“提高質(zhì)量”“盡量優(yōu)化”都不適合作為驗(yàn)收條件。更好的驗(yàn)收條件應(yīng)該是可觀察的空購物車返回安全錯誤正常結(jié)算路徑不受影響只修改允許文件未決兼容性問題已記錄。這些條件可以檢查。可檢查任務(wù)才有結(jié)束點(diǎn)。不可檢查Agent 就容易繼續(xù)猜、繼續(xù)改最后越改越散。本章小結(jié)current_task.md 的作用是把自然語言要求變成一份當(dāng)前輪任務(wù)契約這一輪做什么哪些地方能動哪些地方不能碰什么結(jié)果算通過哪些問題要記錄下來。Agent 不需要每輪重新猜任務(wù)而是在明確邊界里推進(jìn)。下一章我會繼續(xù)講修改日志revision_log.md為什么能幫系統(tǒng)收斂以及它和 Git 的分工到底是什么。