浏览 1.0.0 文档
1.0.0 文档修订 2

回归工作流

定位出问题的修订,隔离修复,补上回归测试,并完成新的 Task。

适用人群: 开发者与 coding agent

场景#

现有的密码控件对键盘触发不再正确响应。修复既要保住原本预期的行为, 还要补一个能在出问题那次修订上失败的测试。

定位出问题的状态#

在决定怎么修之前,先看一眼相关的那一行,或者一段有界的范围。

Code · bash
ait blame src/LoginForm.tsx --line 84

结果会把这行源码和它对应的 Snapshot、以及能拿到的 Plan 沿革串起来。 这些证据回答的是行为什么时候进的历史;怎么修,它不替你定。

新建一个修复 Task#

给这次回归记一条新的 sprint 条目,别去重开已经完成的工作。

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

证明修好了#

agent 只动划定范围内的那点行为,加上回归测试,然后在 Task 工作区里跑 仓库的检查。

Code · text
4 tests passed

它会记一个新的 Snapshot,后面走的就绪和收尾路径,跟其他受管控的改动 一模一样。

Code · bash
ait snapshot create --message "Restore password-control keyboard activation"
ait task land <task-or-change-id>

兜底规则#

如果 blame 给出的证据不全,或者修着修着超出了说好的范围,就停下来, 重新划 Task 的范围。别覆盖工作区里不相干的改动,也别把一个已完成的 Task 当成还在进行的工作重新解读。

参见 ait blame故障排查

Version authority

Checked against the exact 1.0.0 source

This page is public documentation, not a second product contract. Use the exact source and distribution contract for release authority.

Owning component Snapshots
  • ait-coreSNP-B06A48DA0245
  • ait-serverSNP-E90456E6425E
  • ait-runnerSNP-6B0A1BB3AFAD
  • ait-pythonSNP-973E3BFAF3DE
  • ait-nodeSNP-F962CC66AA62