1.0.0
文档修订 2
回归工作流
定位出问题的修订,隔离修复,补上回归测试,并完成新的 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 land <task-or-change-id>兜底规则#
如果 blame 给出的证据不全,或者修着修着超出了说好的范围,就停下来, 重新划 Task 的范围。别覆盖工作区里不相干的改动,也别把一个已完成的 Task 当成还在进行的工作重新解读。