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