浏览 1.0.0 文档
1.0.0 文档修订 2

ait task — 完整参考

启动绑定 Plan 的工作,查看并审计 Task 状态,落地已接纳的工作,或放弃未完成的 Task。

适用人群: coding agent 与维护者

作用边界#

用途: 启动绑定 Plan 的工作,查看并审计 Task 状态,落地已接纳的工作,或放弃未完成的 Task。

影响类别: 改动 Task 生命周期和绑定的工作区;land 只有在接纳之后才推进配置好的目标,而 abandon 执行它确切的帮助文本所描述的、对未完成工作的有界收尾。

覆盖: ait task 下共 7 个公开 help surface。

下面的代码块原样保留 1.0.0 二进制的输出,包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。

完整命令树#

Code · text
ait task
ait task start
ait task list
ait task show
ait task audit
ait task land
ait task abandon

原样输出的 help#

ait task#

二进制描述: Start, inspect, audit, land, or abandon scoped Task lifecycle authority.

Code · text
Start, inspect, audit, land, or abandon scoped Task lifecycle authority.

Usage: ait task <COMMAND>

Commands:
  start    Start one Task and its initial Change in the configured scope or an explicit local/remote compatibility scope; sprint mode uses one exact file-backed Plan item
  list     List the bounded open Task inventory or complete history in one selected scope
  show     Show one Task record from one selected scope
  audit    Read-only audit of one Task against logical main in one selected scope
  land     Land one Task or Change onto logical main with fixed direct mode. The configured workflow mode selects local or remote authority unless mutually exclusive --local or --remote explicitly chooses the compatibility scope. Local land consumes an existing Snapshot; remote land consumes an already-ready selected Patchset. Final Task closeout removes the bound worktree and archives its accepted-head feature Line.
  abandon  Permanently abandon one Task lineage in the configured scope or an explicit local/remote compatibility scope
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

ait task start#

二进制描述: Start one Task and its initial Change in the configured scope or an explicit local/remote compatibility scope; sprint mode uses one exact file-backed Plan item

Code · text
Start one Task and its initial Change in the configured scope or an explicit local/remote compatibility scope; sprint mode uses one exact file-backed Plan item

Usage: ait task start --intent <INTENT> (--from <MARKDOWN_PATH#ITEM_REF> | --title <TITLE>) [--local | --remote <REMOTE>] [--json]

Options:
      --title <TITLE>                  Unbound Task title; required and available only when sprint mode is off
      --intent <INTENT>                Required Task intent in both manual and --from modes
      --from <MARKDOWN_PATH#ITEM_REF>  Sprint-only exact file-backed Plan source; syncs, validates, binds, and derives the Task and initial Change title deterministically
      --local                          Force local authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>                Force the named remote authority even when the configured workflow mode defaults to local
      --json                           Emit the complete machine-readable Task-start result
  -h, --help                           Print help

ait task list#

二进制描述: List the bounded open Task inventory or complete history in one selected scope

Code · text
List the bounded open Task inventory or complete history in one selected scope

Usage: ait task list [OPTIONS]

Options:
      --local            Read local Task authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>  Read Task authority from the named remote even when the configured workflow mode defaults to local
      --all              Show complete Task history instead of the bounded open view
      --json             Emit the selected Task inventory as machine-readable JSON
  -h, --help             Print help

ait task show#

二进制描述: Show one Task record from one selected scope

Code · text
Show one Task record from one selected scope

Usage: ait task show [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            Read local Task authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>  Read Task authority from the named remote even when the configured workflow mode defaults to local
      --json             Emit the complete machine-readable Task record
  -h, --help             Print help

ait task audit#

二进制描述: Read-only audit of one Task against logical main in one selected scope

Code · text
Read-only audit of one Task against logical main in one selected scope

Usage: ait task audit [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            Audit local Task authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>  Audit Task authority on the named remote even when the configured workflow mode defaults to local
      --json             Emit the complete machine-readable audit and recommended action
  -h, --help             Print help

ait task land#

二进制描述: Land one Task or Change onto logical main with fixed direct mode. The configured workflow mode selects local or remote authority unless mutually exclusive --local or --remote explicitly chooses the compatibility scope. Local land consumes an existing Snapshot; remote land consumes an already-ready selected Patchset. Final Task closeout removes the bound worktree and archives its accepted-head feature Line.

Code · text
Land one Task or Change onto logical main with fixed direct mode. The configured workflow mode selects local or remote authority unless mutually exclusive --local or --remote explicitly chooses the compatibility scope. Local land consumes an existing Snapshot; remote land consumes an already-ready selected Patchset. Final Task closeout removes the bound worktree and archives its accepted-head feature Line.

Usage: ait task land [OPTIONS] <TASK_OR_CHANGE_ID>

Arguments:
  <TASK_OR_CHANGE_ID>  Task id or change id to land onto logical main with fixed direct mode. Scope follows workflow-mode unless --local or --remote is provided.

Options:
      --local            Force local draft land even when the configured workflow mode defaults to remote
      --remote <REMOTE>  Force closeout through the named remote's already-ready selected Patchset even when the configured workflow mode defaults to local
      --json             Emit the complete machine-readable land and closeout result
  -h, --help             Print help

ait task abandon#

二进制描述: Permanently abandon one Task lineage in the configured scope or an explicit local/remote compatibility scope

Code · text
Permanently abandon one Task lineage in the configured scope or an explicit local/remote compatibility scope

Usage: ait task abandon [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            Abandon local Task authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>  Abandon Task authority on the named remote even when the configured workflow mode defaults to local
      --json             Emit the complete machine-readable terminal Task record
  -h, --help             Print help

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