浏览 1.0.0 文档
1.0.0 文档修订 2

核心概念

理解那些把意图、隔离的工作、不可变状态、证据与收尾串起来的仓库对象。

适用人群: 开发者与集成方

Repository 与 Line#

Repository 是某个工作目录在本地的 AIT 权威。Line 是一个有 名字、可移动的指针,指向已被接纳的 Snapshot。main 是常见的初始 Line;每个 Task 会拿到自己的功能 Line 和绑定的工作区。

Plan 条目#

Plan 记录带版本的 Markdown 沿革。在 sprint 模式下,一个稳定的 [plan-ref: ...] 标识整份文档,而带有确切 [ref: ...] 的那个未 勾选清单项,就是可以开成 Task 的单位。

Code · markdown
# Password Visibility [plan-ref: login/password-visibility/root]

- [ ] Add the accessible control and focused tests. [ref: login/password-visibility/implement]

条目写的是要达成的结果,不是让你顺手做几件互不相干的改动。

Task、Change 与工作区#

Task 是绑定 Plan 意图的有界工作单元,Change 是它可供评审的 改动沿革。Task 绑定的工作区把实现和目标 Line 隔开,直到结果被 接纳为止。

启动 Task 的那条命令会打印出确切的工作区路径。agent 必须在那里 改代码,不能在仓库的规范根目录里改。

Snapshot#

Snapshot 是不可变的仓库状态,带作者信息和父级历史。它记录的是 完成后的代码状态;它不会为了把文档沿革藏进代码历史,就顺带塞进一处 无关的 Markdown Plan 改动。

Patchset 与证据#

在有远程支撑的工作流里,Patchset 是某个 Change 被选中的评审 候选。CI、attestation、评审和策略这几类证据,都在最终收尾之前挂到这个候选 上。

纯本地的工作不需要远程基础设施。但它配置的接纳策略照样决定了完成 之前必须验证哪些东西。

收尾#

收尾会推进配置好的目标 Line,完成 Task,清理绑定的工作区,并执行 仓库的 sprint 清单策略。远程工作可能要在代码收尾之后单独再做一步: 更新最后那个 Markdown 复选框,并同步 Plan。

相关参考#

接着看 并行 Task 隔离, 或者打开 ait planait taskait snapshotait workflow 查具体的命令说明。

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