SuperAPI AI 工具集

variants

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:当一个问题已足够明确可以动手实现,但最佳方案不确定、值得通过多次智能体运行对比时,使用该技能准备多个实现变体。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,而非工作流文件。

使用方式:先检查本地事实(git status、AGENTS.md、任务与工作流目录、wt config show),再在 .wt/execution/tasks/<key>.toml 建一个共享任务,在 .wt/config/profiles/<profile>/profile.toml 为每个变体建 profile,每个 matrix profile 必须显式包含 [agent] 段,变体假设写在 [agent.prompt.append].workflow。用 wt config show --profile 校验每个 profile 能解析到 agent 与预期提示词。随后用 wt workflow task --mode matrix --profiles ... 创建工作流,并用 wt workflow show 与查看 TOML 验证。启动用 wt run workflow <workflow-id> --jobs <n>。协调阶段直接检查各 worktree 与 PR、核对检查与评审线程、等机器人评审结束后再处理评论,比较实际 diff 而非仅看完成报告,优先最小充分实现。

适用场景:同一问题的多个竞争性方案对比。限制:不用于相互依赖的切片(应使用 stack),也不用于彼此独立但并非同一问题竞争答案的任务(应使用 batch 或独立工作流)。profile 名应短且体现假设,避免使用 default。若 --jobs 未并发展开 matrix profile,应记为运行时问题,而非把 matrix 解释为串行。选定分支前不要将工作流运行标记完成或落地分支。