1.0.0 文档修订 2

故障排查

先用只读证据，保住可恢复的状态，并照着 AIT 给出的确切恢复提示走。

适用人群： 开发者与运维

先看只读证据#

这些恢复步骤针对的是锁定版本的 1.0.0 命令面。

别去猜工作区、Task 或远程是不是健康的。先跑一条和症状对得上的窄范围只读命令。

Code · bash

ait status --json
ait diff --stat
ait queue summary
ait worktree status --json

把确切的报错和下一步提示原样留着。AIT 的决策面是有意把那条能安全推进或安全查看当前状态的命令报出来的。

在打算作为仓库根的目录下执行 ait init。如果 .ait 目录已经存在但不完整，别盲目替换它；先看报错，只有在确实对得上所报状况时，才使用那个有界的修复选项。

选定修复方案之前，先对最小的有用源码范围跑 ait blame。

Code · bash

ait blame <path> --line <number>

把修复记进新的 sprint 条目和 Task。已完成的沿革仍然是历史证据。

重新物化之前，先查 Task 和 worktree。

Code · bash

ait task audit <task-id>
ait worktree doctor --refresh --json

照着那个 Task 报出来的确切恢复命令走。保留无关的工作区改动，别删任何没被精确认定为 AIT 所有的路径。

再跑一次纯文本的就绪查看面，照它写明的关卡走。

Code · bash

ait workflow ready <change-id> --apply

本地测试通过，替代不了必需的远程 CI。评审、策略、attestation 或 CI 关卡挂了，就得一直显示出来，直到对应的证据被修好为止。

检查配置的远程、server 健康状况、仓库索引、runner 兼容性，以及仓库自己持有的 CI 入口。别为了绕开故障，就把一个有远程支撑的 Task 切到另一个权威上去。

当恢复需要用户做新决定时，就地停下，保持当前 Task、Snapshot 和 worktree 原样。报出确切的标识符、失败的关卡、命令输出，以及上一次成功的验证。

Version authority

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

Owning component Snapshots