ait task — 完整参考
启动绑定 Plan 的工作,查看并审计 Task 状态,落地已接纳的工作,或放弃未完成的 Task。
适用人群: coding agent 与维护者
作用边界#
用途: 启动绑定 Plan 的工作,查看并审计 Task 状态,落地已接纳的工作,或放弃未完成的 Task。
影响类别: 改动 Task 生命周期和绑定的工作区;land 只有在接纳之后才推进配置好的目标,而 abandon 执行它确切的帮助文本所描述的、对未完成工作的有界收尾。
覆盖: ait task 下共 7 个公开 help surface。
下面的代码块原样保留 1.0.0 二进制的输出,包含它给出的每一个参数、选项、 默认值、可选值、冲突关系和必填要求。
完整命令树#
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.
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 helpait 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
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 helpait task list#
二进制描述: List the bounded open Task inventory or complete history in one selected scope
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 helpait task show#
二进制描述: Show one Task record from one selected scope
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 helpait task audit#
二进制描述: Read-only audit of one Task against logical main in one selected scope
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 helpait 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.
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 helpait task abandon#
二进制描述: Permanently abandon one Task lineage in the configured scope or an explicit local/remote compatibility scope
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