瀏覽 1.1.1 文件
1.1.1

迴歸工作流程

定位出問題的修訂,隔離修復,補上回歸測試,並完成新的 Task。

適用對象: 開發者與 coding agent

場景#

現有的密碼控制元件對鍵盤觸發不再正確響應。修復既要保住原本預期的行為, 還要補一個能在出問題那次修訂上失敗的測試。

定位出問題的狀態#

在決定怎麼修之前,先看一眼相關的那一行,或者一段有界的範圍。

程式碼 · bash
ait blame src/LoginForm.tsx --line 84

結果會把這行原始碼和它對應的 Snapshot、以及能拿到的 Plan 沿革串起來。 這些證據回答的是行為什麼時候進的歷史;怎麼修,它不替你定。

新建一個修復 Task#

給這次迴歸記一條新的 sprint 條目,別去重開已經完成的工作。

程式碼 · markdown
# 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]
程式碼 · bash
ait task start \
  --from docs/sprints/password_keyboard_regression.md#login/password-keyboard-regression/repair \
  --intent "Restore password-control keyboard activation"

證明修好了#

agent 只動劃定範圍內的那點行為,加上回歸測試,然後在 Task 工作區裡跑 儲存庫的檢查。

程式碼 · text
4 tests passed

它會記一個新的 Snapshot,後面走的就緒和收尾路徑,跟其他受管控的改動 一模一樣。

程式碼 · bash
ait snapshot create --message "Restore password-control keyboard activation"
ait task finish <task-or-change-id>

兜底規則#

如果 blame 給出的證據不全,或者修著修著超出了說好的範圍,就停下來, 重新劃 Task 的範圍。別覆蓋工作區裡不相干的改動,也別把一個已完成的 Task 當成還在進行的工作重新解讀。

參見 ait blame疑難排解

版本權威

對照 1.1.1 原始碼逐條核對

這一頁是公開文件,不是第二份產品契約。要確認發布權威,請以確切的原始碼和分發契約為準。

所屬元件 Snapshot
  • ait-coreSNP-ED7593DBF982
  • ait-serverSNP-0CCD7DD2A077
  • ait-runnerSNP-35C9C133D2EE
  • ait-pythonSNP-756C731A4CC0
  • ait-nodeSNP-55E90D0A81F1