Skip to main content
Glama

run_task

run_task
Idempotent

Starts external AI-agent development tasks asynchronously, returning a task ID and handling objective verification with automated rework for failed acceptance.

Instructions

派活:启动外部 AI-Agent 开发任务并可自动验收返修,异步返回 taskId。ZCode 要求 model=供应商/模型。mode 与 modelSource 已废弃(原为已移除的 GUI 适配器参数),传入会被拒绝(设计取向请改用 designDirection)。task/context 内的 ZCode 项目路径引用会在发送前校验。思考等级按界面实际档位核对,权限模式不变;macOS research 禁止派发。可选 idempotencyKey(1..128 字符):同一 key 在 TTL(默认 24h)内重复提交恒返回原 taskId 与当前状态、不新建任务,参数变更则报冲突——重试请复用同一 key。 可选 dryRun=true 进入干跑模式(先审后做):agent 只分析规划、输出将要修改的文件清单与方案、不动源码;验收引擎只做静态分析(引用文件是否存在、拟改位置是否存在、明显逻辑冲突),跳过 typecheck/test/build。dryRun 需提供 projectPath、忽略 autoVerify、不进入自动返修;产物为独立报告(meta.dryRunReportFiles,不消耗验收轮次)与方案文档(meta.dryRunPlanDoc,可直接作为后续正式任务的 planDoc)。默认关闭。

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "task": "<task>"
    },
    "name": "run_task"
  }
}

Input Schema

NameRequiredDescriptionDefault
modeNo
taskYes
modelNo
dryRunNo
agentIdNo
contextNo
planDocNo
autoVerifyNo
exportKindNo
modelSourceNo
projectPathNo
designSystemNo
autoFixRoundsNo
contextWindowNo
taskTimeoutMsNo
idempotencyKeyNo
reasoningLevelNo
designDirectionNo
acceptanceOverrideNo
allowCreateProjectNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changedv1.0.0-beta.3
    • changedInput schema / properties / acceptanceOverride / properties / visual / additionalProperties
      Previous value: -falseNew value: +{}
    • removedInput schema / properties / acceptanceOverride / properties / visual / properties
      Removed value: -{
      -  "allowedOrigins": {
      -    "default": [],
      -    "items": {
      -      "format": "uri",
      -      "type": "string"
      -    },
      -    "type": "array"
      -  },
      -  "baselineRoot": {
      -    "default": "tests/visual/baselines",
      -    "minLength": 1,
      -    "type": "string"
      -  },
      -  "browser": {
      -    "anyOf": [
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "mode": {
      -            "const": "managed",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "executablePath": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "mode": {
      -            "const": "chrome",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "executablePath": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "mode": {
      -            "const": "edge",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode"
      -        ],
      -        "type": "object"
      -      },
      -      {
      -        "additionalProperties": false,
      -        "properties": {
      -          "executablePath": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "mode": {
      -            "const": "executable",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "mode",
      -          "executablePath"
      -        ],
      -        "type": "object"
      -      }
      -    ],
      -    "default": {
      -      "mode": "managed"
      -    }
      -  },
      -  "content": {
      -    "additionalProperties": false,
      -    "default": {},
      -    "properties": {
      -      "allowRemote": {
      -        "default": false,
      -        "type": "boolean"
      -      },
      -      "argsTemplate": {
      -        "items": {
      -          "minLength": 1,
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "cache": {
      -        "default": true,
      -        "type": "boolean"
      -      },
      -      "command": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "cwd": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -      },
      -      "enabled": {
      -        "default": false,
      -        "type": "boolean"
      -      },
      -      "env": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      -      },
      -      "minConfidence": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      -      },
      -      "samples": {
      -        "default": 3,
      -        "maximum": 9,
      -        "minimum": 1,
      -        "type": "integer"
      -      },
      -      "timeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 90000
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "contents": {
      -    "default": [],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "allowRemote": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/allowRemote"
      -        },
      -        "argsTemplate": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/argsTemplate"
      -        },
      -        "blocking": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/blocking"
      -        },
      -        "command": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/command"
      -        },
      -        "cwd": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/cwd"
      -        },
      -        "env": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      -        },
      -        "expect": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/expect"
      -        },
      -        "files": {
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "id": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -        },
      -        "samples": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/samples"
      -        }
      -      },
      -      "required": [
      -        "expect",
      -        "id",
      -        "files"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "defaults": {
      -    "additionalProperties": false,
      -    "default": {},
      -    "properties": {
      -      "capture": {
      -        "default": "viewport",
      -        "enum": [
      -          "viewport",
      -          "fullPage",
      -          "element"
      -        ],
      -        "type": "string"
      -      },
      -      "colorScheme": {
      -        "default": "light",
      -        "enum": [
      -          "light",
      -          "dark",
      -          "no-preference"
      -        ],
      -        "type": "string"
      -      },
      -      "locale": {
      -        "default": "en-US",
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "maxDiffRatio": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold",
      -        "default": 0.001
      -      },
      -      "pixelThreshold": {
      -        "default": 0.1,
      -        "maximum": 1,
      -        "minimum": 0,
      -        "type": "number"
      -      },
      -      "selector": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "timezone": {
      -        "default": "UTC",
      -        "minLength": 1,
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "enabled": {
      -    "default": false,
      -    "type": "boolean"
      -  },
      -  "images": {
      -    "default": [],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "aspectRatio": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "dpi": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "fileSizeBytes": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "files": {
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "formats": {
      -          "items": {
      -            "enum": [
      -              "png",
      -              "jpeg",
      -              "webp"
      -            ],
      -            "type": "string"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        },
      -        "height": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      -        },
      -        "id": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -        },
      -        "optional": {
      -          "default": false,
      -          "type": "boolean"
      -        },
      -        "transparency": {
      -          "enum": [
      -            "transparent",
      -            "opaque"
      -          ],
      -          "type": "string"
      -        },
      -        "width": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "exact": {
      -              "exclusiveMinimum": 0,
      -              "type": "number"
      -            },
      -            "max": {
      -              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      -            },
      -            "min": {
      -              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      -            }
      -          },
      -          "type": "object"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "files"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "limits": {
      -    "additionalProperties": false,
      -    "default": {},
      -    "properties": {
      -      "artifactBytes": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 524288000
      -      },
      -      "concurrency": {
      -        "default": 1,
      -        "exclusiveMinimum": 0,
      -        "maximum": 4,
      -        "type": "integer"
      -      },
      -      "decodedPixels": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 32000000
      -      },
      -      "inputBytes": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 20971520
      -      },
      -      "itemTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 60000
      -      },
      -      "navigationTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 30000
      -      },
      -      "roundTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 300000
      -      },
      -      "serviceTimeoutMs": {
      -        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      -        "default": 60000
      -      },
      -      "stabilitySamples": {
      -        "default": 3,
      -        "exclusiveMinimum": 0,
      -        "maximum": 3,
      -        "minimum": 2,
      -        "type": "integer"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "pages": {
      -    "default": [],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "baseline": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -        },
      -        "capture": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/capture"
      -        },
      -        "content": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "allowRemote": {
      -              "type": "boolean"
      -            },
      -            "argsTemplate": {
      -              "items": {
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "minItems": 1,
      -              "type": "array"
      -            },
      -            "blocking": {
      -              "default": false,
      -              "type": "boolean"
      -            },
      -            "command": {
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "cwd": {
      -              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -            },
      -            "env": {
      -              "additionalProperties": {
      -                "minLength": 1,
      -                "type": "string"
      -              },
      -              "propertyNames": {
      -                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
      -              },
      -              "type": "object"
      -            },
      -            "expect": {
      -              "maxLength": 4000,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "samples": {
      -              "maximum": 9,
      -              "minimum": 1,
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "expect"
      -          ],
      -          "type": "object"
      -        },
      -        "id": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -        },
      -        "maskSelectors": {
      -          "default": [],
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -          },
      -          "type": "array"
      -        },
      -        "maxDiffRatio": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      -        },
      -        "optional": {
      -          "default": false,
      -          "type": "boolean"
      -        },
      -        "pixel": {
      -          "default": true,
      -          "type": "boolean"
      -        },
      -        "pixelThreshold": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      -        },
      -        "readySelector": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -        },
      -        "route": {
      -          "default": "/",
      -          "type": "string"
      -        },
      -        "selector": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -        },
      -        "source": {
      -          "anyOf": [
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "type": {
      -                  "const": "existing",
      -                  "type": "string"
      -                },
      -                "url": {
      -                  "format": "uri",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "url"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "port": {
      -                  "exclusiveMinimum": 0,
      -                  "maximum": 65535,
      -                  "type": "integer"
      -                },
      -                "root": {
      -                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -                },
      -                "type": {
      -                  "const": "static",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "root"
      -              ],
      -              "type": "object"
      -            },
      -            {
      -              "additionalProperties": false,
      -              "properties": {
      -                "args": {
      -                  "default": [],
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "command": {
      -                  "minLength": 1,
      -                  "type": "string"
      -                },
      -                "cwd": {
      -                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot",
      -                  "default": "."
      -                },
      -                "env": {
      -                  "additionalProperties": {
      -                    "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
      -                    "type": "string"
      -                  },
      -                  "default": {},
      -                  "type": "object"
      -                },
      -                "readyUrl": {
      -                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      -                },
      -                "type": {
      -                  "const": "command",
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "type",
      -                "command",
      -                "readyUrl"
      -              ],
      -              "type": "object"
      -            }
      -          ]
      -        },
      -        "steps": {
      -          "default": [],
      -          "items": {
      -            "anyOf": [
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "click",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "type",
      -                  "selector"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "input",
      -                    "type": "string"
      -                  },
      -                  "value": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "type",
      -                  "selector",
      -                  "value"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "hover",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "type",
      -                  "selector"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "type": {
      -                    "const": "scroll",
      -                    "type": "string"
      -                  },
      -                  "x": {
      -                    "type": "number"
      -                  },
      -                  "y": {
      -                    "type": "number"
      -                  }
      -                },
      -                "required": [
      -                  "type"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "durationMs": {
      -                    "exclusiveMinimum": 0,
      -                    "maximum": 60000,
      -                    "type": "integer"
      -                  },
      -                  "selector": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      -                  },
      -                  "state": {
      -                    "enum": [
      -                      "visible",
      -                      "hidden"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "type": {
      -                    "const": "wait",
      -                    "type": "string"
      -                  },
      -                  "url": {
      -                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      -                  }
      -                },
      -                "required": [
      -                  "type"
      -                ],
      -                "type": "object"
      -              }
      -            ]
      -          },
      -          "type": "array"
      -        },
      -        "storageState": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      -        },
      -        "viewports": {
      -          "items": {
      -            "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      -          },
      -          "minItems": 1,
      -          "type": "array"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "source"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  },
      -  "viewports": {
      -    "default": [
      -      {
      -        "deviceScaleFactor": 1,
      -        "height": 720,
      -        "id": "desktop",
      -        "width": 1280
      -      },
      -      {
      -        "deviceScaleFactor": 1,
      -        "height": 844,
      -        "id": "mobile",
      -        "width": 390
      -      }
      -    ],
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "deviceScaleFactor": {
      -          "default": 1,
      -          "exclusiveMinimum": 0,
      -          "maximum": 4,
      -          "type": "number"
      -        },
      -        "height": {
      -          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width"
      -        },
      -        "id": {
      -          "maxLength": 100,
      -          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$",
      -          "type": "string"
      -        },
      -        "width": {
      -          "exclusiveMinimum": 0,
      -          "type": "integer"
      -        }
      -      },
      -      "required": [
      -        "id",
      -        "width",
      -        "height"
      -      ],
      -      "type": "object"
      -    },
      -    "minItems": 1,
      -    "type": "array"
      -  }
      -}
    • addedInput schema / properties / contextWindow
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / exportKind
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
  2. Changed1 schema field changedv0.7.6
    • addedInput schema / properties / designDirection
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
  3. Changed1 schema field changedv0.6.7
    • addedInput schema / properties / dryRun
      Added value: +{
      +  "type": "boolean"
      +}
  4. Changed1 schema field changedv0.6.4
    • addedInput schema / properties / acceptanceOverride
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "checks": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "cmd": {
      +            "anyOf": [
      +              {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              {
      +                "items": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              }
      +            ]
      +          },
      +          "name": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "optional": {
      +            "type": "boolean"
      +          },
      +          "timeoutMs": {
      +            "exclusiveMinimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "cmd"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "requireChanges": {
      +      "type": "boolean"
      +    },
      +    "verifyConcurrency": {
      +      "type": "number"
      +    },
      +    "visual": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "allowedOrigins": {
      +          "default": [],
      +          "items": {
      +            "format": "uri",
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "baselineRoot": {
      +          "default": "tests/visual/baselines",
      +          "minLength": 1,
      +          "type": "string"
      +        },
      +        "browser": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "mode": {
      +                  "const": "managed",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "executablePath": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "mode": {
      +                  "const": "chrome",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "executablePath": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "mode": {
      +                  "const": "edge",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "executablePath": {
      +                  "minLength": 1,
      +                  "type": "string"
      +                },
      +                "mode": {
      +                  "const": "executable",
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "mode",
      +                "executablePath"
      +              ],
      +              "type": "object"
      +            }
      +          ],
      +          "default": {
      +            "mode": "managed"
      +          }
      +        },
      +        "content": {
      +          "additionalProperties": false,
      +          "default": {},
      +          "properties": {
      +            "allowRemote": {
      +              "default": false,
      +              "type": "boolean"
      +            },
      +            "argsTemplate": {
      +              "items": {
      +                "minLength": 1,
      +                "type": "string"
      +              },
      +              "minItems": 1,
      +              "type": "array"
      +            },
      +            "cache": {
      +              "default": true,
      +              "type": "boolean"
      +            },
      +            "command": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "cwd": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +            },
      +            "enabled": {
      +              "default": false,
      +              "type": "boolean"
      +            },
      +            "env": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      +            },
      +            "minConfidence": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      +            },
      +            "samples": {
      +              "default": 3,
      +              "maximum": 9,
      +              "minimum": 1,
      +              "type": "integer"
      +            },
      +            "timeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 90000
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "contents": {
      +          "default": [],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "allowRemote": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/allowRemote"
      +              },
      +              "argsTemplate": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/argsTemplate"
      +              },
      +              "blocking": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/blocking"
      +              },
      +              "command": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/command"
      +              },
      +              "cwd": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/cwd"
      +              },
      +              "env": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/env"
      +              },
      +              "expect": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/expect"
      +              },
      +              "files": {
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "id": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +              },
      +              "samples": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/content/properties/samples"
      +              }
      +            },
      +            "required": [
      +              "expect",
      +              "id",
      +              "files"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "defaults": {
      +          "additionalProperties": false,
      +          "default": {},
      +          "properties": {
      +            "capture": {
      +              "default": "viewport",
      +              "enum": [
      +                "viewport",
      +                "fullPage",
      +                "element"
      +              ],
      +              "type": "string"
      +            },
      +            "colorScheme": {
      +              "default": "light",
      +              "enum": [
      +                "light",
      +                "dark",
      +                "no-preference"
      +              ],
      +              "type": "string"
      +            },
      +            "locale": {
      +              "default": "en-US",
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "maxDiffRatio": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold",
      +              "default": 0.001
      +            },
      +            "pixelThreshold": {
      +              "default": 0.1,
      +              "maximum": 1,
      +              "minimum": 0,
      +              "type": "number"
      +            },
      +            "selector": {
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "timezone": {
      +              "default": "UTC",
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "enabled": {
      +          "default": false,
      +          "type": "boolean"
      +        },
      +        "images": {
      +          "default": [],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "aspectRatio": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "dpi": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "fileSizeBytes": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "files": {
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "formats": {
      +                "items": {
      +                  "enum": [
      +                    "png",
      +                    "jpeg",
      +                    "webp"
      +                  ],
      +                  "type": "string"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              },
      +              "height": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width"
      +              },
      +              "id": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +              },
      +              "optional": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "transparency": {
      +                "enum": [
      +                  "transparent",
      +                  "opaque"
      +                ],
      +                "type": "string"
      +              },
      +              "width": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "exact": {
      +                    "exclusiveMinimum": 0,
      +                    "type": "number"
      +                  },
      +                  "max": {
      +                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      +                  },
      +                  "min": {
      +                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/images/items/properties/width/properties/exact"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "files"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "limits": {
      +          "additionalProperties": false,
      +          "default": {},
      +          "properties": {
      +            "artifactBytes": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 524288000
      +            },
      +            "concurrency": {
      +              "default": 1,
      +              "exclusiveMinimum": 0,
      +              "maximum": 4,
      +              "type": "integer"
      +            },
      +            "decodedPixels": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 32000000
      +            },
      +            "inputBytes": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 20971520
      +            },
      +            "itemTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 60000
      +            },
      +            "navigationTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 30000
      +            },
      +            "roundTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 300000
      +            },
      +            "serviceTimeoutMs": {
      +              "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width",
      +              "default": 60000
      +            },
      +            "stabilitySamples": {
      +              "default": 3,
      +              "exclusiveMinimum": 0,
      +              "maximum": 3,
      +              "minimum": 2,
      +              "type": "integer"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "pages": {
      +          "default": [],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "baseline": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +              },
      +              "capture": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/capture"
      +              },
      +              "content": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "allowRemote": {
      +                    "type": "boolean"
      +                  },
      +                  "argsTemplate": {
      +                    "items": {
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "blocking": {
      +                    "default": false,
      +                    "type": "boolean"
      +                  },
      +                  "command": {
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "cwd": {
      +                    "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                  },
      +                  "env": {
      +                    "additionalProperties": {
      +                      "minLength": 1,
      +                      "type": "string"
      +                    },
      +                    "propertyNames": {
      +                      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
      +                    },
      +                    "type": "object"
      +                  },
      +                  "expect": {
      +                    "maxLength": 4000,
      +                    "minLength": 1,
      +                    "type": "string"
      +                  },
      +                  "samples": {
      +                    "maximum": 9,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  }
      +                },
      +                "required": [
      +                  "expect"
      +                ],
      +                "type": "object"
      +              },
      +              "id": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +              },
      +              "maskSelectors": {
      +                "default": [],
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                },
      +                "type": "array"
      +              },
      +              "maxDiffRatio": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      +              },
      +              "optional": {
      +                "default": false,
      +                "type": "boolean"
      +              },
      +              "pixel": {
      +                "default": true,
      +                "type": "boolean"
      +              },
      +              "pixelThreshold": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/pixelThreshold"
      +              },
      +              "readySelector": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +              },
      +              "route": {
      +                "default": "/",
      +                "type": "string"
      +              },
      +              "selector": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +              },
      +              "source": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "type": {
      +                        "const": "existing",
      +                        "type": "string"
      +                      },
      +                      "url": {
      +                        "format": "uri",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "url"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "port": {
      +                        "exclusiveMinimum": 0,
      +                        "maximum": 65535,
      +                        "type": "integer"
      +                      },
      +                      "root": {
      +                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +                      },
      +                      "type": {
      +                        "const": "static",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "root"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "args": {
      +                        "default": [],
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "command": {
      +                        "minLength": 1,
      +                        "type": "string"
      +                      },
      +                      "cwd": {
      +                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot",
      +                        "default": "."
      +                      },
      +                      "env": {
      +                        "additionalProperties": {
      +                          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
      +                          "type": "string"
      +                        },
      +                        "default": {},
      +                        "type": "object"
      +                      },
      +                      "readyUrl": {
      +                        "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      +                      },
      +                      "type": {
      +                        "const": "command",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "type",
      +                      "command",
      +                      "readyUrl"
      +                    ],
      +                    "type": "object"
      +                  }
      +                ]
      +              },
      +              "steps": {
      +                "default": [],
      +                "items": {
      +                  "anyOf": [
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "click",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "type",
      +                        "selector"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "input",
      +                          "type": "string"
      +                        },
      +                        "value": {
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "type",
      +                        "selector",
      +                        "value"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "hover",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "type",
      +                        "selector"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "type": {
      +                          "const": "scroll",
      +                          "type": "string"
      +                        },
      +                        "x": {
      +                          "type": "number"
      +                        },
      +                        "y": {
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "type"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "durationMs": {
      +                          "exclusiveMinimum": 0,
      +                          "maximum": 60000,
      +                          "type": "integer"
      +                        },
      +                        "selector": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/defaults/properties/selector"
      +                        },
      +                        "state": {
      +                          "enum": [
      +                            "visible",
      +                            "hidden"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "type": {
      +                          "const": "wait",
      +                          "type": "string"
      +                        },
      +                        "url": {
      +                          "$ref": "#/properties/acceptanceOverride/properties/visual/properties/pages/items/properties/source/anyOf/0/properties/url"
      +                        }
      +                      },
      +                      "required": [
      +                        "type"
      +                      ],
      +                      "type": "object"
      +                    }
      +                  ]
      +                },
      +                "type": "array"
      +              },
      +              "storageState": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/baselineRoot"
      +              },
      +              "viewports": {
      +                "items": {
      +                  "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/id"
      +                },
      +                "minItems": 1,
      +                "type": "array"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "source"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "viewports": {
      +          "default": [
      +            {
      +              "deviceScaleFactor": 1,
      +              "height": 720,
      +              "id": "desktop",
      +              "width": 1280
      +            },
      +            {
      +              "deviceScaleFactor": 1,
      +              "height": 844,
      +              "id": "mobile",
      +              "width": 390
      +            }
      +          ],
      +          "items": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "deviceScaleFactor": {
      +                "default": 1,
      +                "exclusiveMinimum": 0,
      +                "maximum": 4,
      +                "type": "number"
      +              },
      +              "height": {
      +                "$ref": "#/properties/acceptanceOverride/properties/visual/properties/viewports/items/properties/width"
      +              },
      +              "id": {
      +                "maxLength": 100,
      +                "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$",
      +                "type": "string"
      +              },
      +              "width": {
      +                "exclusiveMinimum": 0,
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "id",
      +              "width",
      +              "height"
      +            ],
      +            "type": "object"
      +          },
      +          "minItems": 1,
      +          "type": "array"
      +        }
      +      },
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
  5. Changed1 schema field changedv0.6.2
    • addedInput schema / properties / idempotencyKey
      Added value: +{
      +  "type": "string"
      +}
  6. Changed2 schema fields changedv0.5.8
    • addedInput schema / properties / modelSource
      Added value: +{
      +  "enum": [
      +    "default",
      +    "custom"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / reasoningLevel / enum
      Previous value: -[
      -  "低",
      -  "中",
      -  "高",
      -  "low",
      -  "medium",
      -  "high"
      -]New value: +[
      +  "低",
      +  "中",
      +  "高",
      +  "low",
      +  "medium",
      +  "high",
      +  "max",
      +  "极高",
      +  "xhigh",
      +  "最大",
      +  "关闭思考",
      +  "on",
      +  "off"
      +]
  7. Changed2 schema fields changedv0.5.3
    • addedInput schema / properties / allowCreateProject
      Added value: +{
      +  "type": "boolean"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "projectPath",
      -  "task"
      -]New value: +[
      +  "task"
      +]
  8. Changed3 schema fields changedv0.3.1
    • addedInput schema / properties / designSystem
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / planDoc
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedInput schema / properties / reasoningLevel
      Added value: +{
      +  "enum": [
      +    "低",
      +    "中",
      +    "高",
      +    "low",
      +    "medium",
      +    "high"
      +  ],
      +  "type": "string"
      +}
  9. Changed2 schema fields changedv0.1.9
    • addedInput schema / properties / mode
      Added value: +{
      +  "enum": [
      +    "Work",
      +    "Code",
      +    "Design"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / model
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
  10. First observedv0.1.0

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover readOnly=false, openWorld, idempotent, non-destructive, so the bar is lower, yet the description adds substantial behavior: deprecated-param rejection, pre-send project path validation, a 24h idempotency TTL with conflict-on-param-change semantics, and a detailed dryRun mode (what it skips, what it emits). Gaps remain around failure handling and what happens on acceptance failure beyond 'auto-repair'.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is correctly front-loaded and each clause carries information, but the whole thing is a single dense paragraph mixing deprecation notices, validation rules, idempotency, and dryRun semantics. Segmenting those into discrete units would make it far more scannable for an agent deciding whether to pass dryRun or idempotencyKey.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 20-parameter, nested-object, no-output-schema mutation tool, the description covers dispatch semantics, dryRun, and idempotency well but leaves the acceptance-tuning surface (acceptanceOverride, autoFixRounds, autoVerify interaction) and most scalar options unexplained. An agent could call it correctly for the main path but would be guessing on the verification-control parameters.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0% across 20 parameters, so the description carries the burden and does clarify the highest-risk ones: mode/modelSource are deprecated, model needs vendor/model for ZCode, dryRun requires projectPath, idempotencyKey is 1..128 chars. However, roughly a dozen params (acceptanceOverride, autoFixRounds, taskTimeoutMs, contextWindow, exportKind, agentId, planDoc, designSystem, allowCreateProject, reasoningLevel) get no meaning added beyond their schema types.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

"派活:启动外部 AI-Agent 开发任务并可自动验收返修,异步返回 taskId" states a concrete verb (dispatch/start) and resource (external AI-Agent dev task) with the async contract made explicit. It is clearly distinct in kind from query/wait/verify siblings, though it never names them to confirm the boundary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives operative conditions for specific paths (deprecated params will be rejected, use designDirection instead; macOS research 禁止派发), which is real routing guidance. But there is no explicit when-to-use-this-vs-siblings guidance — nothing points to wait_task/query_task/verify_task for follow-up, so the alternative selection is only implied.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.