SuperAPI AI 工具集

wt-coordinate

智能体与模型

查看项目

更新于 10-15 22:14

技能介绍

wt-coordinate 是 wt 工作流中负责“协调”阶段的技能,适用于 wt 工作已经启动之后。创建 TaskDocument 或启动新任务/工作流运行应使用 wt-start;审查通过后的合并与清理应使用 wt-land。

用途与边界:coordinate 负责检查运行时状态并解除智能体阻塞;review 负责阅读差异、文件、检查、父分支和智能体报告;complete 针对工作流关联的 TaskRun,用 wt workflow complete 标记已审查的运行中工作流任务完成;land 负责合并或集成已审查提交,由 wt-land 处理;done 用 wt done 移除工作树和本地分支,也由 wt-land 在落地或丢弃后处理。TaskRun 完成并不等于分支已落地;运行时智能体空闲也不等于 TaskRun 完成,而是提示协调者应检查工作树。直接 TaskRun 在落地前没有单独完成命令,wt done 会在清理时把匹配的运行中直接 TaskRun 标记完成;工作流关联的 TaskRun 完成属于 wt workflow complete,清理不得用 wt done 代替该生命周期转换。

检查:先用只读驾驶舱命令 wt inspect <branch|worktree|task-run-id> 和 wt agent status <branch|worktree|task-run-id>,记录 TaskRun id、状态、上下文、工作流/组、分支与父级、工作树路径与脏状态、提交与相对父级的差异、cmux 工作区/表面与运行时状态。脚本中优先用 wt --json agent status <target>。若状态为 running,除非明显卡住,应让智能体继续工作;刚分配工作后等待时,优先用安静心跳 wt agent watch <target> --heartbeat 120,仅在调试疑似停滞、发送聚焦反馈后等待或预期立即转换时用更短心跳。若为 needs_input,检查并发送反馈;若为 idle,应审查工作树而非轮询。

审查:可要求报告作为输入而非证据,例如 wt send <target> "..."。随后直接检查:git -C <worktree> status --short --branch、git -C <worktree> log --oneline <parent>..<branch>、git -C <worktree> diff <parent>...HEAD。行为无法从差异判断时阅读被改文件,并按风险运行检查。wt Rust 改动可优先运行 cargo fmt --all --check、cargo check --locked --all-targets --all-features、cargo clippy --all-targets --all-features -- -D warnings、git diff --check、cargo test --locked --all-features。需要时用 wt send 发送聚焦反馈。仅当 wt send 或 wt agent status 无法解析目标或验证活动表面时,才使用原始 cmux,并先确认该表面是智能体提示。

完成:仅在工作树干净且父级之前存在有用提交后完成。工作流关联运行在审查通过后适用;栈模式下仅当下一栈任务应启动时用 wt workflow complete <workflow> <task> --run-next,单任务、批处理、最终栈任务或后继应等待的栈任务省略 --run-next。不要用 wt done 完成工作流关联工作。

交接:审查通过后把分支交给 wt-land,并提供已审查分支或栈顺序、wt inspect 得到的父级、协调开始时的当前分支、明确已知的目标集成分支、wt workflow show 得到的工作流落地策略、工作树路径与脏/净状态、已运行检查与已知缺口、已运行的栈完成命令。报告协调的分支、发送的反馈、完成命令、最终审查结果、已运行检查和确切的 wt-land 目标。