SuperAPI AI 工具集

wt-variants

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:当一个 wt 问题已清楚到可实施、但最佳方案不确定时,用本技能准备多方案对比运行。variant 仅为技能简写,不向 wt 状态添加持久化的 variant 概念。

对象模型:变体表示为一份共享本地 TaskDocument、一个 mode = "matrix" 工作流、每个变体一个命名 profile,以及每个变体一个 profile 专属的 TaskRun/worktree/branch。工作流 TOML 存放 profiles = [...] 与 [[tasks.runs]] 映射;变体指令位于 <repo-root>/.wt/config/profiles/<name>/profile.toml 或 prompts/workflow.append.md,而非工作流文件。

边界:问题仍模糊用 wt-ready;准备变体与 matrix 工作流用本技能;启动、监控、PR 审查、机器人反馈、完成用 wt-work;落地所选分支用 wt-land。有依赖的任务用 stack;相互独立但并非同一问题竞争答案用 batch 或独立工作流。

准备:先查本地实况,运行 git status --short --branch、find 与 wt config show 等。准备 2-4 个变体假设,评估标准包括正确性、diff 大小、测试覆盖、风险、评审反馈及与 docs/consistency.md 的契合度,并写明非目标与风险。

Profile:每个变体一个 profile,必须显式包含 [agent] 段,不能仅靠提示词叠加,否则可能落到 agent.cli = "none"。用 [agent.prompt.append].workflow 写变体假设。profile 名保持短小且形似假设,避免使用 default。准备前用 wt config show --profile 验证每个 profile 能解析到 agent 与预期提示。

工作流:用 matrix 模式、恰好一个任务与所选 profile 列表创建,例如 ./target/debug/wt workflow task --mode matrix --profiles <profile-a>,<profile-b>,<profile-c> --base <base> --pr draft --title "<comparison objective>" <task-key>,再用 wt workflow show 与查看 TOML 验证。启动用 wt-work 或 ./target/debug/wt run workflow <workflow-id> --jobs <n>。

协调:直接查看各 worktree 与 PR,核对检查与评审线程,等待机器人评审结束再处理评论,比较实际 diff,优先最小充分实现,可借用更宽方案的测试或证据。所有变体报告后记录选择、拒绝理由、可挑拣内容、检查与评审状态、未解决风险及下一步;所选工作经证据评审前不得标记完成或落地。

限制:不用于依赖切片;缺少事实的部分资料未提供。