SuperAPI AI 工具集

wt-welcome

通用与其它

查看项目

更新于 10-15 22:14

技能介绍

用途:当用户刚接触 wt、询问如何上手、想了解 wt 技能家族的用途,或在配置和运行工作前需要一张总体地图时,使用该技能。其核心任务是塑造用户的心智模型,而不是把首次回答变成手册、完整命令参考或逐字段配置讲解。

主要能力:给出紧凑的五点模型:wt setup 准备本机;wt init 准备当前仓库的 wt 状态与配置;wt run 开始工作;wt-lifecycle 负责准备、运行、落地并沉淀可复用经验;wt-config 检查当前仓库并推荐合适的配置。说明 wt run 启动的是工作区,不负责评审、落地、清理或长时间协调,这些由 wt-lifecycle 及其阶段技能处理。

使用方式:首次回答按以下顺序展开。先给出上述五点模型;再讲每台机器的设置,说明 shell 集成、agent hooks、cmux 和 agent CLI 属于机器或用户层面的问题,建议运行 wt setup 和 wt doctor,若已知 agent profile 可提到 wt doctor --profile codex;然后简短介绍技能:$wt-config 检查当前仓库并推荐仓库配置,$wt-lifecycle 准备并运行工作、落地或丢弃并沉淀可复用经验,$wt-ready、$wt-work、$wt-land 等阶段技能通常由 $wt-lifecycle 调用。常用 wt run 启动方式包括 wt run branch <words...>、wt run issue、wt run issue PROJ-123 --base .、wt run pr、wt run task、wt run workflow,各自用一句短语说明。最后告诉用户先对当前仓库运行 $wt-config;配置就绪后若要执行实际工作,可指向 $wt-lifecycle。

深入模型:仅在用户要求时展开,简要解释 TaskDocument(存放在 <repo-root>/.wt/execution/tasks/ 下的本地可执行工作单元)、Workflow(将 TaskDocument 或提供方 issue 分组的已保存执行计划)、TaskRun(一次启动执行的记录),以及模式:single 共享一个工作区,batch 运行独立分支,stack 运行有序依赖分支,matrix 将同一任务跑过多个 profile。wt-lifecycle 循环为 $wt-ready -> $wt-work -> $wt-land。

限制与注意:优先说明“谁负责什么”,而非罗列 wt 的全部功能。除非用户明确要求执行,不要运行 wt setup、wt init、wt run 或修改配置。若用户已在仓库中询问下一步,结尾应为“先在这里运行 $wt-config”。若用户已准备好真正干活,配置健康后建议 $wt-lifecycle。