SuperAPI AI 工具集

wt-start

部署与运维

查看项目

更新于 10-15 22:14

技能介绍

用途:wt-start 用于启动已准备好的 wt 工作。当任务或工作流尚不存在,或范围、切片顺序、证据、PR 策略、落地策略未确定时,应先用 wt-ready;工作运行后的监控、反馈与评审用 wt-coordinate;评审通过后的落地与清理用 wt-land。本技能消费 wt-ready 的执行交接,产出具体的 TaskRun/worktree/workflow 与 inspect 目标,不在此修改目的、需求、设计或任务图;若启动时发现交接不完整,应返回 wt-ready。

启动前检查:先查看仓库与运行时状态,确认 worktree 是否干净、已有任务/工作流状态;预期有 agent 工作时 Agent 不能为 none;预期工作区自动化时 cmux CLI 与 [workspace] 配置需就绪;基于 issue 的工作流需先配置 issue provider。相关命令:git status --short --branch、git worktree list、git rev-parse --git-common-dir、wt doctor。

任务模型:TaskDocument 位于 <git-common-dir>/wt/tasks/<task>.toml,定义工作;TaskRun 位于 <git-common-dir>/wt/task-runs/<id>.toml,记录一次执行尝试;workflow 文件保存单次、批量或堆叠执行的编排。TaskDocument 存意图而非运行状态,TaskRun 存状态、分支、组、错误与时间戳。缺少 group 表示直接执行;group 匹配 workflow 文件名且该 workflow 的 [[tasks]].run 链接存在时,运行与工作流关联。工作流模式属于 workflow 而非 TaskRun。TaskDocument 与 workflow 任务在启动前必须带有规划估算,在仓库 schema 明确支持机器字段前,估算写在 TaskDocument 正文的 계획 (Planning) 下,以包含预期时长的行表示,而非顶层 TOML 字段。

命令选择:每个选中的 TaskDocument 各自获得 worktree 时用 wt run task <task-key> --base .;多个 TaskDocument 共享一个已保存工作区运行时用 wt workflow task --mode single;任务独立且可基于同一 base 时用 batch;任务顺序重要且每个分支基于前一任务分支时用 stack;一个本地 TaskDocument 跨显式命名 profile 运行时用 matrix。provider issue 可用 wt workflow issue --mode <single|batch|stack>;matrix 仅限本地 TaskDocument。

启动规则:脚本中优先使用显式任务键;启动前检查所选 TaskDocument 正文或 workflow 任务提示,确认每个任务都有 계획 (Planning) 与预期时长,缺失则不要启动,返回 wt-ready 或先更新正文;同时确认交接包含验收检查、规模类别、输出概念或工作流理由,以及相关 PR/落地策略来源。--base . 表示当前分支,--base <branch> 表示显式 base,裸 --base 为交互选择。直接执行 TaskDocument 用 wt run task,仅保存的工作流执行才用 workflow 命令。一次直接 worktree 运行足够时不要准备 workflow;父依赖任务不要用 batch,应用 stack;不要在此决定 PR 或落地偏好;没有 wt agent status 不要报告 TaskRun 正在作为活跃 agent 工作。

启动后:用 git worktree list、find "$common_dir/wt/task-runs"、wt inspect <branch|worktree|task-run-id>、wt agent status <branch|worktree|task-run-id> 验证运行并捕获 inspect 目标,报告所用命令、创建的分支/worktree 或 workflow、可用时的 TaskRun id 及下一个 wt inspect 目标;若 agent 仍在运行且需等待状态转换,用 wt agent watch <target>。

限制:本技能只负责启动,不负责规划、监控、评审与落地;不在此修改需求与设计;不决定 PR 与落地策略;matrix 模式不支持 provider issue;缺少预期时长等规划信息时不得启动。