1.0.0
文档修订 2
ait plan
记录带版本的 Markdown 沿革，并在配置的范围内同步确切的 sprint 条目。
适用人群： coding agent 与维护者
角色#
通常由 coding agent 运行，作用范围严格照仓库生成的指示里打印的 那一个来。
用途#
ait plan 记录带版本的 Markdown 沿革。在 sprint 模式下，某一个确切 的未勾选清单项会成为 Task 的绑定对象；普通文档同步一下就好，不必开 成 Task。
语法#
ait plan sync <markdown-file-or-dir> --local
ait plan sync <markdown-file-or-dir> --remote origin只用与当前生效的仓库配置相符的那个范围。首次执行的 ait task start --from 负责同步它所绑定的那个 sprint 条目的确切 文件。
示例#
# Password Visibility [plan-ref: login/password-visibility/root]
- [ ] Add the accessible control and focused tests. [ref: login/password-visibility/implement]ait plan sync docs/architecture.md --local输出#
同步会报出 Plan 的标识、修订、执行的动作和发布范围。Plan 的查看类 命令只读取条目和修订，不会改动它们。
失败与恢复#
不要把 Plan ID 复制到 task start 里，也不要把 Markdown 复选框的 改动藏进代码 Snapshot。远程收尾把清单项的更新单独留出来时，直接改 那个绑定的确切条目，再在配置好的远程范围里同步这张 card。