1.1.1
迴歸工作流程
定位出問題的修訂,隔離修復,補上回歸測試,並完成新的 Task。
適用對象: 開發者與 coding agent
場景#
現有的密碼控制元件對鍵盤觸發不再正確響應。修復既要保住原本預期的行為, 還要補一個能在出問題那次修訂上失敗的測試。
定位出問題的狀態#
在決定怎麼修之前,先看一眼相關的那一行,或者一段有界的範圍。
ait blame src/LoginForm.tsx --line 84結果會把這行原始碼和它對應的 Snapshot、以及能拿到的 Plan 沿革串起來。 這些證據回答的是行為什麼時候進的歷史;怎麼修,它不替你定。
新建一個修復 Task#
給這次迴歸記一條新的 sprint 條目,別去重開已經完成的工作。
# Password Keyboard Regression [plan-ref: login/password-keyboard-regression/root]
- [ ] Restore native keyboard activation and lock it with a regression test. [ref: login/password-keyboard-regression/repair]ait task start \
--from docs/sprints/password_keyboard_regression.md#login/password-keyboard-regression/repair \
--intent "Restore password-control keyboard activation"證明修好了#
agent 只動劃定範圍內的那點行為,加上回歸測試,然後在 Task 工作區裡跑 儲存庫的檢查。
4 tests passed它會記一個新的 Snapshot,後面走的就緒和收尾路徑,跟其他受管控的改動 一模一樣。
ait snapshot create --message "Restore password-control keyboard activation"
ait task finish <task-or-change-id>兜底規則#
如果 blame 給出的證據不全,或者修著修著超出了說好的範圍,就停下來, 重新劃 Task 的範圍。別覆蓋工作區裡不相干的改動,也別把一個已完成的 Task 當成還在進行的工作重新解讀。